USERV - Library Service Utility (z/VSE Only)

#### Search Results

Search

# USERV - Library Service Utility (z/VSE Only)

The Com-plete online utility USERV enables you to display library directories and members, labels, and VTOCs.

This document covers the following topics:

- Overview

- Command Format

- Using USERV

- Commands

## Overview

Specifically, USERV allows you to:

- List the directory of a library that is managed by the z/VSE Librarian (either in VSAM space or of SD format);

- Display a module contained in a library managed by the z/VSE Librarian that is of standard type (i.e., Phase, Obj, Dump, Proc, Source);

- Display the two-character library identification codes and the associated z/VSE file names defined by the UEDTB1 module;

- List the VTOC of a specified disk CUU;

- jList the free space on a specified disk CUU;

- List the partition, temporary, and standard labels defined on the z/VSE label cylinder.

Note
There is a user-written exit routine (UUSVX1) provided that enables an installation to restrict usage of certain functions of USERV.

## Command Format

USERV is a fully conversational program. This means that you can select the various functions available either when you invoke USERV, or any time thereafter:

- By displaying the USERV command function menu, or:

- By entering a command function at the time of invocation

The basic command format is:

    *USERV

This displays the USERV menu, which summarizes the commands recognized by USERV. It is shown in the following figure.

    10:38:28     TID     9          COMTEST2         User ID COK          02/12/02
                           -- Data Set Maintenance --                          USRV
          Function            ID     PFK                 Operands
      ----------------------  --     ---   ---------------------------------------
        List Library Members   L       1   LIB or DSN , SUBLIB, and VOLUME
     Display Library Members   D       2   LIB,MEM,MTYPE or DSN,SUB,MEM,MTYPE,VOL
        Print Library Member   P       3   LIB or DSN,SUB,MEM(,VOL)(,DEST)(,CC)(,A)
                        Vtoc   V       4   VOLUME
                       Space   S       5   VOLUME
        File ID's (LIB ID's)   F       6
              Help Functions   H       7
             Keyword Display   K       8
          Label Area Display   B       9   Type and Partition/Class (unless STD)

             Select Function:      or PFK     and Operands:
                     LIBrary:                SUBLIBrary:
                        DSN
                 MEMBER name:                Member TYPE:
                      VOLUME:                Enter Volume Serial Number
             Partition/Class:                Enter Partition ID or Class
                        Type:                Enter STD, PARSTD, TEMP or CLASS
                Destination :                Enter Print Destination
           CC and/or Attach :                Enter 'CC', 'A' OR 'CC,A'

These menus display the USERV functions available for selection, together with important keywords and their defaults. You can invoke a function either by entering a single character or pressing a PF Key.

The valid USERV commands are summarized in the following table. The shortest possible abbreviations are indicated by underlining.

Command | Description
--- | ---
DISPLAY | Displays a specific module, book, or procedure of a library.
FILES | Lists the two-character library identification codes and their respective assignments as defined by module UEDTB1.
HELP | Displays the USERV menu.
KEYWORDS | Displays the keywords and their current values.
LABEL | Lists the temporary, partition standard, and standard labels on the z/VSE label cylinder.
LIST | Lists the directory of a specified library.
PRINT | Printout spools the statements in a module, book, or procedure of a library.
SPACE | Lists the free space of a specified CUU.
VTOC | Lists the volume table of contents of a specified CUU.

You can also enter a command when you invoke USERV using a direct call and so bypass the USERV Menu.

The direct command format is:

    *USERV [command positional-argument,keyword]

where:

command | Specifies a USERV command.
positional-argument | Specifies one or more USERV positional arguments.
keyword | Specifies one or more USERV keyword arguments.

This feature allows you to enter a series of commands that use common keyword values, thus eliminating your needing to reinitialize keywords as you enter each command.

The details of using the keyword parameters are given in the remaining text of this section.

## Using USERV

The functional considerations that must be taken into account when entering commands, positional arguments, and keywords are discussed in the following text.

### Entering Commands

Since USERV is fully conversational, you can enter commands at any time while in conversation with USERV. Once you have entered a command, that command is in effect until you enter another command. You can enter additional argument(s), either positional or keyword, at any time, and the current command will be executed reflecting the changes imposed by entry of the new argument(s).

