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:
- Move the cursor to the beginning of the line that contains the name of the entry that you want to work with.
- 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:
- Move the cursor to the entry with which you want to work.
- 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.
- 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:
- Select the Batch execution option on the Catalog Services panel.
- Select the with list option on the Catalog Services panel.
- On the Data Set List panel. enter the DEFINE or DELETE line command against the catalog entry you want to work with.
Related topics