UDS - Data Set Maintenance Utility (z/OS only)

The Com-plete online utility UDS enables you to examine and modify characteristics of disk-resident data sets and system catalog entries.

This document covers the following topics:

• Command Format

• UDS Functions

• UDS VSAM Services (UDVS for z/VSE)

Command Format

The primary method of invoking UDS is entry of the command:

*UDS function 

where function represents any of the available UDS commands together with its arguments. If you omit the function parameter, either the UDS menu for COM-PASS users or the UDS options menu for non-COM-PASS users is displayed.

Menus

COM-PASS Users

The following two figures illustrate the UDS menu screens used by COM-PASS users.

17:04:27     TID    12          COM-5.1.             User ID ADMIN    08/31/97
                     -- Disk Space Maintenance --                       Page 1
       Function           ID    PFK          Operands                     UDS1
---------------------     --     ---  ----------------------------------------
    Allocate Data Set     AD       1  DSN,Volume
     Display Data Set     DD       2  DSN
        Find Data Set     FD       3  DSN
       Purge Data Set     PD       4  DSN,Volume(s)
      Rename Data Set     RD       5  DSN,Volume(s),NewDSN
     Scratch Data Set     SD       6  DSN,Volume(s)
        Vsam Services     VS       7
          List DSName     LD       8  DSN(,Volume)(,Hex)
         List Catalog     LC       9  (All)(,Index)(,Volume)  for CVOLS
           List Space     LS      10  Volume
            List VTOC     LV      11  Volume

      Select Function:        or PFK
         and Operands
         DSN or Index:
               NewDSN:
            Volume(s):
              DEVtype:
       'Hex' OR 'All':                                   (Enter for next page)

17:04:39     TID    12          COM-6.2.            User ID ADMIN     08/31/02
                      -- Disk Space Maintenance --                      Page 2
Function                  ID     PFK          Operands                    UDS2
-----------------------   --     ---  ----------------------------------------
       Catalog Data Set   CD       1   DSN,Volume(S),DEVtype
     Recatalog Data Set   RD       2   DSN,Volume(S),DEVtype
     Uncatalog Data Set   UD       3   DSN
     
     
     
     
     
     
     
     
     
     
     
     Select Function:        or PFK
        and Operands
        DSN or Index:                   
        
        
        
        
 Volume(s) OR NewVOL:              
             DEVtype:                                   (Enter for next page)

Note that only LIST VTOC, LIST SPACE, and LIST DSNAME are allowed as default functions defined with the UD function of UUTIL.

Non-COM-PASS Users

The following figure illustrates the UDS menu screen used by non-COM-PASS users.

ENTER   <OP> AND OPERAND.       < > MEANS OPTIONAL.
OP......MEANS.................. OPERAND
FIND    SEARCH VTOCS.           DSN
LIST    LIST DSN INFORM.        'DSNAME',DSN,<VOL>,<'HEX'>
LIST    LIST VTOC.              'VTOC',VOL
LIST    LIST FREE SPACE.        'SPACE',VOL
LIST    LIST CATALOG.           'CTLG', <'ALL' >, <INDEX > ,<VOL >
ALLOC   ALLOCATE A DSN.         DSN,VOL
RENAME  RENAME.                 DSN,NEWDSN,VOL,VOL 
SCRATCH SCRATCH.                DSN,VOL,VOL 
PURGE   SCRATCH,PURGE.          DSN,VOL,VOL 
DISP    SEARCH CATALOG.         DSN 
CATLG   CATALOG DSN.            DSN,DEVTYP,VOL,VOL 
UNCATLG UNCATALOG DSN.          DSN 
RECATLG RECATALOG DSN.          DSN,DEVTYP,VOL,VOL  
HELP    REDISPLAY MENU.

This UDS menu lists all the argument options available with UDS. Note that arguments within < > are optional; arguments enclosed within single quotation marks must use the exact characters as represented.

You can abbreviate all function codes and arguments with the smallest number of letters that make them unique. In the command function descriptions below, the minimum abbreviation required for each command function is indicated by underscoring of the required characters.

Example 1

After displaying the menu, you must enter the arguments in one statement line as illustrated in the following sample UDS request:

LIST DSNAME,WORK.DATASET,PACK01 

This sample UDS command requests a display of allocation information for the data set WORK.DATASET. The command format assumes that the data set is not cataloged, and directs the search to be restricted to disk volume PACK01.

Example 2

UDS is a fully conversational program, i.e., you may enter UDS commands when you invoke UDS or at any time thereafter.

The next example illustrates the specification of the UDS LIST command at UDS invocation.

*UDS LIST DSNAME,WORK.DATASET,PACK01 

UDS Functions

After you have invoked UDS and used one of the options, you can display or redisplay the menu by pressing ENTER. Note that you can make a new UDS request at any time, either while the menu is displayed or while the output from a previous UDS command is displayed.

