Working with a list of catalog entries

When you select the “List catalog entries” option on the Catalog Services panel, a list of catalog entries is displayed.

A sample catalog services data set list is shown in Figure 1. The list includes the following information for each entry:

Field descriptions

Catalog Id
The catalog used for the current list function, if applicable.
Types
The entry type used for current list function.
Type
The type of a specific catalog entry.
Volume
The first volume in volser-list.
MV
A multi-volume data set indicator:
blank
single volume
*
single volume with multi-volume capability
2-9
number of volumes
!
more than 9 volumes
Created
Creation date.
Dsorg
The organization of the data set:
PS
Sequential
PSU
Sequential unmovable
PSE
Sequential extended format
PO
Partitioned
POU
Partitioned unmovable
POE
Partitioned extended (PDSE)
DA
Direct
DAU
Direct unmovable
HFS
MVS Hierarchical File System
VS
VSAM
VSE
VSAM extended format
Blank
None of the above
Recfm
The record format of the data set.
Lrecl
The logical record length of the data set.
XT
Number of extents.
KB allocd
Number of kilobytes currently allocated for a VSAM, NVSAM or PDSE data set.
%Used
The percentage of currently allocated space used for a VSAM, NVSAM or PDSE data set. For VSAM files this figure is calculated using the FREESPC value.
KB Avail
Number of kilobytes currently available for a VSAM, NVSAM or PDSE data set.
%Avail
The percentage of currently available space for a VSAM, NVSAM or PDSE data set.
%HiUsed
The highest used byte as a percentage for a data set. For VSAM files this figure is calculated using the HI-U-RBA value.
Hi KB Avail
Number of kilobytes above the highest used byte for a data set.
%HiAvail
The percentage of space above the highest used byte.
SYS%
This column contains the value Y if the data set is managed by the DFSMS SYS% conversion utility, otherwise, it is blank.

To scroll to see more information, press the Right function key (F11).

If a catalog error occurs (for example, if the data component of a VSAM cluster is not found), ERROR appears in the Entry type field. You can look for more information about such errors by entering the AMSMSG command and viewing the IDCAMS messages.

To update your list view, to include any changes that you have made and also any changes made by other users since you first displayed the list, enter the REFRESH primary command.

To view or find a data set entry, choose from the following techniques:

  • To move forward or backward through the list, use the Down function key (F8) or the Up function key (F7). You can also enter a value in the Scroll field. You can also use the scroll commands to move the display window over the list.
  • Use the FIND command to search for a character string that forms part or all of the data set name.
  • Use the LOCATE command to scroll to a particular row number.

To select a service, perform either of these actions

  • Type the line command:
    1. Move the cursor to the beginning of the line that contains the name of the entry that you want to work with.
    2. Type the command (for example, BROWSE). You can type an equal sign (=) to perform the same command for more than one entry.

    You can abbreviate the line commands to their first letter, (for example, A instead of ALTER) except in the case of EDIT and EXTENTS, where you would use the first two letters.

  • Select the function from the Process pull-down menu:
    1. Move the cursor to the entry with which you want to work.
    2. Press the Process function key (F6). (If the cursor is outside the list area, you work with the first entry in the list.) The selected line is highlighted in another color. The Process pull-down menu opens below the action bar as shown in Figure 1.
    3. Select an option on the menu to perform a function such as browse or edit.

To define or delete a catalog entry and run the function in batch:

  1. Select the Batch execution option on the Catalog Services panel.
  2. Select the with list option on the Catalog Services panel.
  3. On the Data Set List panel. enter the DEFINE or DELETE line command against the catalog entry you want to work with.
Figure 1. Catalog Services: list of catalog entries with Process pull-down menu
  Process   Options   Help
┌───────────────────┐ ─────────────────────────────────────────────────────────
│    1. Alter       │           Data Set List                Row 00001 of 00012
│    2. Define      │                                             Types ALLVSAM
│    3. Copy        │                                   Creat    Dsorg Recfm L
│    4. Delete      │ A.**                              *        *     *
│    5. List        │ A.ESDS                            09/08/14
│    6. Browse      │ A.ESDS.DATA                       09/08/14
│    7. AFP Browse  │ A.ESDSN                           09/08/17
│    8. Edit        │ A.ESDSN.DATA                      09/08/17
│    9. View        │ A.ESDS2                           09/08/14
│   10. Info        │ A.ESDS2.DATA                      09/08/14
│   11. Extents     │ A.KSDS                            07/08/30
│   12. Print       │ A.KSDS.DATA                       07/08/30
│   13. Recall      │ A.KSDS.INDEX                      07/08/30
│   14. Rename      │ A.KSDS2                           08/12/17
│   15. AMS message │ A.KSDS2.DATA                      08/12/17
│   16. Refresh     │ A.KSDS2.INDEX                     08/12/17
│   17. Exit        │ **
└───────────────────┘

 Command ===>                                                       Scroll PAGE
  F1=Help      F2=Split     F3=Exit      F4=CRetriev  F5=RFind     F6=Process
  F7=Up        F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel    

Related topics