Previous Topic: RELEASE CommandNext Topic: RESTORE command

System Programmer Reference › Commands › REPLY command

REPLY command

Authorization: NONE

To allow CA VM:Backup operators and users to respond to messages or requests from CA VM:Backup, use the REPLY command.

This command has the following format:

REPly replyid {"Parms"}

Parms:

  CANCEL 
| FINISH 
| HOLD 
| OK 
| REJECT 
| RETRY 
| WAIT 
| volser

Definitions

replyid

Specifies the reply identification number, assigned by CA VM:Backup and displayed along with the message text when the QUERY MSG command is entered, of the request to which you are replying.

CANCEL

Tells CA VM:Backup to cancel a request because it cannot be fulfilled. If the request was to have a minidisk detached, CA VM:Backup skips the minidisk and the job continues. If the request was for a DASD volume, the job continues, but CA VM:Backup does not process the minidisks on the requested DASD volume.

FINISH

Tells CA VM:Backup to end a backup or MPC job which has completed but for which checkpoint files still exist on the CA VM:Tape service virtual machine. (The checkpoint files still exist because CA VM:Tape has become unavailable.) When you use this option, the job ends normally and CA VM:Backup erases its own checkpoint files, but the checkpoint files for the job remain on the CA VM:Tape service virtual machine. If you do not enter FINISH in this situation, CA VM:Backup waits until CA VM:Tape becomes available. Until then, the job status remains running.

HOLD

Tells CA VM:Backup to place on hold the job that is making the request.

OK

Indicates that a request (for example, to mount a tape) has been fulfilled, or that CA VM:Backup can do what it requested (for example, override a tape expiration date). OK tells CA VM:Backup to continue processing immediately.

REJECT

Indicates that a request cannot be fulfilled or that CA VM:Backup cannot do what it requested. CA VM:Backup does the following based on the purpose of the tape mount:

Backup or MPC (output tapes)

If a tape mount is rejected, reissues the request, specifying an alternate tape. Tape operator might be asked to remount the preceding tape so that CA VM:Backup can update the trailer label information with the correct volser.

Restore or MPC (input tapes)

If a tape copy is not available, puts the job on hold.

REINIT

Does not reinitialize the tape or expire the tape in the CA VM:Backup resource pool or CA VM:Tape TMC; continues with the next tape specified in the job.

RETRY

Indicates that a problem with the security system service virtual machine using the Surrogate facility has been corrected, and that CA VM:Backup should try the surrogate request again. Refer to the WAIT response for more information about responding to messages related to the Surrogate facility.

WAIT

Causes CA VM:Backup to ignore the configured maximum wait interval for the type of request. Instead, CA VM:Backup waits indefinitely for the request to be fulfilled. Use this response when the request cannot be fulfilled immediately or because the security system service virtual machine is not available. CA VM:Backup continues to send reminder messages until the operator or user responds with another command. Refer to the OK and REJECT parameters for information about responding to mount requests. Refer to the RETRY response for more information about responding to messages related to the Surrogate facility.

volser

Indicates the volser of an available tape that can be used to satisfy the request. The specified volser must be one that can be used with the indicated resource pool (that is, it must be of the same medium and density) or a scratch tape. To make sure that the correct tape is mounted, CA VM:Backup asks the tape operator to specify the volser twice.

Examples