CHECK-TSOSCAT Output differences between the MAREN catalog and TSOSCAT

This statement enables differences which exist between the MAREN catalog and the file catalog (TSOSCAT) with respect to tape files and file generation groups to be determined. The statement also releases occupied tapes with older file generations.

Differences can have the following causes:

• The MAREN catalog contains information which concerns multiple systems;
• The MAREN catalog contains unambiguous archive number assignments, but multiple entries with the same file name can exist;
• The TSOSCAT can contain multiple file generation entries for one archive number;
• Modifications to the TSOSCAT using the EXPORT-FILE command are not automatically transferred to the MAREN catalog.

Format

CHECK-TSOSCAT

Alias: CHTS

TYPE-OF-FILES = *ANY (...) / *FGG-ONLY(...)
	*ANY (...)
		|	ATTRIBUTES = *FILE-NAME / list-poss(6): *FILE-NAME / *USER-ACCESS / *CREATION-DATE /
		|		*EXPIRATION-DATE / *LAST-ACCESS-DATE / *FIRST-VOLUME
	*FGG-ONLY(...)
		|	FREE-DATE = *UNCHANGED / *TODAY / *DIALOG

Operands

TYPE-OF-FILES =
Types of tape files to be checked.

TYPE-OF-FILES = *ANY(...)
Specifies that the catalog entries for all tape files are to be checked (see notes on “TYPE- OF-FILES = *ANY”).

ATTRIBUTES = *FILE-NAME / list-poss(6): *FILE-NAME / *USER-ACCESS / *CREATION-DATE / *EXPIRATION-DATE / *LAST-ACCESS-DATE / *FIRST-VOLUME
File or tape attributes which are to be checked for discrepancies.

TYPE-OF-FILES = *FGG-ONLY(...)
Specifies that all file generation groups cataloged in TSOSCAT are to be checked to establish whether the MAREN catalog still contains entries for older generations which are no longer contained in TSOSCAT (see notes on “TYPE-OF-FILES = *FGG-ONLY”).

FREE-DATE =
Specifies whether older file generations are only to be logged or whether the relevant tapes are also to be released in the MAREN catalog.

FREE-DATE = *UNCHANGED
Older file generations are only logged.

FREE-DATE = *TODAY
Older file generations are logged and the relevant tapes are released.

FREE-DATE = *DIALOG
If an older file generation is found, the complete MAREN catalog entry for the relevant tape is output. The user can then decide whether or not the tape is to be released. If required, execution of the statement can be terminated at this point. The specification *DIALOG is not permitted in batch mode.

Notes

TYPE-OF-FILES = *ANY

• This function merely logs any differences in the TSOSCAT and MAREN catalog entries of tape files. It does not make any changes to the MAREN catalog. Only those attributes specified explicitly in the ATTRIBUTES operand are compared.
• The associated MAREN catalog entry is read for each tape contained in the TSOSCAT entries for tape files if that tape has actually been written to. If the tape does not exist in the MAREN catalog, if it is entered under another user ID there, or if it is entered as a free tape, a line is output which contains the file name from TSOSCAT followed by the archive number and the note “NOT EXISTING” or “NOT RESERVED”. In this event, the individual attributes are not compared.
• If the tape contains the attribute USER-ACCESS = *FOREIGN-READ-ONLY in the MAREN catalog entry (the tape can be accessed in read mode only from foreign user IDs), comparison of the shareability attribute is suppressed since there is no corresponding value in the TSOSCAT entry.
• No comparisons are carried out for temporary tape files.

TYPE-OF-FILES = *FGG-ONLY

• If entries for file generations which no longer exist in a TSOSCAT cataloged file generation group are found in the MAREN catalog, and FREE-DATE=*UNCHANGED or *TODAY is specified, these entries are logged with the following attributes:

  VOLUME
USER-IDENTIFICATION
FILE-NAME
CREATION-DATE
FREE-DATE

• If FREE-DATE = *TODAY is specified, the expiration date for the tape is replaced by the current date in the MAREN catalog. This reserves the tape for the user's own user ID until the next release run.
• If FREE-DATE = *TODAY or *DIALOG is specified, those tapes whose expiration date has already elapsed are neither output nor modified since they will be released anyway the next time a release run takes place.
• Archive entries are not generated for temporary tape files or for tapes which are not assigned the own user ID in the MAREN catalog.

Examples

//check-tsoscat
THE FOLLOWING DIFFERENCES EXIST BETWEEN MAREN CATALOG AND TSOSCAT:
FILENAME IN TSOSCAT                                    VSN /FSEQ  IN MARENCAT
-----------------------------------------------------------------------------
:2OSG:$USER1.TAPE.FILE.2                               M5637K/0001
FILENAME IN TSOSCAT :   TAPE.FILE.2
FILENAME IN MAREN   :   TAPE.FILE.2(1)
-----------------------------------------------------------------------------
:2OSG:$USER1.TAPE.FILE.2(3)                           M5637K/0003
FILENAME IN TSOSCAT :   TAPE.FILE.2(3)
FILENAME IN MAREN   :   TAPE.FILE.2(4)
%  MARM170 STATEMENT '//CHECK-TSOSCAT' PROCESSED

All differences between the MAREN catalog and TSOSCAT are output to SYSOUT.

//check-tsoscat type-of-files=*fgg(free-date=*unch)
THE FOLLOWING MAREN CATALOG ENTRIES HAVE NO CORRESPONDING ENTRIES IN TSOSCAT:
-----------------------------------------------------------------------------
VOLUME  USER-ID   FILE-NAME                                CR-DATE  FREE-DATE
-----------------------------------------------------------------------------
M3005K USER1    MAREN.SAMPLE(*0001)                        <date>   <date>
MARM170 MARM170 STATEMENT '//CHECK-TSOSCAT' PROCESSED

A check is carried out to establish whether the MAREN catalog contains older file generations than the file generation groups in the file catalog. The names of the older file generation groups are output only to SYSOUT (FREE-DATE=*UNCHANGED).