For example, you could use the LIST command to list the books in a specific library by entering the library ID as a positional argument with the LIST command. Once you have obtained the display, entering another library name for the FILENAME keyword argument causes the LIST command to be executed for the new library.

### Positional Arguments

Positional arguments, if used, must always immediately follow the command function and precede any keyword arguments. You can separate the command and the first positional argument with either a blank or a comma. Note that in all illustrations in the USERV menu and in this section, a blank will be used as a separator.

If you enter more than one positional argument, you can separate them with either a comma or a blank. Note that in all illustrations in the USERV menu and in this section, a comma is used as a separator.

Entering a positional argument always causes one or more keyword arguments to be initialized. If you enter a command that includes positional arguments, USERV syntax checking processes positional arguments after it processes keyword arguments. Consequently, positional arguments are the final determining factor in the execution of a command function.

### Keyword Arguments

You must specify keyword arguments in one of three ways:

- The keyword argument only, with no command;

- As the only argument given with a command;

- After all positional arguments.

Keyword arguments must be separated from commands, positional arguments, and other keyword arguments by a comma or a blank. Note that in all illustrations in this section, a comma is used as the separator.

The keywords defined for USERV are summarized in the following table. The shortest possible abbreviations are indicated by underlining.

Keyword | Description
--- | ---
DESTCODE | Specifies the destination routing code or TID to be used for all USERV PRINT commands.
DSNAME | Specifies the file name of the library to be accessed. (z/VSE file ID up to 44 characters).
FORMAT | Specifies a character, hexadecimal, or interpreted dump format for the DISPLAY and PRINT commands.
LIBRARY | Specifies a two-character library identification code.
MEMBER | Specifies the member (module, book, or procedure) name to be used when the library is accessed.
MTYPE | Specifies the member-type (i.e., Phase, Obj, Proc, Dump, etc.) to be used when the library is accessed.
PART | Specifies the partition (BG, F1 through FB) desired when either the temporary, partition or class standard labels are displayed.
RECORD | Specifies the desired position in the displayed library.
SUBLIB | Specifies the sublibrary name to be used in conjunction with the LIST or DISPLAY command.
TYPE | Specifies the type of z/VSE labels to be displayed.
UNIT | Specifies the CUU of the disk volume to be used for the VTOC and SPACE commands.
USERDATA | Specifies whether or not the optional user data or stow data is to be displayed after execution of the LIST command. Also indicates the format of the resulting display.
VOLSER | Specifies the VOLSER to be used by the VTOC and space functions of USERV.

Note that you can access a display of the current status of the keyword parameters by using the KEYWORDS command. For additional information, and for an example of the KEYWORDS command display, see the section KEYWORDS Command later in this section.

Special considerations must be made when using keywords. Among them are the following:

1. USERV command processing always occurs in the following sequence:

   - Initializes keyword arguments;

   - Reinitializes the keyword arguments based upon the positional arguments given;

   - Executes the command.

2. Once you have successfully or unsuccessfully executed a command, you can use the KEYWORDS command to display all initialized keyword arguments and their current values.

3. To initialize any keyword, simply enter the keyword with no associated command function or positional argument. The last-executed command is then re-executed using the new arguments entered as execution time arguments.

   Once you have initialized a keyword, you can enter commands that use data from that keyword without needing to specify that keyword again; the initialized value will be used when you execute the command.

4. Initialized keyword values will remain in effect from command to command as long as:

   - USERV remains conversational and is not terminated, and:

   - Entry of a command function does not alter one of the keyword values.

Note
If you also give positional arguments, command entry may force an initialized keyword to be reinitialized.

If you enter more than one keyword in a single command, they are processed from left to right. Consequently, if two or more keywords conflict in that they force initialization of a common keyword argument, the last keyword entered determines the initialized value that will be in effect (unless it is overridden by a positional argument).

Keyword initialization considerations are described in detail in the following table:

