Version 7.4.4
 —  Utilities  —

CLCOPY: Copy Dual Command Log

The CLCOPY function is used only if dual logging of command information was specified for the Adabas session. This function copies the dataset that has the earlier time stamp to a sequential dataset. Once the CLCOPY function is completed successfully, the copied dataset is marked as empty. This function may, therefore, be used only once for any given dataset.

The CLCOPY function is not allowed in single-user mode.

graphics/util_adares_clcopy.png

This document covers the following topics:


Optional Parameters

ADARES CLCOPY can be specified with no parameters.

DUALCLD: Dual Command Log Device Type

DUALCLD specifies the device type used for the dual command log datasets. This parameter is required if the device type used for the command log dataset is different from that specified with the ADARUN DEVICE parameter.

NOUSERABEND: Terminate without Abend

When an error is encountered while the function is running, the utility prints an error message and terminates with user abend 34 (with a dump) or user abend 35 (without a dump).

If NOUSERABEND is specified, the utility will not abend after printing the error message. Instead, the message "utility TERMINATED DUE TO ERROR CONDITION" is displayed and the utility terminates with condition code 20.

OPENOUT: Open DDSIAUS1/2 or SIAUS1/2 Output Datasets

The OPENOUT parameter indicates that the DD/SIAUS1/2 output datasets are to be opened by ADARES, even if no data is actually to be copied. Without OPENOUT, the sequential output datasets are not opened if ADARES detects an end-of-file condition while attempting to read the first input record; this may cause problems in some operating system environments. With OPENOUT, the output datasets are opened before the first input record is read.

TEST: Test Syntax

The TEST parameter tests the operation syntax without actually performing the operation. Only the syntax of the specified parameters can be tested; not the validity of values and variables.

TWOCOPIES: Create Two Copies of Output

TWOCOPIES causes two copies of the output to be created.

Top of page

Examples

Example 1:

ADARES CLCOPY

Dual command log is to be copied.

Example 2:

ADARES CLCOPY TWOCOPIES

Dual command log is to be copied. Two copies of the output are to be created.

Top of page