Selection mask - - VARIABLE ACTION field - - LISTCAT

ONXLISTCAT outfil [, VERSION=0 | 2 | 3] [, E]

outfil This Variable Action will write a variable length record consisting of the complete catalog entry relating to the file or job variable marked with X, into the file outfil.

VERSION=0 This parameter is primarily to be used for diagnostic purposes, and will cause the catalog entries to be written in the old BS2000 V10-compatible format. A file created with the VERSION=0 paramaeter can be processed with a RECAT command. Reconstruction of the Guard attributes is not possible.

VERSION=2 This parameter is applicable from OSD V1 and is primarily to be used for diagnostic purposes, and will cause the catalog entries to be written in the new FSTAT layouts of OSD V3. A file created with the VERSION=2 parameter cannot be processed with a RECAT command.

VERSION=3 This parameter is only available to the system administrator under the TSOS userid. The physical catalog entry will be written to the file, and the format will be determined by the DSECT DCACATE MF=D,CETYPE=*FILE | *JV macro.

A file created with the VERSION=3 parameter cannot be processed with a RECAT command.

If a listcat file is to be used later with a CFS RECAT command (see page 7-), the VERSION= parameter should not be used.

E Extend. This option will cause an existing file to be opened in OPEN=EXTEND mode.

Notes:

In addition to listing the catalog entries for Job variables with the LISTCAT Variable Action, the Job variable data contents will also be stored. Using the CJ (Create Job variables) option in the RECAT command (see below), it is possible to recreate Job variables with previous contents, even if the Job variable no longer exists. This method can also be used to create Job variables on a remote system as follows: transfer the Listcat file with File Transfer, then issue a RECAT file,CJ command on the remote system.

The RECAT command can be used to process catalog list files produced with LISTCAT. RECAT will check the current file attributes against those stored in the LISTCAT file. Any discrepancies will result in a CAT command being executed which will reset the attributes to their earlier values. For a full description of the RECAT command, see page 7-.

If CFS is loaded from a userid other than TSOS, any passwords will be overwritten with binary zeroes.

 
--------------------------------------------------------
 
TSOS:

ONXLISTCAT outfil [, VERSION=0 | 2 | 3] [, E]

This Variable Action will create a variable length record in the file outfil for each file or Job variable marked with X. The record will be a 1 to 1 representation of the full catalog entry.

Any existing passwords will not be overwritten with binary zeroes.

VERSION=3 This parameter is only available to the system administrator under the TSOS userid. The physical catalog entry will be written to the output file. The layout is described by the DSECT DCACATE MF=D,CETYPE=*FILE | *JV.

A Listcat file created with VERSION=3 cannot be processed with the RECAT command.

The RECAT command (see page A1-) can be used in conjunction with an extract file created by the LISTCAT command. RECAT compares the entries in the LISTCAT file against the actual entries for the files, and will issue a CAT command in the event of any inequalities to reset the attributes to their previous values.