DESTCODE=destcode | Specifies the destination routing code or TID to be used for all USERV PRINT commands.
Default: The screen-to-hardcopy terminal defined for the terminal in use in the TIBTAB module, if any.
DSNAME=filename | Specifies the z/VSE file name to be used when processing all commands for which a 44-character file name is not supplied.
Note: Entry of this keyword argument or entry of a unique file name causes the LIBRARY keyword to be initialized to blanks.
FORMAT=format | Specifies the dump format for the DISPLAY and PRINT commands. Valid dump formats are:
CHAR | Character
HEX | Hexadecimal
INT | Interpreted
Note that for both the HEX and INT format options, one of three line formats are selected depending on line size. The formats have been designed around the standard line sizes of 40, 80, or 132 characters. The selection algorithm, however, uses the minimum line sizes needed for each format, as shown in the following table:
Format | Mm. Charts/Line | Bytes/LIne Shown
F=HEX | 125 | 48
77 | 32
40 | 8
F=INT | 112 | 32
59 | 16
33 | 8
Note If less than 33 or 40 characters per line are available, the respective option cannot be performed and the keyword value is reset to CHAR.
LIBRARY=libcode | Specifies the two-character library code to be used when all commands for which a library code has not been entered are processed.
MEMBER=member | Specifies the member name to be used when commands for which no member name is entered are processed. The name must comply with the z/VSE conventions.
Note that in order to facilitate initialization of the appropriate keywords, member can also be specified with filename or libcode in the following formats:
a. | filename(member)
b. | libcode(member)
A sublibrary name and member-type may also be necessary.
MTYPE=type | Specifies the type of the member to be selected.
Note that type can be from one to eight characters.
PART=partition | Specifies the partition ID desired (BG, F1 through FB) when TEMP (User), PARSTD (Partition Standard) or CLASS (Class Standard) labels are displayed. This keyword is associated with the LABEL command.
RECORD=position | Is used to position the display of a member.
Note that position can be specified as one of the following:
n | Positions to the n th record of the member.
+n | Positions forward by n records.
-n | Positions backward by n records.
++ | Positions to the last record of the member.
-- | Positions to the first record of the member.
* | Redisplays the current record from the beginning.
The number of the current record is displayed in the heading of the DISPLAY display and/or in the KEYWORDS display. Note that if the request causes the record number to go below 1 or above 9999999, these values are substituted respectively. In addition, the substitution takes place as soon as the discovery is made that the requested record number is larger than the number of records in the book or procedure.
The positioning function may be accomplished in one of three ways:
a. | By including the RECORD keyword in the command string.
Example:
Note://If a member other than the currently open one is accessed, the RECORD value is reset to 1 unless it is specified in the same command line as the display request (as shown above).
b. | By entering the RECORD keyword values without the preceding keyword, if no operation or positional operand is to be entered. Examples:
    +10
    -10
    ++
    --
    *
c. | By using PF keys to enter positioning requests. (See the section PF Key Assignments later in this section for a description of the functions assigned to the PF keys by the USERV utility.)
SUBLIB=name | Specifies the name of the sublibrary to be used in conjunction with the LIST or DISPLAY commands.
Note that name can be from one to eight characters.
TYPE=type | Specifies the type of z/VSE labels that are to be displayed. This keyword is associated with the LABEL command.
STD | Standard label track
TEMP | User label track
PARSTD | Partition Standard track
CLASS | Class Standard track
UNIT=cuu | Specifies the CUU of the disk volume to be used for the VTOC and SPACE commands.
Default: USERDATA=NO
USERDATA=indicator | Specifies whether or not user stow information is to be displayed when directory information is requested.
Note that the value specified can be either YES or NO.
USERDATA=YES indicates that directory information is included in the display. If no directory information is present, only member names are displayed.
USERDATA=NO indicates that directory information is not displayed.
USERDATA=[-]D sorts the display of the directory information by date of last update
VOLSER=vvvvvv | Specifies the VOLSER to be used for the VTOC and SPACE functions of USERV.

### Paging Requests

If you have requested a large amount of information to be output from a hard copy terminal, and you want to cause the output to be interrupted, use an Attention Interrupt. At this point, to cause one more line of output to be generated, simply press ENTER, and you will be prompted to enter a new command.

Note
If you are using a 3270-type terminal or compatible device, to continue the display of output that cannot be contained in one display, press ENTER.

### PF Key Assignments for Functions List and Display

