ACTUATE


Use the ACTUATE keyword to request optional processing related to allocation of the VSAM cluster that is used for the command’s output.

Related topic

Use

ACTUATE is an optional keyword for the ALLOCATE subcommand.

Syntax

ACTUATE=(<parameter>,[DSN=<parameter>],
[EROPT=<parameter>])

Parameters

Specify one of the following values for the first parameter:

Value

Description

DELETE

The current VSAM cluster is deleted before the new VSAM cluster is allocated.

REUSE

The current VSAM cluster is allocated and overwritten.

RENAME

The current VSAM cluster is renamed before the new VSAM cluster is allocated.

IDCAMS

A sequential or partitioned data set is passed to Access Method Services as input for allocation of the new VSAM cluster. Due to the design of this feature, each area should have a separate IDCAMS definition.

If you specified RENAME or IDCAMS as the first parameter on the ACTUATE keyword, you must specify a dataset name mask for the DSN parameter. You can use the same substitution variables as defined for the DSNAME keyword on DSNAME.

The optional EROPT parameter can be specified to indicate whether or not to continue ALLOCATE subcommand processing in the event that an error occurs during processing of the output area allocation criteria that is requested by the ACTUATE keyword. Specify one of the following values for the EROPT parameter:

Value

Description

ABORT

Abort the allocate function if an ACTUATE processing error is encountered.

IGNORE

Continue processing of the ALLOCATE function, even if an ACTUATE processing error is encountered.

Default

The default value for the optional EROPT parameter is EROPT=ABORT. Defaults do not apply to any other parameters.

Alias

None

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*