Catalog Utilities function
Catalog Utility panels
Use the Catalog to search if other than default system catalog fields to specify alternate catalogs. The Display confirm delete field is used to specify the display of a confirmation screen when data sets are deleted.
OPTION ===>
Generic catalog search function:
Search name ===>
Format option ===> QUICK (Q = Quick; S = Short; L= Long)
Clusters only ===> Y (Y = Yes; N = No)
Catalog to search if other than default system catalog:
Catalog name ===>
Catalog password ===> (if catalog is password protected)
Display confirm screen: ===> Y (Y= Yes; N= No)
The following table describes the fields on the Catalog Utility panel:
Field | Description |
|---|---|
Generic catalog search function (all catalogs) | |
Search dataset name | Specify the Search name with explicit characters or a pattern data set mask (fully qualified, no quotes) to define the data set names to include in the list. A pattern data set mask or name consists of explicit characters or a combination of explicit and pattern characters. The rules used for specifying a Search Name are similar to those used in ISPF/PDF’s Dataset List Utility. See Pattern data set names. |
Format option | Specifies the amount of information to display about each data set. The default value for this parameter is set by the Format option field on the Parameters screen (option 0.4). There are three possible values:
|
Clusters only | Specifies whether or not VSAM data and index components are included in the data set lists. Specify Y (Yes) to show only VSAM cluster names (along with non-VSAM data set names) in the data set list. Specify N (No) to show data and index components as well as VSAM cluster names (along with non-VSAM data set names) in the data set list. |
Catalog to search if other than default system catalog | The CATALOG NAME and CATALOG PASSWORD fields are only used when generating a list for a private catalog. |
Catalog name | Optionally, specify a catalog for File-AID to search. When a catalog name is not specified in this field for a generic catalog search (option BLANK), File-AID searches the default system catalog. |
Catalog password | Specify the password if the catalog is password protected. |
Display confirm screen | Specify whether File-AID displays a Confirm Delete screen, as shown in Confirm Dataset Delete Screen in Delete-dataset-option when the D (Delete) line command is used on Catalog utility list screens. Valid entries are Y (Yes) and N (No). |
Data set list screens
File-AID displays the appropriate Catalog Utility Dataset List screen for the specified Format option. Examples of this screen for the QUICK, SHORT, and LONG Format options are shown in the following figures.
The names on the Catalog Utility Dataset List screen match the value in the Search Name field. If Search Name is left blank, File-AID displays all data set names that match the user’s TSO profile prefix. The top line on the screen states the number of data set names that were found.
If a value is not specified in the Catalog Utility screen Search name field, File-AID performs two searches. One search is based on the TSO prefix; the other is based on the value in the VSAM Intermediate name field on the System Parameters screen (see System-Parameters).
The VSAM Intermediate name sets the second-level qualifier when the VSAM high-level name is used as the high-level qualifier. When File-AID is used to generate the catalog list, any VSAM data sets with the VSAM intermediate name as the second-level qualifier are selected.
Catalog Utility Dataset List Screen in QUICK Format
COMMAND ===> SCROLL ===> CSR
Use Primary Command ? for a list of Primary and Line Commands
Action ---- D A T A S E T N A M E ------------- --Type-- -Status-
USERID9.FASAMP.$$AA.AAAA.AA.ALEE.ORDER.LONG1 NON-VSAM
USERID9.FASAMP.$AAA.AAAA.AITST01 NON-VSAM
USERID9.FASAMP.$AAA.AAYS.ENC CLUSTER
USERID9.FASAMP.$IAM.AITST011 NON-VSAM
USERID9.FASAMP.$IAM.AITST1 NON-VSAM
USERID9.FASAMP.$IAM.AITST2 NON-VSAM
USERID9.FASAMP.$IAM.AITST3 NON-VSAM
USERID9.FASAMP.$IAM.AITST4 NON-VSAM
USERID9.FASAMP.$IAM.AITST5 NON-VSAM
USERID9.FASAMP.$IAM.AITST6 NON-VSAM
USERID9.FASAMP.$IAM.JSTST3 NON-VSAM
USERID9.FASAMP.$IAM.KSTST7 NON-VSAM
USERID9.FASAMP.AAAA.AAAA.MV.ALEE.TES CLUSTER
USERID9.FASAMP.AAAA.AANO.TESTENC CLUSTER
USERID9.FASAMP.AAAA.AKTST71 CLUSTER
USERID9.FASAMP.AAAA.AKTST72 CLUSTER
USERID9.FASAMP.AAAA.AKTST73 CLUSTER
USERID9.FASAMP.AAAA.AKTST74 CLUSTER
USERID9.FASAMP.AAAA.AKTST8 CLUSTER
USERID9.FASAMP.AAAA.AXTST2 ALT INDEX
Catalog Utility Dataset List Screen in SHORT Format
COMMAND ===> SCROLL ===> CSR
Use Primary Command ? for a list of Primary and Line Commands
Action ---- D A T A S E T N A M E ----+ --Type-- -Volume--ENC--Status-
USERID9.FASAMP.$$AA.AAAA.AA.ALEE.ORD NON-VSAM TSO001 Y
USERID9.FASAMP.$AAA.AAAA.AITST01 IA TSO001 N
USERID9.FASAMP.$AAA.AAYS.ENC CLUSTER TSO001 Y
USERID9.FASAMP.$IAM.AITST011 IA TSO001 N
USERID9.FASAMP.$IAM.AITST1 IA TSO001 N
USERID9.FASAMP.$IAM.AITST2 NON-VSAM MIGRAT N
USERID9.FASAMP.$IAM.AITST3 NON-VSAM MIGRAT N
USERID9.FASAMP.$IAM.AITST4 NON-VSAM MIGRAT N
USERID9.FASAMP.$IAM.AITST5 NON-VSAM MIGRAT N
USERID9.FASAMP.$IAM.AITST6 NON-VSAM MIGRAT N
USERID9.FASAMP.$IAM.JSTST3 NON-VSAM MIGRAT N
USERID9.FASAMP.$IAM.KSTST7 IA TSO001 N
USERID9.FASAMP.AAAA.AAAA.MV.ALEE.TES CLUSTER TSO001+ N
USERID9.FASAMP.AAAA.AANO.TESTENC CLUSTER TSO001 N
USERID9.FASAMP.AAAA.AKTST71 CLUSTER TSO001 N
USERID9.FASAMP.AAAA.AKTST72 CLUSTER TSO001 N
USERID9.FASAMP.AAAA.AKTST73 CLUSTER TSO001 N
USERID9.FASAMP.AAAA.AKTST74 CLUSTER TSO001 N
USERID9.FASAMP.AAAA.AKTST8 CLUSTER TSO001 N
USERID9.FASAMP.AAAA.AXTST2 ALT INDEX TSO001 N
Catalog Utility Dataset List Screen in LONG Format
COMMAND ===> SCROLL ===> CSR
Use Primary Command ? for a list of Primary and Line Commands
Action ---- D A T A S E T N A M E ----+ Org Volume Fmt Trks %Us Xt ENC
USERID9.FASAMP.$$AA.AAAA.AA.ALEE.ORD PS TSO001 VB 1 100 1 Y
USERID9.FASAMP.$AAA.AAAA.AITST01 IA TSO001 V 1 0 1 N
USERID9.FASAMP.$AAA.AAYS.ENC VSE TSO001 V 15 0 1 Y
USERID9.FASAMP.$IAM.AITST011 IA TSO001 V 1 0 1 N
USERID9.FASAMP.$IAM.AITST1 IA TSO001 V 15 0 1 N
USERID9.FASAMP.$IAM.AITST2 MIGRAT
USERID9.FASAMP.$IAM.AITST3 MIGRAT
USERID9.FASAMP.$IAM.AITST4 MIGRAT
USERID9.FASAMP.$IAM.AITST5 MIGRAT
USERID9.FASAMP.$IAM.AITST6 MIGRAT
USERID9.FASAMP.$IAM.JSTST3 MIGRAT
USERID9.FASAMP.$IAM.KSTST7 IA TSO001 V 15 0 1 N
USERID9.FASAMP.AAAA.AAAA.MV.ALEE.TES VS TSO001+V 15 0 1 N
USERID9.FASAMP.AAAA.AANO.TESTENC VS TSO001 V 1 0 1 N
USERID9.FASAMP.AAAA.AKTST71 VS TSO001 F 1 0 1 N
USERID9.FASAMP.AAAA.AKTST72 VS TSO001 F 1 0 1 N
USERID9.FASAMP.AAAA.AKTST73 VS TSO001 F 1 0 1 N
USERID9.FASAMP.AAAA.AKTST74 VS TSO001 F 1 0 1 N
USERID9.FASAMP.AAAA.AKTST8 VS TSO001 F 1 0 1 N
USERID9.FASAMP.AAAA.AXTST2 VS TSO001 V 1 0 1 N
The following table describes the fields on the data set list panels:
Field | Description |
|---|---|
Dataset Name | Dataset names that match the Search name. To see the entire name, place a cursor on the data set name and scroll to the right or left. |
Type | (Quick and Short formats) Catalog entry type. Types that may be displayed include: CLUSTER, DATA, INDEX, ALT INDEX, PATH, NON-VSAM, GDG BASE, USER CTLG, ALIAS, and PAGESPACE. |
Org | The following codes are used for the data set organization: DA—BDAM |
Volume | (Short and Long formats) Volume on which the data set is stored. Multi-volume data sets are identified by the + (plus sign) following the Volume field with the Short and Long formats. |
STATUS | Indicates if line commands were processed on the dataset name. For example, this column can indicate: DELETED, OLDNAME, NEWNAME, and UPDATED. |
% US | (Long format) Percent of allocated tracks currently in use. |
XT | (Long format) Number of extents contained in the data set. |
FMT | (Long format) Record format (RECFM) of the data set. |
TRKS | (Long format) Number of tracks allocated for the data set. |
ENC | (Short and Long formats) Specifies if the data set is encrypted. Encrypted data sets are specified with Y; otherwise, N is specified. |
Use the END command (PF3) to terminate the data set list display.
Commands
File-AID permit the uses of primary and line commands on a list of dataset names displayed by the Catalog utility. The following tables list the available primary and line commands.
Catalog Utility Primary Commands
Command | Description | Alias |
|---|---|---|
FIND | Scroll to dataset name containing search text | F |
LOCATE | Scroll to dataset starting with search text | L |
Print the list | P | |
SEARCH | Search for a string in all data sets | |
RESET | Reset Dataset list to the original generic search | RES |
Catalog Utility Line Commands
Command | Description | Limitations | Aliases |
|---|---|---|---|
BROWSE | File-AID Browse | All Access Methods | 1 |
EDIT | File-AID Edit | All Access Methods | 2 |
SEARCH | File-AID Search/Update Utility | All Access Methods | 36 |
MEMLIST | File-AID Library Utility | PDS/PDSE | 31, ML |
32 | File-AID Dataset Utility | All Access Methods | |
COPY | File-AID Copy Utility | All Access Methods | 33 |
COPYF/COPYT | File-AID Copy Utility | All Access Methods | |
VSAM | File-AID VSAM Utility | VSAM | 35 |
ALOCLIKE | File-AID (3.2/3.5) Allocate New Dataset | All Access Methods | AL |
D | File-AID (3.2/3.5) Delete Dataset | All Access Methods | |
DR | File-AID (3.5) Delete/Redefine VSAM | VSAM | |
F | File-AID (3.2) Free Space | Sequential, PDS/PDSE, BDAM | |
M | File-AID (3.5) Alter VSAM | VSAM | |
R | File-AID (3.2/3.5) Rename Dataset | All Access Methods | |
U | File-AID (3.2) Uncatalog Dataset | All Non-VSAM Access Methods | |
I | Display Information | All Access Methods | |
S | Display Information -- Short | All Access Methods | |
PRINTD | File-AID Print Data File | All Access Methods | PD, P1 |
PRINTX | File-AID Print XREF | PDS/PDSE | PX, P2 |
PRINTS | File-AID Print Selection Criteria | PDS/PDSE | PS, P3 |
PRINTL | File-AID Print Record Layouts | PDS/PDSE | PL, P4 |
PRINTA | File-AID Print Audit Dataset | Sequential | PA, P5 |
COMP | File-AID Compare | All Access Methods | 10 |
COMPO/COMPN | File-AID Compare | All Access Methods | |
XMLGEN | File-AID Utilities XMLGEN | All Access Methods | 3G |
LISTCAT | IDCAMS | All Access Methods | LISTC |
HMIGRATE | HSM Command | All Access Methods | HMIG |
HRECALL | HSM Command | All Access Methods | HRECA |
HDELETE | HSM Command | All Access Methods | HDEL |
B | ISPF/PDF Browse | Sequential, PDS/PDSE | |
E | ISPF/PDF Edit | Sequential, PDS/PDSE | |
V | ISPF/PDF View | Sequential, PDS/PDSE |
Printing Catalog Lists
Catalog lists are printed by using the P command. The P (Print) command calls the File-AID print facility to write the list to SYSOUT. SYSOUT is then released for printing. The print facility uses the values set in the print parameter default options discussed in Print Parameters and displays a print values prompt screen that can be modified (Print Parameters Screen).