The PF1 through PF8 keys have been assigned scrolling functions that enable you to adjust the current display. When you press one of these keys, the equivalent operand is displayed on the command line, and the function is performed. Note that you can also position within a module/book/procedure by using the RECORD keyword.

In addition to the scrolling functions, other frequently-used functions have been assigned to PF keys 9 through 12. A 40-byte command area is assigned to each of these PF keys so that functions other than those assigned can be zapped in.

The following table lists the functions assigned to the PF keys by the USERV utility.

Key | Equivalen Command | Function
--- | --- | ---
PF1 | -20 | Scroll one full screen backward, if recsize < 81 bytes.
PF2 | 1 | Position to the start of the member.
PF3 | ++ | Position to the last line of the member.
PF4 | +1 | Advance the display one line.
PF5 | -1 | Move the display backward one line.
PF6 | +10 | Scroll one-half screen forward.
PF7 | -10 | Scroll one-half screen backward.
PF8 | * | Position back to the beginning of the current record.
PF9 | * | Position back to the beginning of the current record.
PF10 | - | *UEDIT xx (mmmmmmmmmm)1
PF11 | - | *UEDIT xx (mmmmmmmmmm)1
PF12 | - | *UEDIT xx (mmmmmmmmmm)1

where: xx =library ID and mmmmmmmmmm=sublibrary.book

Note that UEDIT requests are ignored unless you specify both library ID and member.

If you use these PF keys on other USERV functions, they will abend with a U2000.

## Commands

The USERV commands are discussed in the remainder of this section.

### DISPLAY Command

The DISPLAY command allows you to obtain a listing of a module of any standard type that is contained in a library.

The command format is:

    DISPLAY [member]

where member can be in one of the following formats:

(.member,type) | Specifies the one- to eight-character member name to be used in conjunction with the one- to eight-character member type to be displayed. Note With this format, the SUBLIB and either the LIBRARY or DSNAME keywords must be initialized.
(sublib.member,type) | Specifies the one- to eight-character sublibrary name and the one- to eight-character member name to be used in conjunction with the one- to eight-character member type to be displayed. Note With this format, either the LIBRARY or DSNAME keyword must be initialized.
library (sublib.member,type) | Specifies either a fully qualified library name or a two-character library code defined in UEDTB1 or in UUTIL. Here, member is the one- to ten-character member name to be displayed.
If member is omitted, the enclosing parentheses can also be included, or the member format is assumed.

Note that in each of the formats described, if you omit member, the keyword argument MEMBER determines the member displayed.

The following figure is an example of a USERV display of a phase.

     F=I
    SUBLIB=SP2LIB   MEMBER=TLSRESTA                                     REC=00000001
    DSN=VSE.SP.COMPLETE.SEP24.LIB                    LIB=CC VOL=        UNIT=00C

    0000 47F0F010 E3D3E2D9 C5E2E3C1 F4F4F040 *.00.TLSRESTA440 *
    0010 18CF5820 C0B05810 00144800 102E4A00 *.....0.. .. ..  *
    0020 105A5000 41285810 0080D200 4128105B *.!& .... .K ...$*
    0030 411040C0 1B000A28 4110C0AC 91801002 *.. .. ......J...*
    0040 4710C046 0A075800 C0B41814 4B10C0BC *....... .4......*

    0050 BE07C05D 5010C060 4510C064 40000000 *...)&..-....    *
    0060 00000000 18010A25 91040038 4710C074 *    ....J. .....*
    0070 94FB4000 D3004001 22AAD207 40704000 *M.  L  ...K. .  *
    0080 D23F4158 40084110 C0BE0A35 44002030 *K... ........ ..*
    0090 10000001 00061F00 5810C0B8 41F0000F *.  . .. ...8.0 .*

    00A0 0A6B980F 41588200 40700000 00000000 *.,Q...B  .      *
    00B0 00000000 00000000 00000001 00500000 *           . &  *
    00C0 00000000 00000000 00000000 00000000 *                *
    00D0 00000000 00000000 00000000 00000000 *                *
    00E0 00000000 00000000 00000000 00000000 *                *

The member displayed can be deleted from the library simply by typing SCRATCH. You can also rename it directly:

    RENAME (.oldmem,oldtype) ([.newmem],newtype)

