Utilities › CTSTAPER Utility—Test CA 1 Operating System Intercepts and Functions › Test Tape OPENs › CTSTAPER Report Field Definitions

CTSTAPER Report Field Definitions

JFCB BEFORE

JFCB image before OPEN processing.

JFCB AFTER

JFCB image after OPEN processing.

CTSVDBU Utility - VSAM Database

Use the CTSVDBU utility for the following VSAM database (VDB) batch services:

• List the records in the VDB.
• Initialize VDB control records and CA 1 required variables.
• Add and delete CA 1 required variables after maintenance.

CTSVDBU performs several utility functions against the VDB. The function is specified through the EXEC PARM. You can specify only one function per one execution of CTSVDBU.

The LIST function is probably the most common use of CTSVDBU. You can use the distributed JCL CTSJVDBL for the LIST function. This function writes all VDB records in a field format. The number of fields and their content vary by record type. The function does not write low VDB and high VDB control records. These records do not contain any user information.

The INIT function creates the VPM control records and some variable records that the CA 1 program processing requires. Use the distributed JCL CTSJVDBI for the INIT function.

The UPDATE function creates the same control records and variable records as INIT, but it also deletes obsolete variables. Use the UPDATE function after any CTS maintenance that creates new variables or deletes obsolete variables. To run the UPDATE function, update the distributed INIT JCL CTSJVDBI to specify PARM=’UPDATE’.

Report Description

CTSVDBU produces a list of records and formats the records by type. Each type lists the values of each field it contains. The LIST function displays all the records in the VDB. The INIT and UPDATE functions display only the records that they change.

Job Control Statements

//INIT     EXEC PGM=CTSVDBU,PARM='LIST|INIT|UPDATE'
//STEPLIB  DD DSN=CAI.CTAPLINK,DISP=SHR
//*CA$FVDB  DD DSN=CAI.TAPEDB.V,DISP=SHR
//SYSPRINT   DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//[HISTCSV  DD DSN=CAI.HISTCSV,DISP=(NEW,CATLG),
//             RECFM=FB,LRECL=120,BLKSIZE=120,DSORG=PS,
//             UNIT=SYSALLDA,VOL=SER=vvvvvv,SPACE=(TRK,(5,5),RLSE)]

Parameter Definition

LIST

Specifies that the CTSVDBU prints the contents of all of the records in the VDB.

INIT

Specifies that CTSVDBU creates all required control records and variables.

UPDATE

Specifies that CTSVDBU creates all required control records and variables. The utility also deletes any obsolete variables.

JCL Considerations

DD CA$FVDB

Only needed when the tape management system has not been started. The VDB is normally dynamically allocated using a DSN that is derived from the TMC by appending a .V to the TMC name. The TMCDSN is available only if the tape system is started.

DD HISTCSV

(Optional) Enables you to create a comma-separated value (CSV) report of the daily and weekly VDB history records when you specify PARM=LIST. Low VDB and high VDB records are not available in this report. You can import this file in any program that edits CSV files.

Control Statement Specification

CTSVDBU does not use any control statements.

CTSVDBU Report

20xx/017                    CTSVDBU Utility Report               PAGE=0001
 
 PARM=LIST
  
  KEY=@VARCTS_Alert_ID                                                      
  CHANGED BY CTSVPM   AT 20xx/017 16:33:06.55 TIMESTAMP=20xx/017 16:33:12.61
  DATA=My_Default_Alert-2                                                   
                                                                          
  KEY=@VARCTS_Alert_Operator                                                
  CHANGED BY CTSVPM   AT 20xx/017 16:33:06.55 TIMESTAMP=20xx/017 16:33:12.61
  DATA=GT                                                                   
                                                                          
  KEY=@VARCTS_Alert_Pool_ID                                                 
  CHANGED BY CTSVPM   AT 20xx/017 16:33:06.55 TIMESTAMP=20xx/017 16:33:12.62
  DATA=My_Default_Pool-2                                                    
                                                                          
  KEY=@VARCTS_Alert_Send                                                    
  CHANGED BY CTSVPM   AT 20xx/017 16:33:06.55 TIMESTAMP=20xx/017 16:33:12.63
  DATA=EMPTYW                                                               

The report that the CTSVDBU LIST function creates includes multiple record types with different data. The report is not formatted in columns and rows format. The report uses free form data elements with keywords to identify the data that it presents.