QUERY

Authorization

General User

Purpose

The following are the operands available with QUERY:

Options

General

The following options apply with all operands of the QUERY command:

STACK

causes the results of the QUERY command to be placed in the program stack instead of being displayed at the terminal. The information is stacked either FIFO (first in first out) or LIFO (last in first out). The default order is FIFO.

If a QUERY operand is unknown to CMS, CMS will pass it to CP rather than issue a -3 return code. The response from CP is then put in the program stack. If CP precedes the QUERY command, CMS does not stack the results. Error messages are displayed at the terminal and are not stacked.

FIFO

(first-in first-out) is the default option for STACK. FIFO causes the results of the QUERY command to be placed in the program stack instead of being displayed at the terminal. The information is stacked FIFO. The options STACK, STACK FIFO, and FIFO are all equivalent.

LIFO

(last-in first-out) causes the results of the QUERY command to be placed in the program stack rather than being displayed at the terminal. The information is stacked LIFO. This option is equivalent to STACK LIFO.

XEDIT

places the information in the file that is currently displayed. This option is only valid when issued from the XEDIT environment. The output replaces the information in the file starting with the current line and continues until the end of the output is reached. Remaining text in the file, if any, is unchanged. The edited file must either be variable length format, or fixed format with a logical record length (lrecl) of 190 for QUERY ALIAS, 165 for QUERY AUTHORITY, or 49 for QUERY FILEATTR.

The XEDIT option of the QUERY command can only be used with QUERY ALIAS, QUERY AUTHORITY, and QUERY FILEATTR.

Usage Notes

General

These notes apply with all operands of the QUERY command:

1. You may specify only one QUERY operand at a time.
2. If the implied CP (IMPCP) function is in effect and you enter a not valid QUERY operand, you may receive the message HCPCQG045E - userid NOT LOGGED ON.
3. If a not valid QUERY operand is specified from an exec, the implied CP (IMPCP) function is in effect, and no stack options are specified, then the return code is -3 and nothing is placed in the program stack.
4. When the STACK option is specified, the header is included in the program stack. If the information you query requires a response from CP and the response is longer than 8192 characters, nothing is stacked and you receive message DMSQRY627E and a return code of 88.
5. The language for QUERY command responses depends on the language used to enter the command and whether the command was translated. If the QUERY command is entered in American English (AMENG, which is always available), CMS responds in American English. If the command is entered in the current national language, or if the translation of the command is the same as American English, the response is displayed (or stacked) in the current national language. The language of the response is especially important for language dependent execs. For more information, see Using Translations in z/VM: CMS User's Guide.

Messages and Return Codes

These error messages may be returned by any of the QUERY operands.

• DMS002E File fn ft fm│dirname not found [RC=28]
• DMS003E Invalid option: option [RC=24]
• DMS006E No read/write {disk|filemode|filemode filemode} accessed [for fn ft]
• DMS014E Invalid function function [RC=24]
• DMS065E option option specified twice [RC=24]
• DMS066E option1 and option2 are conflicting options [RC=24]
• DMS069E {[Output]{filemode|disk}mode [(vdev)]|Directory dirname} not accessed [RC=28]
• DMS070E Invalid parameter parameter [RC=24]
• DMS099E CMS/DOS environment [not] active [RC=40]
• DMS104S Error nn reading SYSTEM LANGUAGE S from disk [RC=1nn]
• DMS105S Error nn writing file to XEDIT [RC=100]
• DMS109S Virtual storage capacity exceeded [RC=109]
• DMS149E Userid userid not valid [RC=32]
• DMS280E Application applid not active
• DMS386E Missing operand(s) [RC=24]
• DMS389E Invalid filepoolid: filepoolid [RC=24]
• DMS391E Unexpected operands(s): operand [RC=24]
• DMS525E Invalid PF Key number [RC=24]
• DMS618E NUCEXT failed [RC=nn]
• DMS621E Bad plist: message [RC=24]
• DMS627E Result is nnn bytes too large for CP command buffer [RC=88]
• DMS637E Missing nodeid for the AT operand [RC=24]
• DMS639E Error in NUCXLOAD routine; return code was nnn [RC=24]
• DMS639E Error in routine routine; return code was nnnn
• DMS647E Userid not specified for nickname in userid NAMES file [RC=32]
• DMS647E Localid not specified for userid at node in userid NAMES file [RC=32]
• DMS653E Error executing command rc=nn [RC=40]
• DMS688E XEDIT option only valid from XEDIT environment [RC=24]
• DMS689E File must be F-format nnn or V-format [RC=24]
• DMS918E No {virtual screens|windows} are defined [RC=4]
• DMS916E Window wname is not {displayed|hidden} [RC=4]
• DMS917E No windows are {displayed|hidden} [RC=4]
• DMS921E Virtual screen vname is not defined [RC=28]
• DMS926E Command is only valid {in CMS FULLSCREEN MODE|on a display terminal} [RC=88]
• DMS1082E No window qualifies as the window on top [RC=4]
• DMS1184E File fn ft fm│dirname not found or you are not authorized for it [RC=28]
• DMS1184E Directory dirname not found or you are not authorized for it [RC=28]
• DMS1184E File fn ft or directory dirname not found or you are not authorized for it [RC=28]
• DMS1184E File fn ft or directory dirid not found [RC=28]
• DMS1188E File mode fm not associated with a directory. [RC=74]
• DMS1209E Nickname nickname resolved to more than one userid; query can be performed only on one userid at a time [RC=88]
• DMS1210E Directory dirname not found [RC=28]
• DMS1222I No user defined NAMEDEF in effect
• DMS1223E There is no default file pool currently defined [RC=40]
• DMS1239E You are not authorized to issue this request on behalf of userid [RC=76]
• DMS1239E You are not authorized to issue this request for GROUP or ALL [RC=76]
• DMS2023E File pool filepool id does not support the requested QUERY command.
• DMS3711E User userid not enrolled in the file pool filepoolid [RC=40]

Additional system messages may be issued by this command. The reasons for these messages and their location are: