Previous Topic: QSTART CommandNext Topic: REBUILD Command

Reference Guide › Command Reference › QUERY Command

QUERY Command

Use the QUERY command to provide information about a number of monitored functions.

QUERY {"Parms"}

Parms:

  {"ParmA"} [(MANAGER mgrid]
| {"ParmB"} [("OptionB"]
| {"ParmC"} [("OptionC"]
| {"ParmD"} [("OptionD"]
| {"ParmE"}

ParmA:

  Alloc 
| Skeleton
| Subpool
| PROfiles

ParmB:

  ACcount [userid]
| Class [userid]
| FILEPOOL
| LOGMSG | DIALFAIL | LOGFAIL | NORULE | SYSTEM]
| Servant
| SFS
| SSI
| Version

OptionB:

[STACK [FIFO | LIFO]
[FIFO]
[LIFO]

Note: Options can be entered in any order.

ParmC:

  Hold [userid]
| Users [userid] 

OptionC:

[EXEC]
[STACK [FIFO | LIFO]]
[FIFO]
[LIFO]
[MANAGER mgrid]
[NOSFS]

Note: Options can be entered in any order.


ParmD:

  Password num
| PRfusers profname 

OptionD:

[EXEC]
[STACK [FIFO | LIFO]]
[FIFO]
[LIFO]
[MANAGER mgrid]

Note: Options can be entered in any order.


ParmE:

Managers [( [STACK [FIFO | LIFO]] [FIFO] [LIFO] [NOSFS]]
| WORKUNIT workunitnum

Definitions

ACcount [userid]

Displays account information for your user ID. If you specify a user ID, the account number for that user ID as specified in the directory entry is displayed.

Alloc

If you are a directory manager, displays how much disk space you can allocate and have allocated. Space allocations are shown in kilobytes (K), megabytes (M), gigabytes (G), or terabytes (T).

Class [userid]

Displays privilege class information for your user ID. If you specify a user ID, the CP privilege classes for that user ID as specified in the directory entry displays.

FILEPOOL

If you are an SFS administrator, lists all file pools that CA VM:Director manages, their status (available or unavailable), and their location (local or remote, or unknown if status is unavailable).

Hold [userid]

If you are a directory manager, for all user IDs on hold that you manage, displays the date each user directory entry was last updated and the amount of disk and SFS space that has been allocated to each user ID. Space allocations are shown in kilobytes (K), megabytes (M), gigabytes (G), terabytes (T), petabytes (P), or exabytes (E).

You can specify one or more user IDs for which to display this information. You can use pattern matching for userid.

Managers

Lists directory manager user IDs and the amount of disk and SFS space that has been allocated to each user ID. Space allocations are shown in kilobytes (K), megabytes (M), gigabytes (G), terabytes (T), petabytes (P), or exabytes (E).

Password num

If you are a directory manager, for all user IDs you manage, displays information about user IDs whose passwords have not been changed for the specified number of days and whose logon passwords are not expired. (A new user ID that has not been logged onto is considered to have an expired password because the user must change the password at first logon.)

This parameter provides information about only those user IDs that have a password history statement in their directory entries. This is useful for creating a CMS EXEC file that contains user IDs whose logon passwords are to be expired. You can prevent a logon password from being expired by removing the password history special comment (*PW=) from the directory entry; however, the user ID’s logon password can still be expired if you issue the EXPIRE command for that user ID.

PROfiles

Lists the filenames of all directory PROFILE definitions.

PRfusers profname

If you are a directory manager, lists the directory entries that use the directory profile profname. User IDs on hold are included in the list and are not distinguished from active users.

SErvant

Displays status information about the Servant Facility.

SFS

If you are an SFS manager, lists the file pools and the user storage groups within those file pools from which you can allocate space, and, for each storage group, the number of blocks you allocate by default, the number of blocks you have already allocated, and the maximum number of blocks you can allocate.

SSI

Displays the names of the member systems in a Single system Image complex, and the status of the product server virtual machine on each member.

Skeleton

If you are a directory manager, lists the skeleton files you can use to define new user IDs.

SUbpool

If you are a directory manager, lists the subpools you are authorized to use when allocating disk space, total disk space available to a subpool, unallocated disk space in a subpool, and the largest amount of contiguous free space available for allocation in a subpool. Space allocations are shown in kilobytes (K), megabytes (M), gigabytes (G), or terabytes (T).

Users [userid]

If you are a directory manager, for all active user IDs you manage, displays the date each user directory entry was last updated and the amount of disk and SFS space that has been allocated to each user ID. The date is in yy/mm/dd format. Space allocations are shown in kilobytes (K), megabytes (M), gigabytes (G), terabytes (T), petabytes (P), or exabytes (E).

You can specify one or more user IDs for which to display this information. You can use pattern matching for userid.

Version

Displays the version of CA VM:Director that is currently running on your system.

WORKUNIT workunitnum

Displays the workunit associated with a currently running asynchronous CA VM:Director command.

An asynchronous command is one that partially runs on a Servant machine. These commands are typically those that involve formatting a minidisk, which is a time consuming operation if the disk is large. Some common asynchronous commands are ADDMDISK, CHGMDISK, DELMDISK, DELENTRY, DUPMDISK, MDISKSCAN, RECLAIM, and various menu entries for the MANAGE and USER menus that add or delete minidisks.

If the Servant Facility is configured, the format commands run in a Servant machine. The original user who issued a command to create, delete, duplicate, or relocate a minidisk receives message 558I, telling the user that the formatting is in progress and specifies the workunit number. When the format is complete, the user receives a spool file describing the success or failure of the format operation.

CA VM:Director associates a number with each asynchronous activity. This number is the workunit. Using the workunit number from message 558I, the user can then issue the QUERY WORKUNIT workunitnum command to see if the formatting is complete or has failed.

[EXEC]

Writes query output to a CMS EXEC file on your A‑disk. You cannot use this option with the STACK option.

[MANAGER mgrid]

Specifies a directory manager to use in the query. An asterisk for mgrid, when this option is used with the HOLD, PASSWORD, PRFUSERS, and USERS parameters, indicates all directory managers.

[NOSFS]

Excludes SFS information from the results of the QUERY USERS command, displaying instead N/A for any SFS‑related information. This option speeds up execution of the QUERY command because gathering SFS data can be time consuming.

[STACK [FIFO | LIFO]]
[LIFO]
[FIFO]

Stacks the query output in your program stack in first‑in, first‑out (FIFO) or last‑in, first‑out (LIFO) order. You cannot use this option with the EXEC option.

Examples