Skip to Content

XCPYINIT (copy initialization) automation control point

Use the XCPYINIT automation control point to dynamically allocate tape drives.

The tape server invokes this automation control point once for each job step that performs the copy function. The disk server does not invoke this automation control point.

Variables

This automation control point does not use XCPYINIT-specific variables. However, it can use global variables that you set in the XSUTGLOB automation control point.

Related topics

Automation-control-points

Copy-related-automation-control-points 

Return codes

The XCPYINIT automation control point returns the following return codes:


Return code

Description

0

(default value) Signifies normal completion

No action is required.

Any other value

Abnormal termination

Set the return code to any non-zero value to cancel the entire job.

Usage considerations

You can use the _allot function with this automation control point to dynamically allocate one or more tape drives for the job step. For example, you might have the following line in XCPYINIT:

x = _allot('TAPE495','TAPE','365','NGT.IMAGE.COPY.TAPE495','NOWAIT')

This example tells the utility to allocate based on the following criteria:

  • Use the tape unit associated with DD name TAPE495.
  • Save the image copies for 365 days.
  • Use the name NGT.IMAGE.COPY.TAPE495.
  • Do not wait on a tape unit if one is not unavailable.

For more information about this function, see _allot-function.


 

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

BMC AMI Stats for Db2 13.1