CTLG Command

The CTLG command maintains and modifies the CA Workload Automation SE index data set entries. The primary use of data set entries in the index data set is to determine the availability of input requirements for job scheduling. The three most current creations of each data set (by CA Workload Automation SE submitted jobs) are recorded in the index data set, regardless of whether the data set is a GDG or not. The volume serial data in the index data set is informational only, since the system catalog remains the source for locating data sets during job processing.

This command has the following format:

►►─ CTLG ─ ,DSN=dataset ─ ,TYPE= ─┬─ ADD ──┬──────────────────────────────────►
                                  ├─ CON ──┤
                                  ├─ COPY ─┤
                                  ├─ DEL ──┤
                                  └─ REPL ─┘

 ►─ ,VOL= ─┬─ volser ─────────────┬─┬─────────────────┬─┬────────────┬────────►
           │     ┌─ , ──────┐     │ └─ ,DVC=nnnnnnnn ─┘ └─ ,ENTRY=n ─┘
           └─ ( ─▼─ volser ─┴─ ) ─┘

 ►─┬────────────┬─────────────────────────────────────────────────────────────►◄
   └─ ,SEQ=nnn ─┘

DSN

Defines the data set name to be modified.

Limits: 1 to 44 alphanumeric characters

TYPE

Specifies the CTLG function to be performed. Function must be one of the following:

ADD: Specifies to add new entries for a data set already defined in the CA Workload Automation SE database.
CON: Specifies to consolidate system and index data set entries.
COPY: Specifies to copy system catalog entries.
DEL: Specifies to delete existing entries.
REPL: Specifies to replace existing entries.

Processing for these CTLG functions is described on the following pages.

VOL

Defines the volume serial numbers on which the data set resides.

volser

Defines a single volume.

Limits: 1 to 6 alphanumeric characters

(volser,...,volser)

Defines up to ten volumes enclosed in parentheses and separated by commas. (Processing for TYPE=REPL discusses replacing entries with more than ten volumes.)

DVC

(Optional) Defines the device type code for the data set.

Default: Device code of current entry

Limits: 8 digits - hexadecimal

ENTRY

Defines the entry to delete or replace. ENTRY is required when TYPE=DEL or TYPE=REPL. ENTRY=1 is the most recent.

Limits: 1 numeric character from 1 to 3

SEQ

(Optional) Defines a label sequence.

Default: Label sequence of current entry

Limits: 1 to 3 numeric characters

More information:

Processing for TYPE=REPL