### FILES Command

The FILES command enables you to obtain a listing of the entries in the two-character library code table UEDTB1.

The command format is:

    FILES

Any additional arguments entered must be keyword arguments. Entering them will cause only initialization of the appropriate keyword functions; it has no effect on the output of the FILES display.

The resulting display consists of a listing of the various libraries defined by UEDTB1. For each library listed, the two-character library identification code is given, along with the z/VSE file name and the library type in the following format:

The following figure shows a USERV files display for z/VSE.

    FILES
    ID...DSNAME......................................SUBLIB   TYP
    CC - VSE.SP.COMPLETE.SEP15                     - SP2LIB   NV
    $$ - VSE.SP.COMPLETE.SEP15                     - SP2LIB   NV
    SL - ????????????                              - SYSLIB   NV
    P1 - ????????????                              - BASE     NV
    P2 - ????????????                              - PROD     NV

On this screen, "TYP" can be either:

VS | indicating that the library is in VSAM space.
NV | indicating a non-VSAM library.

The "SUBLIB" column contains the default sublibrary name that is used if this argument is omitted.

### HELP Command

The HELP command enables you to display a description of each of the functions available from the USERV menu along with a listing of its associated operands.

The command format is:

    HELP

You can optionally enter the HELP command as:

    ?

Entry of either format causes the following screen to appear.

    HELP
    OP.........ARGUMENTS...................MEANING..............
    L IST      FILENAME(MEMBER)            LIST LIBRARY MEMBER NAMES
    D ISPLAY   FILENAME(MEMBER)            DISPLAY LIBRARY MEMBER
    V TOC      VOLSER/UNIT                 DISPLAY DISK VOLUME CONTENTS
    S PACE     VOLSER/UNIT                 SHOW DISK VOLUME AVAILABLE SPACE
    LA BEL     TYPE,PART                   DISPLAY z/VSE LABEL AREA
    P RINT     DESTCODE,'ATTACH'           HARDCOPY OF CURRENT MEMBER
    F ILES                                 LIST LIBRARY ID DEFINITIONS
    H ELP                                  DISPLAY (THIS) COMMAND SUMMARY
    K EYWORDS                              DISPLAY KEYWORDS & THEIR CURRENT VALUES
    A LIBRARY ID MAY BE SUBSTITUTED FOR A FILENAME
    ENTER KEYWORD PARAMETERS AFTER COMMANDS OR SEPARATELY
    ENTER 'L ' TO RESTART LIB MEMBER LIST AT BEGINNING
    'ATTACH' WILL SPOOL PRINTOUT ASYNCHRONOUSLY
    PRINTOUT SPOOLING MAY BE ABORTED BY AN ATTENTION INTERRUPT
    FUNCTION KEYS: PF1..8 = PAGING                           PA2 = UCOPY
                   PF10.= SUBMIT .. PF11 AND 12 = UEDIT

Any additional arguments entered with the HELP command must be keyword arguments. If you include keyword arguments with the HELP command, it will cause only the initialization of the appropriate keyword entries, which you can subsequently use by entering a command function with no arguments. To view the new initialized keyword values, use the keyword display (discussed in the following section).

### KEYWORDS Command

The KEYWORDS command allows you to obtain a display of the keywords and their current values.

The command format is:

    KEYWORDS

The following figure illustrates the format of the keywords display.

    KEYWORDS
    KEYWORD PARAMETER CURRENT VALUES:
    L IBRARY  =
    D SNAME   =
    S UBLIB   =
    M EMBER   =
    MT YPE    =
    R ECORD   = 00000001
    F ORMAT   = CHAR   (CHAR,HEX,INT)
    U SERDATA = NO
    UN IT     =
    V OLSER   =
    T YPE     = STD
    P ART     =
    DE STCODE = 10

For additional information on the KEYWORDS command, see the section Using USERV, earlier in this section.

### LABEL Command

The LABEL command enables you to display the temporary, partition standard, or standard labels on the z/VSE label cylinder.

The command format is:

    LABEL [type][,partition]

The arguments are defined below:

