gtpi1m3zSystem Installation Support Reference

Module Copy Selection/Validation

The module copy selection/validation user exit, UCPY, is entered at the point where additional module verification checks can be done. For example, you could add code here to determine if the modules to be copied are on the same channel. Additional user information can be provided to UCPY by entering the ZMCPY ALL and ZMPCY UP commands with the TOKEN parameter specified. See TPF Operations for more information about these commands.

UCPY is called by the ZMCPY ALL and ZMPCY UP commands.

Input

ECB data field EBW048-EBW052 contains the user token if the TOKEN parameter is specified when the ZMCPY ALL or ZMCPY UP command is entered. If the TOKEN parameter is not specified, this field is set to X'00'. If the TOKEN parameter is specified, the format of the field is ltttt where:

l
is the length of the token.

tttt
is the 1- to 4-character token.

Programming Considerations

Return Values

R2 contains the return code:

 0 
Indicates that the copy will be aborted.

Nonzero
Indicates that copy processing can continue.