QUERY Command

Use the QUERY command to review the status of your requests, or view and respond to CA VM:Backup messages. When you use the QUERY command, you bypass all user screens.

The command has the following syntax:

Query {"Parms"}


Parms:

  ENCrypt[ALL]
| MSG [(STACK]
| EDRSUP [(STACK]
| REQuests [( CONTents | STACK]
| STOrage [(STACK]

Definitions

ENCrypt [ALL]

Lists the default encryption algorithm name that would be used by CA VM:Backup if a security algorithm name is not specified, but a security key is specified in the exception file. ALL lists the names of all the available security algorithms this release of CA VM:Backup supports, and indicates whether the processor CA VM:Backup is running on provides hardware assist for the algorithm.

MSG [ ( STACK ]

Lets you view any outstanding messages that were sent to your user ID. Each message is identified by a reply identification number (reply ID) that you can use to respond to CA VM:Backup.

STACK specifies that the QUERY command response be placed in the requesting user ID's program stack in first-in, first-out (FIFO) order. If you use the STACK option, check for a nonzero return code, which indicates that there are no outstanding messages or requests.

EDRSUP [ ( STACK ]

Displays whether Enhanced Device Recognition is enabled or disabled.

STACK specifies that the QUERY command response be placed in the requesting user ID's program stack in first-in, first-out (FIFO) order.

REQuests [( CONTents | STACK ]

Displays information about active and pending restore requests, as follows:

Job name (RESTORE)
Job status (on hold, released, restarted, running, waiting, or ended)
Job type (restore)
Time the job was started
Number of domains processed so far
Job origin (submitting user ID)
Jobid
Certain processing options specified for the job (e for exclusive or p for priority)

Use the CONTENTS option to specify that CA VM:Backup is to list backup job content or restore job sources and targets.

Use the STACK option to specify that CA VM:Backup is to place the response from the QUERY command in the requesting user ID's program stack in first-in, first-out (FIFO) order. If you use the STACK option, check for a nonzero return code, which indicates that there are no outstanding messages or requests.

STOrage [(STACK]

Displays message 075I which includes the amount of virtual storage available to CA VM:Backup and the maximum amount of virtual storage that was used since CA VM:Backup was started. The STACK option specifies that CA VM:Backup is to place the response from the QUERY command in the requesting user ID program stack in first-in, first-out (FIFO) order.

Examples

To see whether CA VM:Backup has sent you any messages, enter:
```
vmbackup query msg
```
CA VM:Backup responds with:
```
REPLYID  MESSAGE
      1  DETACH 0291 WITHIN 5 MINUTES.
         VALID REPLIES: OK, CANCEL.
```
To respond, type reply followed by the reply identification number and either OK or CANCEL. OK indicates that you have detached the minidisk and CA VM:Backup can continue processing the restore. CANCEL indicates that you want to reject the request.

To cancel the detach request with reply identification number 1, enter:

vmbackup reply 1 cancel

CA VM:Backup responds with the following messages:

REPLY 1 CANCEL HAS BEEN ACCEPTED.

13:56 REQUEST 1 HAS BEEN CANCELED. 13:56 RESTORE JOB RESTORE HAS ENDED.

To display message 075I, enter:

vmbackup query storage

CA VM:Backup responds:

VMBSYS0075I Maximum virtual storage used since VM:Backup was started was 2.1M out of 1.0G bytes.