type | Specifies the type of z/VSE label desired. The type argument can be one of the following:
STD | Standard Label track
TEMP | User Label track
PARSTD | Partition Standard label track
CLASS | Class Standard label track
partition | Specifies the partition desired when temporary or partition standard labels are displayed.
Note that partition can be one of the following:
Fn | The desired partition number as generated in the z/VSE supervisor, where n must be a hexadecimal value from 1 to b.
BG | The background partition or a dynamic class (if type=CLASS) or the identifier of an active dynamic partition

The following figure is an example of a display of the standard labels on a z/VSE label cylinder.

     LABEL STD,BG
                         SYSRES VOL=DOSRES        UNIT=ACA
    ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8

    // DLBL IJSYSRS,'VSE.SYSRES.LIBRARY',99/366,SD
    // EXTENT SYSRES,DOSRES,1,0,00001,00899              CCCCC.HH=00000.01,00059.14

    // DLBL IJSYSR2,'VSE.SYSRES.LIBRARY',99/366,SD
    // EXTENT SYSCAT,DOSRES,1,0,00001,00899              CCCCC.HH=00000.01,00059.14

    // DLBL IJSYSR1,'SYS.NEW.RES',99/366,SD
    // EXTENT ,SYSWK1,1,0,00001,00899                    CCCCC.HH=00000.01,00059.14

    // DLBL IJQFILE,'VSE.POWER.QUEUE.FILE',99/366,DA
    // EXTENT SYS001,DOSRES,1,0,00945,00015              CCCCC.HH=00063.00,00063.14

    // DLBL DFHJ01A,'CICS.SYSTEM.LOG.A',0,SD
    // EXTENT SYS019,DOSRES,1,0,05655,00060              CCCCC.HH=00377.00,00380.14

    // DLBL DFHJ01B,'CICS.SYSTEM.LOG.B',0,SD
    // EXTENT SYS019,DOSRES,1,0,05715,00060              CCCCC.HH=00381.00,00384.14

    // DLBL DFHJ02A,'CICS.USER.JOURNAL.A',0,SD
    // EXTENT SYS019,DOSRES,1,0,05775,00060              CCCCC.HH=00385.00,00388.14

    // DLBL DFHJ02B,'CICS.USER.JOURNAL.B',0,SD
    // EXTENT SYS019,DOSRES,1,0,05835,00060              CCCCC.HH=00389.00,00392.14

### LIST Command

The LIST command allows you to obtain a listing of the library directory of a specified library.

The command format is:

    LIST [member]

member can be in one of the following formats:

library(*) | Specifies the 2-character library code or the 1- to 44-character field as defined for the desired library in UEDTB1 or via UUTIL.
(*) indicates that a list of all sublibraries that make up that library is to be displayed.
Note that the parentheses surrounding "*" are required with this format.
library | Specifies the 2-character library code or the 1- to 44-character field as defined for the desired library in UEDTB1 or via UUTIL.
All members in all sublibraries are to be listed (if no default sublibrary is associated with the specified library); otherwise, specifies that only members of the default sublibrary are to be listed.
library1- (sublib.member,type) | library specifies the 2-character library code or the to 44-character field as defined for the desired library in UEDTB1 or via UUTIL.
sublib specifies the required one- to eight-character sublibrary name.
member specifies the optional one- to eight-character member name.
type (optional) specifies any valid one- to eight-character member type.
Only the members with names and types having the prefixes member and type, respectively, are to be listed.

If member is omitted, the keyword argument MEMBER determines the first member to be displayed.

Note
In each of the z/VSE formats described above, the two-character library code can be substituted by a fully qualified library name (file-ID) and a volume name in order for this command to execute.

