Database Record Definitions

CA TLMS provides macros in CAI.CTAPMAC which can be used to produce listings which describe the RMF, VMF and Transaction database records. These macros are:

TLMRMF: Produces a listing of the Retention Master File record definitions
TLMVMF: Produces a listing of the Volume Master File record definitions
TLMTRN: Produces a listing of the Transaction record definitions

Parameter values are supplied which create unique data labels, generate a DSECT, equate pre-Release 5.4 data labels to Release 12.6 Second Edition labels, print comments and determine what type of record is described. If you have code using pre-Release 5.4 data labels, you should change it to use Release 12.6 Second Edition labels, because future releases may not contain the old names.

The TLMRMF, TLMVMF and TLMTRN macros are similar. The following reproduction of the front of the TLMVMF macro is used as an example of these record definition macros.

*********************************************************************
*                  VOLUME MASTER FILE RECORDS                       *
*********************************************************************
* THIS MACRO GENERATES ALL VMF RECORD DESCRIPTIONS. THE FIRST TWO *
* CHARACTERS OF THE LABEL ARE USED TO MAKE RECORD LABELS UNIQUE.    *
* THE PRE-TLMS 5.4 LABELS MAY ALSO BE EQUATED TO ONE DEFINITION OF  *
* OF THE RECORDS.                                                   *
*                                                                   *
*   PARMS:                                                          *
*         DEFINE = DEFINE VALUES FOR FIELDS. DEFAULT=YES            *
*                  YES - USE 'DC' TO DEFINE DEFAULT VALUE FOR FIELD.*
*                  NO  - USE 'DS' DO NOT DEFINE FIELD. THIS VALUE   *
*                        FORCED WHEN 'DSECT=YES'                    *
*         DSECT  = GENERATE A DSECT FOR THE RECORD. DEFAULT=NO      *
*                  YES - GENERATE '&P'.'&TYPE'.'SCT' DSECT          *
*                  NO  - DO NOT GENERATE DSECT                      *
*         DS1    = GENERATE FIELDS FOR DATASET CELL 1.              *
*                  YES    - GENERATE WITH SAME PREFIX               *
*                  'XX'   - GENERATE WITH 'XX' AS PREFIX            *
*                  NO     - DO NOT GENERATE DETAIL FIELDS           *
*         DS2    = GENERATE FIELDS FOR DATASET CELL 2. (MDS ONLY)   *
*                  YES    - GENERATE WITH SAME PREFIX               *
*                  'XX'   - GENERATE WITH 'XX' AS PREFIX            *
*                  NO     - DO NOT GENERATE DETAIL FIELDS           *
*         EQUOLD = EQUATE OLD LABELS TO NEW LABELS. DEFAULT=NO      *
*                  YES    - OLD FIELDS ARE DEFINED AND POSITIONED   *
*                  NOLIST - SAME AS YES BUT FIELDS NOT PRINTED.     *
*                  NO     - OLD FIELDS ARE NOT DEFINED OR LISTED.   *
*         LAB    = LABEL/PREFIX. 1-8 CHAR. REQUIRED.                *
*                  1ST 1-2 CHAR USED AS PREFIX FOR GENERATED LABELS.*
*                                                                   *
*         LIST   = PRINT RECORD COMMENTS. DEFAULT=NO                *
*                                                                   *
*         TYPE   = TYPE OF RECORD GENERATED.  DEFAULT=BASE          *
*                  BASE = VOLUME RECORD                             *
*                  BSE  = VOLUME RECORD                             *
*                  MDS  = MULTIPLE DATASET RECORD                   *
*                  CTL  = CONTROL RECORD FOR VMF                    *
*                  MVOL = MULTIPLE VOLUME RECORD                    *
*                  MVL  = MULTIPLE VOLUME RECORD                    *
*                  SEG  = VOLSER SEGMENT DEFINITION RECORD          *
*                  MSG  = MESSAGE RECORD                            *
*                  AUX  = AUXILLARY RECORD                          *
*                  DSC  = DATASET CELL FOR A VMF RECORD             *
*                  DSN  = DATASET CELL FOR A VMF RECORD             *
*********************************************************************