CTOALOCP – Backing Up the Automation Log

The CTOALOCP utility copies the contents of one Automation Log file to another Automation Log file or to a sequential data set. The utility can be used to perform any of the following functions, depending on the parameters specified:

Backing up the Automation Log to another Automation Log. Automation Log backup files can be displayed, just like the current Automation Log file, using the Automation Log screen (option OL).
Increasing the size of the current Automation Log file.
Copying the Automation Log to a sequential file. The sequential file can be processed by a report generator utility or restored and displayed later as an Automation Log file.
Restoring a sequential backup file to the format of an Automation Log file.
Changing the data set organization of an Automation Log.

Parameters are passed to the CTOALOCP utility using the DALCPPRM DD statement.

The following parameters can be specified:

Table 310 CTOALOCP Parameters

Parameter	Description
STARTDATE	Earliest date of the log records to be copied. Format: yymmdd. Default: Date of the earliest record in the log.
STARTTIME	Earliest time of the log records to be copied. Format: hhmmss. Default: 000000
ENDDATE	Latest date of the log records to be copied. Format: yymmdd. Default: Date of the latest record in the log.
ENDTIME	Latest time of the log records to be copied. Format: hhmmss. Default: 240000
FROMDSN	Name of the input data set for the copy operation. Default: Name of the operational Automation Log file.
FROMTYPE	Organization of the input data set. Valid values are: S and blank. Type S must be specified if the input data set is a sequential file. For all other input data set types, the field must be blank.
TODSN	Name of the output data set for the copy operation.
TOTYPE	Organization of the output data set. Optional. Valid values are: V – DIV (VSAM Linear) data set. D – Direct Access (BDAM) data set. S – Sequential file. The default is the type of the operational Automation Log (meaning, the value of parameter AUTOMLOG in member CTOPARM). For more information about parameter AUTOMLOG, see the Control-O chapter of the INCONTROL z/OS Installation Guide.
TOVOLUME	Name (volser) of the volume on that the data set named in parameter TODSN resides. This parameter is mandatory for an output data set of type V (whether specified explicitly with parameter TOTYPE or by default).
TOUNIT	Name of the unit to which the output data set is allocated. Default: SYSALLDA
TORECNUM	Number of records allocated to the output file. (This value is used to determine the size of the output data set.) Default: number of records in the input file. Valid values are: nnnnnnnn – Specified number of records. MINIMAL – The number of records copied from the input data set, based on date and time specified limits.

Parent Topic

Control-O Utilities