Run Archival Task

The following sections describe the commands, parameters, and procedures necessary to operate the archival task.
view140
The following sections describe the commands, parameters, and procedures necessary to operate the archival task.
Contents
2
2
Starting the Archival Task
Note:
The OPT=NEW or OPT=INEW command does not start a new DR tape. A new DR tape is automatically started after a back cycle is completed. You can force a new DR tape by replying NO to the IEF455D mount message.
You start SARSTC with one of the following operator commands:
S SARSTC S SARSTC,OPT=DUMP S SARSTC,OPT=NEW S SARSTC,OPT=CLEAN S SARSTC,OPT=IDUMP S SARSTC,OPT=INEW S SARSTC,OPT=STOPBU
Where
  • OPT=DUMP
    Specifies that the new tape generation resides on the same tape as the previous generation, provided there is room on the tape and the maximum number of generations per tape (MAXGENT initialization parameter) is not exceeded
  • OPT=NEW
    Specifies that the archival task initiates its backup cycle immediately following initialization and before archiving any SYSOUT
    The new tape generation resides on a new tape.
  • OPT=CLEAN
    Specifies that the archival task performs a cleanup of its database. The cleanup recovers space for any SYSOUT groups that are created or loaded to disk when a system crash or abend of the archival task occurs
    The archival task automatically performs a cleanup operation as part of its backup cycle.
  • OPT=IDUMP
    Specifies that an interim backup cycle is initiated immediately following initialization and before archiving any SYSOUT
    This backup resides on the same tape as the previous backup, provided the tape has room, because the archival generation number is not incremented. (Also, an initialization parameter, MAXGENT, specifies the maximum number of generations that are written to one tape.)
  • OPT=INEW
    Specifies that the archival task initiates an interim backup cycle immediately following initialization and before archiving any SYSOUT
    The archival generation number is not incremented; however, this backup resides on a new tape.
  • OPT=STOPBU
    Specifies not to restart the backup task. Use this option when the earlier execution of SARSTC was canceled or abended during a backup cycle
    and you do not want to restart the backup
    automatically. When this option is used, the SARINIT parameter EROPRO is set to ALL so that ERO processing in the next
    standard
    backup cycle processes all reports from prior generations. If the EROPRO was previously set to YES, it is not changed.
We recommend that you add command S SARSTC to member.
COMMND
xx
of SYS1.PARMLIB to start the archival task automatically at each IPL.
Stop the Archival Task
SARSTC is terminated with the following operator command:
P SARSTC
Initiate the Backup Cycle
Backup to tape and the creation of a new disk generation are normally performed automatically at a site-defined time and at site-defined intervals thereafter; however, tape backups can be initiated at any time with one of the following operator commands:
F SARSTC,DUMP F SARSTC,NEW F SARSTC,IDUMP F SARSTC,INEW
Where
  • DUMP
    Specifies that the new tape generation resides on the same tape as the previous generation, provided there is room on the tape and the maximum number of generations per tape (MAXGENT initialization parameter) is not exceeded
  • NEW
    Specifies that the new tape generation resides on a new tape
  • IDUMP
    Specifies that an interim backup cycle is initiated
    This backup resides on the same tape as the previous backup, provided there is room on the tape, because the archival generation number is not incremented. (There is also an initialization parameter, MAXGENT, which specifies the maximum number of generations that are written to one tape.)
  • INEW
    Specifies that an interim backup cycle is initiated
    The archival generation number is not incremented; however, this backup resides on a new tape.
Important! The CA View database has a tape capacity of 65535 tapes. Once tape capacity reaches 90 percent, SARBKT98 informational messages are seen in the SARSTC task. If full tape capacity is reached, an SARTPO61 error message is issued, and the SARSTC task issues an U0061 abend.
Unload the Archival Tape
When archiving directly to tape, the archival and DR tapes remain allocated and in use through the next backup cycle. The following operator command causes CA View to unload and unallocate the archival tape immediately:
Syntax:
F SARSTC,UNLOAD
CA View allocates the tape the next time it is required.
Delete SARSTC99 Messages
When CA View encounters an exceptional condition and a routing code other than zero is specified (as the site initialization parameter ROUT defines), SARSTC99 operator messages are produced for each exceptional condition. You can delete these operator messages from the operator console by entering the following operator command:
Syntax:
F SARSTC,DOM
Manually Requesting Cleanup
If the CA View archival task terminates abnormally due to a system crash or an abend, the last SYSOUT group that archived can be left in an incomplete condition (OPEN status). The same condition can occur for a SYSOUT group being reloaded to disk from tape by a user (LOAD status). You can request a cleanup of these incomplete SYSOUT groups by the following operator command:
Syntax:
F SARSTC,CLEAN
A manual request for cleanup is only necessary after system crashes, because the archival started task normally performs a cleanup operation as part of its backup cycle.
To recover the space a SYSOUT group left in OPEN or LOAD status occupies, issue two cleanup commands at least four hours apart.
Note:
If CLEAN=NO, manually cleanup with the online C command. The modify clean command does not affect CA Deliver open subfiles, only SYSOUT subfiles left open by SARSTC or a CA View FSS collector. SYSOUT files originating from CA Deliver left in OPEN status can only be cleaned up with the online C command.
If long-running jobs are archiving SYSOUTs direct-to-View such as a started task archiving a log of some type, set CLEAN to NO. Because, two consecutive backup cycles completed four hours apart deletes the SYSOUT and corrupts the database.
Delete an OPEN SYSOUT
Never delete a SYSOUT in OPEN status because CA View cannot determine whether the report was left in OPEN status or whether it is actually being processed. The SYSOUT is marked as in delete status and is hidden in the database.
If the SYSOUT originated in CA View, it is deleted after two consecutive backup cycles complete processing. If the SYSOUT originated in CA Deliver, it is marked for deletion. If CLEAN is set to NO, it is never deleted. It continues to occupy space until CLEAN is set to YES and two consecutive backup cycles complete four hours apart.
Manually Cleaning CA Deliver Open SYSOUTs with CLEAN=NO
The online C command is used to mark a SYSOUT for cleanup. The command responds with CLEAN PENDING. Execute a second online C command at least four hours later. This time, the command responds with sysoutid REMOVED, which sets the SYSOUT to DISK status. The SYSOUT can now be deleted with the online D command or left to expire under normal retention criteria.
Refresh Exceptional Condition Checking
You can change the exceptional condition checking parameters established when the archival task was started, and you can refresh the conditional parameters with the following operator command:
Syntax:
F SARSTC,RESET
This command clears the currently defined parameters and the SARXCTAB DD statement read again.
The exceptional conditions parameters are refreshed from the indicated control statements.
Note:
For more information about exceptional condition checking, see the section Exceptional Condition Checking.
Run Optical Migration Subtask
To allow flexibility in scheduling optical migration, you can use a separate subtask under the CA View started task to control migration of reports to optical disk.
Display Active Initialization Parameters 
To display active initialization parameters in the started task joblog and in the system log, issue this command:
F
SARSTC
,DISPLAY
where
SARSTC
 s your STC name.
You can abbreviate DISPLAY as DI or DISP.
If the ERO option is active, the ERO parameters are listed after the primary parameters.