User Exit Reference › DISKCOPY User Exit › Description

Description

Because of the requirements for issuing macro primitives, the DISKCOPY user exit cannot be written in Assembler. It must be coded in REXX or EXEC2.

The DISKCOPY user exit uses CA VM:Secure macro primitives to communicate with the user or servant user ID. The user or servant user ID is the user ID where the minidisk or the SFS directory is accessed. The CA VM:Secure macro primitives most likely to be used are:

• USER EXECUTE or SERVANT EXECUTE—Issues a command on the user or servant virtual machine. The command text arguments that follow are issued on the indicated machine using CMSCALL.
• USER STACK or SERVANT STACK—Places data that you will need later on, such as for a subsequent command, on the user or servant virtual machine program stack. The etx arguments that follow are stacked in LIFO order on the appropriate program stack.
• USER READ or SERVANT READ—Causes the data that exists on the user or servant virtual machine stack to be read to storage on the user or servant virtual machine.

Use these primitives to manipulate the data in the user or servant program stack. To use any of these primitives, precede it with the token TEST. This token allows the primitive to pass a nonzero return code back to the exit. The sample (prototype) user exit contains examples of the use of these primitives.