The following two figures show examples of the USERV LIST command.

    U=N
    DSN=DAVG.SAGLIB.LIBRARY                          LIB=SM VOL=DAVG05
    SUBLIB=ADA82201        1 SUBLIBS
    *A       *     *OBJ     *     *PHASE   *     *X       *
      ADASMXIT       ADACLU         ADACLU         ADAZIN
      PRILOG         ADACOM         ADACOM         ASMCOPT
      ZAPOPT         ADACON         ADACON         LINKS
                     ADACOT         ADACOT       *** END **
                     ADADSP         ADADSP
                     ADANCX         ADALNK
                     LNKVSER8       ADALNKR
                     LNKVSE8        ADANCX

    U=Y
    DSN=DAVG.SAGLIB.LIBRARY                          LIB=SM VOL=DAVG05
    SUBLIB=ADA82201        1 SUBLIBS
    NAME      TYP   CREATED/UPD.-DATE/TIME  BLOCKS  RECORDS/BYTES A-MOD R-MOD SVAELI
    ADASMXIT  A       2010-12-21  10:38:34  29        625      R
    PRILOG    A       2010-12-21  10:38:34  222       7557     R
    ZAPOPT    A       2010-12-21  10:38:34  4         97       R
    ADACLU    OBJ     2010-12-21  10:38:34  33        416      R
    ADACOM    OBJ     2010-12-21  10:38:34  14        170      R
    ADACON    OBJ     2010-12-21  10:38:34  19        240      R
    ADACOT    OBJ     2010-12-21  10:38:34  65        856      R
    ADADSP    OBJ     2010-12-21  10:38:34  13        162      R
    ADANCX    OBJ     2010-12-21  10:38:34  295       3578     R
    LNKVSER8  OBJ     2010-12-21  10:38:34  7         74       R
    LNKVSE8   OBJ     2010-12-21  10:38:34  8         90       R
    ADACLU    PHASE   2010-12-21  10:38:34  24        22728    B     31    24    NO
    ADACOM    PHASE   2010-12-21  10:38:34  10        9224     B     31   ANY    NO
    ADACON    PHASE   2010-12-21  10:38:34  14        13072    B     31   ANY    NO
    ADACOT    PHASE   2010-12-21  10:38:34  48        46880    B     31   ANY    NO
    ADADSP    PHASE   2010-12-21  10:38:34  9         8744     B     31   ANY    NO
    ADALNK    PHASE   2010-12-21  10:38:34  21        19976    B     31    24    NO
    ADALNKR   PHASE   2010-12-21  10:38:34  20        19088    B     31    24    NO
    ADANCX    PHASE   2010-12-21  10:38:34  199       196240   B     24    24    NO
    ADAZIN    X       2010-12-21  10:38:34  2         26       R
    ASMCOPT   X       2010-12-21  10:38:34  3         58       R
    LINKS     X       2010-12-21  10:38:34  21        743      R
    ** END **

The following are examples of use of the LIST command:

1. *USERV L P2(*)

   Display all sublibraries in the PRD2 library.

2. *USERV L VSE.COM.LIBRARY(,A)/SP2RES

   Display all type A members in the default sublibrary in the Com-plete distribution library.

3. *USERV L SDL

   Display the entries in the SDL (System Directory List).

### PRINT Command

The PRINT command enables you to obtain a hard copy listing of a member in a library.

The command format is:

    PRINT [destcode][ATTACH][CC]

The optional arguments are defined below:

destcode | Specifies either a Terminal Idenfication number (TID) or a message switching destination code that identifies the terminal(s) to which a hard copy listing will be queued. Note destcode must always be the first positional operand.
Default: The value determined by the keyword function DESTCODE will determine the printout spool destination. The default for the keyword argument DESTCODE is the screen-to-hardcopy device of the terminal in use, if any. If SCHC=0 (i.e., no default hard copy is assigned), the calling terminal is assumed as default.
ATTACH | Specifies that asynchronous spooling of long printouts is allowed. The program attached is an identical copy of USERV with the name taken from TMGETNAM.
CC | Specifies that usage of ASA carriage control characters in position one of data records is allowed. Note that no headings are provided by USERV. Note If CC is specified, the destcode parameter must also be indicated.

The printout spool listing is printed with 54 lines of data to a page. The top of each page contains summary information generated by USERV identifying that the listing was generated by USERV. Included in this heading is the user ID, the originating TID, the library name, and other applicable information.

Wherever permitted by the terminal access methods, you can use an attention interrupt to abort print requests. On spooled printouts, a message is added to indicate this condition. If you interrupt output by using the BREAK key or equivalent on hard copy terminals, the following message is displayed and new input will be accepted:

    USV0000 - ENTER USERV COMMAND

### SPACE Command

The SPACE command enables you to obtain a display of all free space on the specified disk.