Normally, all UDS requests must include an operation code followed by the list of applicable arguments; however, if you enter a data set name without an operation code, the operation code DISP is assumed.

To terminate UDS, press CLEAR, or enter the Com-plete program termination command *EOJ.

The functions available from the UDS menus are summarized in the following table and discussed in detail in the remainder of this section. The shortest possible abbreviations are indicated by underlining.

ALLOC Function

The ALLOC function enables you to dynamically allocate a data set.

The command format is:

ALLOC dsname,vol

The arguments are:

On the next screen you can enter the necessary DCB and SPACE parameters:

14:57:05        TID    11          COMTEST          User SAG             19.05.10
                            UDS Dataset Allocation                         UDS3
                                                                               
Data Set Name  . . . :  SAG.TEST                                               
Volume . . . . . . . :                                                         
Catalog DSN  . . . . :  Y               (Y or N)                               
                                                                               
Management class . . :                  (Blank for system default)             
Storage class  . . . :                  (Blank for system default)             
Data class . . . . . :                  (Blank for system default)             
                                                                               
Dsorg  . . . . . . . :                  (DA,DAU, PO,POU,POE, PS,PSU,PSL,PSLU)  
Recfm  . . . . . . . :                                                         
Blksize  . . . . . . :      0                                                  
Lrecl  . . . . . . . :      0           EATTR..:            (NO, OPT)          
                                                                               
Allocation unit  . . :                  (TRK, CYL or average block length)     
Primary  . . . . . . :         0                                               
Secondary  . . . . . :         0                                               
Directory  . . . . . :         0                                               
Form . . . . . . . . :                  (CONTIG, MXIG, ALX or blank)           
Round  . . . . . . . :                  (RO or blank)                          
Expiration date  . . :                  (YYYYDDD)            

Once you have entered all the requested DCB and SPACE information, the data set is allocated and a display equivalent to that obtained from entering the LIST function is returned. (See the LIST Function).

CATLG Function

The CATLG function enables you to dynamically catalog data set names in the system catalog and automatically create the appropriate indices.

The command format is:

 CATLG dsn,<device>,vol1[,vol2,...]   

The arguments are:

UDS creates a catalog entry in the appropriate catalog for each of the volumes indicated.

DISP Function

The DISP function enables you to dynamically locate a data set by means of its catalog entry. This is the default function assumed when you enter a data set name but omit the operation or function.

The command format is:

DISP dsn

The argument is:

UDS locates the data set requested and gives the same display as the FIND function; it lists the data set by name and identifies the volume and device type on which it resides. (See the FIND Function).

FIND Function

The FIND function enables you to search all online disk volume devices for the data set name specified.

The command format is:

FIND dsname

The display returned gives the volume identification number of the disk containing the data set, the device type of the volume, and the CUU. A typical display received in response to the FIND operation is:

VOLUME(S): 
DISK01 (3330-1) ON 460 
FIND OPERATION SUCCESSFUL

Note that the FIND function returns information about the requested data set after searching the online disk volumes, not the system catalog. In addition, if more than one data set with the same name exists on more than one volume, the FIND function finds only the first data set encountered in the search. This search is performed on an ascending CUU basis.

HELP Function

The HELP function enables you to return to the UDS function menu any time after you have entered a UDS request.

The command format is:

HELP

No arguments are provided or accepted with the HELP function. Only the UDS function menu is displayed.

LIST Function

The LIST function enables you to:

• Display allocation information from the DSCB for a specified data set.

• Obtain a listing of the data sets residing on a specific disk volume.

• Obtain a summary listing of the available free space on a specific disk volume.

• Display catalog entries for a specified high-level catalog index.

  The command format for the LIST function varies depending upon the list request entered. The following subsections discuss the four types of the LIST function.

List Data Set Information

The LIST DSNAME function enables you to list DSCB information for a given data set.

The command format is:

LIST DSNAME,dsn,[vol],[HEX]

The arguments are:

The initial information displayed is the summary information as taken from the format 1 DSCB. If the data set is an ISAM data set, pressing ENTER displays the information from the format 2 DSCB. If the data set has more than three extents, pressing ENTER displays information about the remaining extents as taken from the format 3 DSCB.

The following figure illustrates a typical response that might be received after entering a LIST request for a data set named COM.DEMO.

LIST DSNAME,COM.DEMO 
VOLUME(S): 
WORK01 (3330-1) ON 460 
F1DSCB = 0404 00 35       0194 00 23(HEX) 
CR DATE     EX DATE     NOBDB  DSIND 
78 214      00 000       000    80 
EXTS DSORG  RECFM  BLKSIZE    LRECL OPTCD 
01   PO      FB      2480       80    00 
ALLOCATION = CYLS  CONTIG 
EXTNT TYPE    LOW       HIGH   SPACE   LOW(HEX)    HIGH(HEX) 
00   PRIME  0253 00   0254 14  92 00   00FD 00     00FE 0E 
TOTAL SPACE =      95 CYLS 00 TRKS 
PERCENT USED      33

