Batch Operations › Available Batch Utility Programs › TSSRECVR

TSSRECVR

The TSSRECVR utility is an aid to recovery from loss or corruption of the CA Top Secret Security File. During normal system operation, CA Top Secret security maintains a record of all changes to the Security File in the Recovery File. The Recovery File is a perpetual file; that is, change records are added to the file in a wraparound format, and the file must be sufficiently large so as to accommodate all changes that occur between Security File backups.

In the event of loss of the Security File, CA Top Secret is activated using the backup Security File. TSSRECVR may then be used to extract all changes made subsequent to the last Security File backup. TSSRECVR formats selected recovery file change records into a batch TSS command script which may be applied to the backup copy of the Security File using TSSCRIPT (the next heading discusses TSSCRIPT).

TSSRECVR accepts change record selection criteria via the keywords TIME or DATE, which are specified in the EXEC PARM. The correct format follows:

EXEC PGM=TSSRECVR,PARM='TIME(hhmm),DATE(yyddd)'
 - or -
EXEC PGM=TSSRECVR,PARM='TIME(hhmm),DATE(-nn)'

Where:

• hhmm—Is the hour and minute for selecting recovery records. This should be the time of the last Security File backup.
• yyddd—Is the earliest date (in Julian format) for selecting recovery records.
• -nn—Is the number of previous days for which you wish to retrieve changes from the Recovery File.

To use the contents of the entire Recovery File, specify TIME(0000),DATE(00000).

The following sample CA Top Secret batch job file invokes TSSRECVR to recover all changes made to the CA Top Secret Security File after the last Security File backup at 1:00 AM today.

//TSSJOB ACID=SECADMIN,PASSWORD=ILUVTSS
//EXEC   PGM=TSSRECVR,PARM='DATE(-00),TIME(0100)'

The resultant TSS command script is returned as a PUN file to the batch job submitter’s reader along with the job listing. TSSRECVR abend codes for the VM environment follow:

Note: If the TSS command contains the keyword TARGET when it is placed in the recovery file on the system it was entered, the TARGET keyword will be commented out and replaced with TARGET(=). This is to prevent duplicate permits on remote nodes when recovery is done on one system. For example:

TSS TARGET(=,NODE2) PERMIT(USER1) DSN(ABC.) ACCESS(READ)

Will show up in the output from the TSSRECVR utility as:

TSS TARGET(=) /*RGET(=,NODE*/ PERMIT(USER1) DSN(ABC.) ACCESS(READ)