QUERY ACCESSORS

Read syntax diagramSkip visual syntax diagram Query ACCESSORs 1dirid2filepoolid:(STACKFIFOLIFOFIFOLIFO)
Notes:
  • 1 The default file pool is used.
  • 2 If dirid is not specified, information for all your directory control directories is displayed.

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

  1. 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.
  2. The QUERY ACCESSORS command will fail if it is issued from a work unit that is active.
  3. The QUERY ACCESSORS command will fail if you specify a file control directory.
  4. 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
  5. 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.