Utilities › TMSOSCAT Utility—Report on TMC/Operating System Catalog Discrepancies › Report Description › Job Control Statements

Job Control Statements

The IDCAMS step is executed to list the ICF catalog entries.

//IDCAMS   EXEC PGM=IDCAMS
//SYSPRINT DD  DSN=&.&IDCAMS.,DISP=(NEW,PASS),UNIT=SYSDA,
//             SPACE=(CYL,5)
//SYSIN    DD  *
 LISTCAT NONVSAM ALL                                     Notes
 LISTCAT NONVSAM ALL CATALOG(UserCatalogDataSetName)     Notes
//TMSOSCAT EXEC PGM=TMSOSCAT[,PARM='parm']
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//TMSRPT   DD  SYSOUT=A
//IDCAMS   DD  DSN=&.&IDCAMS.,DISP=(OLD,DELETE)
//SYSOUT   DD  SYSOUT=A
//SORTLIB  DD  DSN=SYS1.SORTLIB,DISP=SHR
//SORTWK01 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK02 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK03 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK04 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK05 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SORTWK06 DD  UNIT=SYSDA,SPACE=(CYL,(2,2),,CONTIG)
//SYSIN    DD  *
 (control statements here)
/*

Note:

1. This IDCAMS control statement lists only the system master catalog.
2. Code this IDCAMS control statement for each user catalog thatcontains the tape data set names controlled by CA 1.

Parameter Definitions

DATEFMT=(fmt)

Specifies the date format to be printed on TMS Report 17. The date pattern indicated by (fmt) is limited to 10 bytes and must be enclosed in parentheses. This parameter is optional. For more information on valid date formats, see Overriding the Preferred Date Pattern.

SYNC

Specifies that all active files (not scratch and not deleted) in the TMC should be checked with the operating system catalogs to see if they are currently cataloged. If they are, the new TMISCAT and DSNBISCA bits are set.

RESYNC

Specifies that all active files on volumes (that are not in scratch or deleted status) in the TMC, should be checked with the operating system catalogs to see if they are currently cataloged. If the catalog indicators in the TMC record match the status in the OS Catalog (both say the file is NOT currently cataloged or both say the file IS currently cataloged), then no information is printed in the report and no updates are performed.

If the DSN being checked is found in the OS Catalog and the TMC catalog indicators are not currently on the following happens:

• The message "DSN FOUND ON CATALOG=" is printed in the report.
• The catalog indicators (TMISCAT, TMCATLOG, DSNBISCA, and DSNBWSCA) are set ON.
• The catalog-counter fields (TMCATCNT and DSNBCCNT) are set to a value of 1.

If the DSN being checked is not found in the OS Catalog and the TMC catalog indicators are on the following happens:

• The message "DSN –NOT- ON CATALOG=" is printed in the report.
• The current catalog indicators (TMISCAT and DSNBISCA) are turned off.
• The catalog-counter fields are set to a value of 0.

If your z/OS environment is setup where the CA 1 TMC is shared by systems that do not share all MVS/Catalogs and you run TMSOSCAT with PARM=RESYNC on one system; then you must run TMSOSCAT with PARM=SYNC on all other systems. A file that is cataloged in an MVS/Catalog and is not available on the system where TMSOSCAT was run with PARM=RESYNC has its catalog indicators turned off. You must run TMSOSCAT with PARM=SYNC on the other system or systems to turn the indicators back on.

If your z/OS environment is set up whereas all systems sharing the TMC also share the same MVS/Catalog structure (all user catalogs are shared and absolutely no tape data sets are cataloged in any unique master catalogs;) then simply running TMSOSCAT with PARM=RESYNC on one system is sufficient.

TEST

Used if SYNC or RESYNC was specified. The only difference is that the actual update of the TMC records are bypassed. The total count reflects how many records would have been updated.

DETAIL

Specified that a detail line in TMS Report 17 should be printed for each file being updated, or that would have been updated if TEST is also specified.

JCL Considerations

IDCAMS

Defines the SYSPRINT output from an IDCAMS ICF catalog list. The VSAM catalog entries are not analyzed. The SYSIN control statement must be LISTCAT NONVSAM ALL. If multiple user catalogs are to be processed, the IDCAMS output should be MODed to a single data set.