A description of the above information may be found in the IBM publication describing the utility IEHLIST.

List VTOC Information

The LIST VTOC command enables you to list VTOC information for a given disk volume.

The command format is:

LIST VTOC,vol 

The arguments are:

The information displayed is a listing of the data sets residing on the volume. The actual information in the display is taken from the disk volume table of contents and includes summary information such as:

• Data set names

• Type of data set

• Type of allocation

• Number of extents

• Size of primary extent

• Size of secondary extent(s)

The following figure illustrates a typical response that might be received after entry of a LIST request for VTOC information for the disk volume WORK01.

 LIST VTOC,WORK01 
 DATASET NAME           TY UNIT EX PRIM SECN CREAT EXPDT LAST  PW

ADABAS.DB137.ASSOR1     DA  CYL 01   15    0 87006       87201 
NATURAL.NATPROC.LOAD    PS  CYL 01   15    0 87062 98365 87255 
NETPASS.V2.SYSTEM       PS  CYL 01   10    0 87300       87305 RW

where:

List Free Space Information

The LIST SPACE command enables you to list free space information for a given volume.

The command format is:

LIST SPACE,vol

The arguments are:

The volume free space display includes such items as:

• The relative track address for each free extent

• The size of each free extent

• A summary of the total free space residing on the volume

The following figure illustrates a typical display that might be given after entering a LIST request for the free space on a given volume.

LIST SPACE,WORK01
 REL ADD    CYLS  TRACKS 
       1       0       1  
     456       6       0 
    1425     320       0 
    7581       1       0 
  TOTALS     327      18 
LIST OPERATION SUCCESSFUL

List System Catalog Information

The LIST CTLG command enables you to list system catalog information for a given high-level index.

The command format is:

LIST CTLG,[ALL],[index],[vol]

The arguments are:

The information displayed is a listing of the data set catalog entries. If you specify the optional argument ALL, all index levels are included in the display.

The following figure illustrates a typical response received after entry of a LIST request for catalog information.

LIST CTLG,,COM. 
INDEX IS A CVOL POINTER TO SAG01 
COM.COB.LOAD               3330-1 SAG01 
COM.DASDS                  3350   PACK01 
COM.MESSAGES               3350   PACK02 
COM.PGMLIB                 3350   PACK01 
COM.SD                     3330-1 SAG01 
LIST OPERATION SUCCESSFUL

PURGE Function

The PURGE function enables you to dynamically purge a specific data set. If the data set is cataloged, you can use the UDS UNCATLG function to remove the catalog entry.

The command format is:

PURGE dsn,vol1[,vol2,...]

The arguments are:

RECATLG Function

The RECATLG function enables you to dynamically change catalog entries in the system catalog without needing to uncatalog and catalog the entire entry.

The command format is:

RECATLG dsn,<device>^,vol1[,vol2,...]

The arguments are:

UDS creates a new catalog entry for the specified data set. The new device types and volumes entered are reflected in the new catalog entry.

RENAME Function

The RENAME function enable you to dynamically change the name of a specific data set.

The command format is:

RENAME dsn1,dsn2,vol1[,vol2,...]

The arguments are:

UDS renames the data set on each of the volumes indicated. Note that if the data set resides on more than one volume, you must specify multiple volumes.

SCRATCH Function

The SCRATCH function enables you to dynamically scratch a specific data set. If the data set is cataloged, you can use the UDS UNCATLG function to remove the catalog entry.

The command format is:

SCRATCH dsn,vol1[,vol2,...]

The arguments are:

UDS scratches the data set from each of the volumes indicatedonlyif the data set expiration date has expired.

UNCATLG Function

The UNCATLG function enables you to dynamically remove catalog entries from the system catalog and automatically remove the correct indices.

The command format is:

UNCATLG dsn

The argument is:

UDS uncatalogs the data set from the system catalog and uncatalogs any unnecessary indices. Note that the highest-level index is not removed.

UDS VSAM Services (UDVS for z/VSE)

Com-plete's VSAM SERVICES allow COM-PASS users to use the interactive execution of IBM's IDCAMS utility program.

The command format is:

VS

The VSAM SERVICES menu, shown in the following figure, then appears.

11:59:16     TID    13           COM-5.1.           User ID ADMIN     09/26/97
                          -- Vsam Services --                             UDV1

  Select Function   :
  Name or Level     :
  Catalog Name      :
  List Options      : S   (S for short, D for detail)
                    :     (P for Printout)                   Printer:  PSG

  Functions
                      LL  --  Listcat Level(level)
                      LE  --  Listcat Entry(name )


  Direct Access Method Services Command:
  >                                                                        <
  >                                                                        <
  >                                                                        <
  >                                                                        <
  PF10 = Scroll Left  PF11 = Scroll right