Use the TADD control statement to specify an archival tape that is to be re-added to the master index. This function can be used to re-add an entire archival tape or to re-add specific reports, generations, or resource groups from an archival tape that has cycled out of CA View.
For example, assume that you expected to keep 100 generations of SYSOUT on tape but you actually only kept 90 (NGENT=90). Any tapes containing SYSOUT data older than 90 generations ago could be re-added to the master index with this function, if the tapes had not been overwritten since they had been cycled out of CA View. Note that it is even possible to re-add an overwritten tape by salvaging it first with the SARTCP utility.
Syntax:
/TADD DDNAME=xxxxxxxx ID=(sysout-id,…) GEN=(gen,…) RESOURCE=(name,…). UNIT=uuuuuuuu STORGRP=ssssssss
where:
Specifies the name of the DD statement used to define the archival tape to be added to the master index.
Optionally specifies a SYSOUT identifier, generic SYSOUT identifier, or a list of SYSOUT identifiers to be re-added to the master index.
A generic SYSOUT identifier is specified by suffixing a portion of the SYSOUT identifier with an asterisk. If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote will end the ID. For example, if the value were JIM’S REPORT it must be entered as ‘JIM’’S REPORT’ or “JIM’S REPORT”.
Optionally specifies the archival generation number or a list of archival generation numbers for which SYSOUT is to be re-added to the master index.
If SYSOUT and generation numbers are specified, only the SYSOUTs for the specified generations are added to the database.
Optionally specifies the name of a resource group or a list of resource groups to be re-added to the master index.
Specifies an optional one- to eight‑character unit name.
Specifies an optional one- to eight‑character storage group name.
Note: STORGRP and UNIT must be specified if reports are to be eligible for Expanded Access Server of Tape (SAREAS).
After SARTDR TADD runs, you must run SARPAC on the recovered tape if you have the Expanded Access Server and you recovered the tape with SARTCP SKIP and NULL statements.
When the CA VIEW database has ARCHCHG=baseyear specified, SARTDR verifies the baseyear from the tape against the CA VIEW database baseyear. TADD processes the tape only if the two baseyears are the same. For example, if a tape was created from a database with a baseyear of 2000, and the CA VIEW database baseyear is 1980, the TADD will not be allowed.
Example 1
In this example, VIEW.SYSTEM1.SARTAPE.T0000011 is to be re-added to the master index. The name of the database is VIEW.SYSTEM1.
The following job is run:
//EXAMPLE JOB ACCOUNT,PROGRAMMER //STEP1 EXEC PGM=SARTDR,PARM='VIEW.SYSTEM1' //STEPLIB DD DSN=CAI.CVDELOAD,DISP=SHR //SYSPRINT DD SYSOUT=* //TAPEIN DD VOL=SER=T00033,UNIT=TAPE, // DSN=VIEW.SYSTEM1.SARTAPE.T0000011, // DISP=SHR //SYSIN DD * /TADD DDNAME=TAPEIN
Example 2
In this example, reports from archival generation 267 are re-added to the master index from tape VIEW.SYSTEM1.SARTAPE.T0000103.
The following job is run:
//EXAMPLE JOB ACCOUNT,PROGRAMMER //STEP1 EXEC PGM=SARTDR,PARM='VIEW.SYSTEM1' //STEPLIB DD DSN=CAI.CVDELOAD,DISP=SHR //SYSPRINT DD SYSOUT=* //TAPEIN DD VOL=SER=T00326,UNIT=TAPE, // DSN=VIEW.SYSTEM1.SARTAPE.T0000103, // DISP=SHR //SYSIN DD * /TADD DDNAME=TAPEIN GEN=267
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|