Previous Topic: ORDER CommandNext Topic: RELEASE Command

System Programmer Reference › Commands › QUERY Command

QUERY Command

Authorization: USER, SYSADMIN

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

This command has the following format:

Query {"Parms"}

Parms:

  ENCrypt[ALL]
| MSG [(STACK] 
| EDRsup [(STACK]
| OWNer filename filetype [(STACK]
| REQuests [(CONTents | STACK]
| STOrage [(STACK]
| BACkups [(STACK]

Definitions

ENCrypt [ALL]

Lists the default encryption algorithm name that CA VM:Backup uses 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. ALL also indicates whether the processor on which CA VM:Backup is running provides hardware assistance for the algorithm.

MSG [(STACK]

Displays all outstanding messages. Each message is identified by a reply identification number and the time the request was issued. You can use the reply identification number to respond to CA VM:Backup.

If a user is asked to detach a minidisk, the user can detach the minidisk, log off, or use the CANCEL command to cancel the job. If a CA VM:Backup operator has outstanding messages, the operator can use the REPLY command to respond to the request, or use the CANCEL command to cancel the job. 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. If you use the STACK option, check for a nonzero return code; this code indicates that there are no outstanding messages or requests.

EDRsup [(STACK]

Displays whether Enhanced Device Recognition Support is enabled. 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. If you use the STACK option, check for a nonzero return code; this code indicates that there are no outstanding messages or requests.

OWNer filename filetype [(STACK]

Displays the user ID that created the template, exception, or exclusion file identified by filename filetype. You cannot use pattern matching to specify filename or filetype. Valid filetypes are:

TEMPLATE

Job template

XCEPT

Exception

XCLUDE

Exclusion

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. If you use the STACK option, check for a nonzero return code; this code indicates that there are no outstanding messages or requests.

You must have SysAdmin authorization to specify OWNER. If a CA VM:Backup system administrator creates a template, exception, or exclusion file, the owner is VMBACKUP. If CA VM:Archiver creates a template, or exception file, the owner is the user ID of the CA VM:Archiver service virtual machine.

REQuests [(CONTents | STACK]

Displays information about active and pending jobs, as follows:

CA VM:Backup operators 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.

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. If you use the STACK option, check for a nonzero return code; this code 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.

BACkups [(STACK]

Displays the status of all the backup jobs that are running. Each job’s output begins with a line displaying the following:

This introductory line is followed by a pair of lines for each initialized stream. These line pairs describe the state of each initialized stream as follows:

First line of pair describing stream:
  • The domain currently being backed up
  • Elapsed processing time for that domain
  • Accumulated number of tape blocks written by the stream
Second line of pair describing stream:
  • Any tape mount elapsed time
  • Any Linker state information, if the Linker is waiting for a quiesce or a link to be performed. The linker state information includes the state (Linking or Quiescing), the target user ID and minidisk address and the elapsed time since the Linker has entered that state.

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. If you use the STACK option, check for a nonzero return code; this code indicates that there are no outstanding messages or requests.

Examples