CA Earl provides different methods for accessing TMC Volume and DSNB record information. The desired access or run type (TYPRUN) is specified using a SET statement. The coding example on Using CA Earl illustrates the use of the SET statement.
The following access types are available:
SEQUENTIAL
TYPRUN = R_SEQUENTIAL access of the TMC returns all Volume and DSNB records in the TMC in their physical sequential order. This access type is most useful when a listing of all or selected data set are to be reported on. Volume records will be returned to CA Earl, one at a time, without any DSNB information. DSNB records will be passed to CA Earl without any Volume information. The retrieval process stops when the end of the TMC is reached. You must include a DD statement, with a ddname of TAPEDB pointing to the desired CA 1 TMC data set. CA 1 does not have to be active for this TYPRUN. This is the default access type.
TYPRUN = R_VOLUME access of the TMC returns all Volume records in the TMC in their physical sequential order. The retrieval process stops after all Volume records have been read. You must include a DD statement, with a ddname of TAPEDB, pointing to the desired CA 1 TMC data set. CA 1 does not have to be active for this TYPRUN.
TYPRUN = R_CHAINED access of the TMC reads Volume records sequentially and returns the information for each Volume record to CA Earl, a record at a time.
The process terminates after all active records have been read. The TAPEDB DD statement is required for this access type and it must point to the production (active) TMC data set name. CA 1 must be active or batch active for this TYPRUN.
TYPRUN = R_AUDIT access is provided to return information obtained from the CA 1 Audit file. Data is provided for all CA 1 Audit record types. A complete description of the Audit record types and the information they contain is located in the discussion of the TMSAUDIT utility in this guide. Records are provided in their physical sequential order. You must include a DD statement, with a ddname of TAPEDB pointing to the desired CA 1 Audit file. See the sample members in the CA 1 Source library.
TYPRUN = R_VAULT access is provided to process CA 1 vault information obtained from the CA 1 utility TMSVMVLT. Records are provided in their physical sequential order. You must include a DD statement, with a ddname of TAPEDB pointing to the data set created by the VMSOUT DD. CA 1 does not have to be active for this TYPRUN. For a sample CA Earl program to access the CA 1 vault information, see the sample members in the CA 1 Source library. Since several fields are provided which are not part of the EARLDEFS definition, you must use TMEYDEFV to access the data.
TYPRUN = R_RETENTION access is provided to process information obtained from the CA 1 utility programs TMSCLEAN, TMSCTLG, TMSCYCLE and TMSEXPDT. Records are provided in their physical sequential order. You must include a DD statement with a ddname of TAPEDB pointing to the output file from one of the above CA 1 utilities. CA 1 does not have to be active for this TYPRUN. Since several fields are provided which are not part of the EARLDEFS definition, you must use TMEYDEFR to access the data.
TYPRUN = R_REPORT allows you to process information which was previously extracted from CA 1 using CA Earl with a TYPRUN value of VOLUME, SEQUENTIAL, CHAINED, or AUDIT. You can use the EARL source member TMERPT01 to create the extract records. The CA Earl PUT function is used to create the file. The field definitions are provided by the EARLDEFS member. You must include a DD statement with a ddname of TAPEDB, pointing to the output file from the extract run. You can use the EARL source member TMERPT02 to produce this output file from the extracted records created by TMERPT01. CA 1 does not have to be active for this TYPRUN.
|
Copyright © 2013 CA Technologies.
All rights reserved.
|
|