Previous Topic: ORDER CommandNext Topic: RELEASE Command

Operator Guide › Operator Commands › QUERY Command

QUERY Command

Use the QUERY command to display outstanding messages from CA VM:Backup or status information about active and pending jobs.

Query {"Parms"}

Parms:

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

You can view the status of all jobs submitted to CA VM:Backup; users can only view information concerning their own restore requests.

Use the CONTENTS option to specify that CA VM:Backup is to list backup job content or restore job sources and targets. For backup jobs, CA VM:Backup lists a maximum of 10 file spaces or minidisks contained in the backup; for restore jobs, CA VM:Backup lists a maximum of 10 paired sources and targets. This option allows you to distinguish between multiple end user restore jobs listed on the display.

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; this indicates that there are no outstanding messages or requests.

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 whether the processor CA VM:Backup is running on provides hardware assist for the algorithm.

MSG [(STACK]

Displays all outstanding messages. Each message is identified by a reply identification number that can be used to respond to CA VM:Backup, and the time the request was issued. STACK specifies 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; this indicates that there are no outstanding messages or requests.

If a user is being asked to detach a minidisk, the user can detach the minidisk, log off, or use the CANCEL command to cancel the job. If you have outstanding messages related to your own end user restore requests, you can use either the REPLY command to respond to the request or the CANCEL command to cancel the job.

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 jobs, as follows:

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