QUERY ACCESSORS
Authorization
General User
Purpose
Use the QUERY ACCESSORS command to display information about current accessors of directory control directories.
To use the command, you must either have administrator authority, own the directories, or specify a directory ID to which you have directory control write authority.
Operands
- dirid
- identifies a directory control directory for which you want to display information. If you omit dirid, information is displayed for all your directory control directories. You can display information for another user's directory only if you have directory write authority to the directory or file pool administration authority. You can also use a file mode for the dirid if the directory is already accessed. For a more information on the dirid, see Naming Shared File System (SFS) Directories.
- filepoolid
- filepoolid:
- names the file pool for which the query is intended. The colon is optional. If you omit the directory ID, you can specify the file pool ID to establish the file pool for the query. If both filepoolid and dirid are omitted, the default file pool is used. The file pool ID should not be specified if the directory ID is specified because the directory ID includes the file pool ID.
Responses
QUERY ACCESSORS displays one line for each accessor of each directory specified. If information
for more than one directory is displayed, the information is returned in alphabetic order by
directory name.
Accessors Mode Directory Name
userid mode dirname
. . .
. . .
. . .
Note: The header is generated only if output is displayed at the terminal.
Where:
- userid
- is the ID of the user who has the directory accessed.
- mode
- is the status of the SFS directory: R/O (read-only) or R/W (read/write).
- dirname
- is the name of the directory being accessed.
Options
For more information on the Options, Usage Notes and Error Messages that apply to all operands of the QUERY command, see QUERY.
Usage Notes
- For this command, you are an accessor if you:
- Entered a CMS ACCESS command for the directory and have not yet released it.
- Used the CSL Open Directory for Files (DMSOPDIR) routine for the directory and have not yet issued the Close Directory (DMSCLDIR) for it.
- The QUERY ACCESSORS command will fail if it is issued from a work unit that is active.
- The QUERY ACCESSORS command will fail if you specify a file control directory.
- Error messages and the heading are suppressed if QUERY ACCESSORS is invoked:
- As a function from a program
- From a CMS exec file that has the &CONTROL NOMSG option in effect
- From an EXEC 2 exec where CMDCALL is not in effect
- From a REXX exec with ADDRESS COMMAND in effect
- A different version of this command is available for users with file pool administration authority. For more information, see the z/VM®: CMS File Pool Planning, Administration, and Operation.