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.
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:
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.