The command format is:

    SPACE [unit|VOLSER]

where unit is the three-character hexadecimal CUU address of the disk device for which a summary of the free space is to be displayed. Note that when VOLSER is the volume serial number of the disk device for which a summary of the free space is to be displayed, VOLSER must be a four- to six-character value.

The following two figures illustrate a typical display generated by the SPACE command.

    S COMTST
     VTOC ADDRESS 000-01 000-04          VOL=COMTST      UNIT=14E
    ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
    AVAILABLE SPACE               ACTUAL            RELATIVE
                              000-05 000-14      000005,000010
                              019-00 023-29      000570,000150
                              075-00 084-29      002250,000300
                              094-20 096-29      002840,000070
                              097-20 098-19      002930,000030
                              112-00 199-29      003360,002640
                              201-00 554-29      006030,010620
    END OF VTOC  002830 OF 016650 TRACKS USED, 013820  FREE
     ****** USV0400 - END OF DATA ******

    S FBA001
     VTOC ADDRESS 000002 000017          VOL=FBA001      UNIT=170
    ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
    AVAILABLE SPACE               ACTUAL            RELATIVE
                              000018 000351      000018,000334
                              046113 046463      046113,000351
                              048864 061599      048864,012736
                              149600 153899      149600,004300
    END OF VTOC  136178 OF 153899 BLOCKS USED, 017721  FREE
     ****** USV0400 - END OF DATA ******

### VTOC Command

The VTOC command enables you to obtain a display of the volume table of contents of a specified disk.

The command format is:

    VTOC [unit|VOLSER]

where unit is the three-character hexadecimal CUU address of the disk device for which a summary of the volume table of contents is to be displayed. Note that when VOLSER is the volume serial number of the disk device for which a summary of the volume table of contents is to be displayed, VOLSER must be a four- to six-character value.

The following figure illustrates a typical display generated by the VTOC command.

    VTOC VOL=DOSRES
     VTOC VOL=DOSRES      UNIT=ACA       VTOC ADDRESS 01499-00 01499-14
    FILE ID--------------------------------TYPE------ACTUAL--------RELATIVE----DATE-
    VSE.SYSRES.LIBRARY                     UN 00000-01 00059-14  000001,000899 06271
    DOS.LABEL.FILE.FF0001002096.AREA1     *UN 00060-00 00062-14  000900,000045 06268
    VSE.POWER.QUEUE.FILE                   DA 00063-00 00063-14  000945,000015 05013
    Z9999996.VSAMDSPC.TB9A603E.TB408055    VS 00064-00 00071-14  000960,000120 03181
    Z9999992.VSAMDSPC.TB9A603E.TEC9DB82    VS 00072-00 00207-14  001080,002040 03181
    Z9999992.VSAMDSPC.TB9A603E.TBFD45A8    VS 00209-00 00376-14  003135,002520 03181
    VSE.SYSTEM.HISTORY.FILE                UN 00393-00 00397-14  005895,000075 06334
    DOS.PAGING.FILE.FF0001002096          *UN 00398-00 00433-14  005970,000540 07089
    DOS.PAGING.FILE.FF0001002096          *UN 00434-00 00999-14  006510,008490 07089
    DOS.PAGING.FILE.FF0001002096          *UN 01000-00 01252-14  015000,003795 07089
    END OF VTOC  00018555 OF 00022500 TRACKS USED, 00003945  FREE
     ****** USV0400 - END OF DATA ******

Note that an asterisk under the "TYPE" column in this figure indicates that the file has expired.

The information displayed for each file is described in the following text.

VOL | Specifies the six-character volume name of the displayed volume.
UNIT | Specifies the CUU of the displayed volume.
FILE ID | Specifies the file identification name.
TYPE | Specifies the two-character file organization type.
File organization types are:
DA | Direct Access
IS | ISAM
SD | Sequential Disk
VS | VSAM
UN | Unknown or unidentified
ACTUAL | Specifies the starting and ending cylinder-head or PBN on which the file resides.
RELATIVE | Specifies the starting and ending track/block of the space on which the file resides.
DATE | Specifies the date the file was created.

### On this page

- Overview
- Command Format
- Using USERV
- Commands