|
  
QUERY

.
QUERY
--------
|
-
SACDC
MDISK----{ userid } {[ vaddr ]}
---------{ * } {[ * ])
DLINK----{ userid } {[ vaddr ]}
---------{ * } {[ * ])
SACDEV---{ userid } {[ vaddr ]}
---------{ * } {[ * ])
MDDLINK--{ userid } vaddr
---------{ * }
MDSACDEV { userid } vaddr
---------{ * }
IGNORE---Userid
SAFADMIN {[USER] Userid }
---------{ACIGROUP Acigroup}
|
Purpose
Use the QUERY command to interrogate the SafeAccess database.
Authorization
SACDC - None
Other subcommands -SAFADMIN or Issuer must be owner of object(s) queried.
Subcommands
SACDC
|
Display current data collection settings.
|
|
|
|
MDISK
|
Display information for an MDISK record. A single or all of a user's MDISK records may be displayed.
|
|
|
|
DLINK
|
Display information for a DLINK record. A single or all of a user's DLINK records may be displayed.
|
|
|
|
SACDEV
|
Display information for a linked SafeAccess MDISK. Can show a single or all of a user's MDISK records.
|
|
|
|
MDDLINK
|
Shows all of the DLINK records that point to a particular MDISK.
|
|
|
|
MDSACDEV
|
Shows all of the SDEVs that point to a particular MDISK.
|
Parameters
Useridor *
|
The userid of the owner of the object. The issuer may use * to indicate their own userid.
|
|
|
|
Vaddr *
|
The virtual address of the object. Use * to indicate all virtual addresses.
|
Responses
SACDC
A list of SACDC items and the current settings.
MDISK, DLINK, SACDEV, MDDLINK, MDSDEV
One or more lines containing:
Userid1 vdev1 mode1 userid2 vdev2 label cyl type volser size mode2 [RPASS readpass [WPASS writepass [ MPASS multpass ]]] sfsdir
Userid1
|
Userid from command
|
|
|
|
Vdev1
|
Vdev of device for userid1
|
|
|
|
Mode1
|
Linkmode of userid1/vdev1
|
|
|
|
Userid2
|
Owner of MDISK. This will be userid1 for QUERY MDISK. For all others, it is the owner of MDISK that userid1/vdev1 points to
|
|
|
|
Vdev2
|
Vdev of device for userid2
|
|
|
|
Label
|
CMS Label, encoded with \b and \\ as documented in the ADD or MODIFY commands
|
|
|
|
Cyl
|
Number of cylinders or FBA blocks from the CMS point of view
|
|
|
|
Type
|
Device type
|
|
|
|
Volser
|
CP Volser
|
|
|
|
Size
|
CP device size in cylinders or FBA blocks
|
|
|
|
Mode2
|
Linkmode from MDISK record
|
|
|
|
RPASS readpass
|
Read password from MDISK record
|
WPASS writepass
|
Write password from MDISK record
|
|
|
|
MPASS multpass
|
Multiple password from MDISK record
|
|
|
|
Sfsdir
|
SFS Directory containing contents of MDISK.
|
Note: SafeAccess blanks out all password fields for issuers that do not have SAFADMIN authorization.
Return Codes
Return Code
|
Meaning
|
0
|
Request successful
|
8
|
Item not found in database
|
16
|
Not authorized
|
100
|
Missing parameter
|
101
|
Invalid parameter
|
344
|
SafeAccess server not running
|
Usage Notes
- The CMS Component does not have to be initialized on the virtual machine issuing the QUERY command.
- QUERY SACDEV always has the minidisk passwords removed.
Examples
- To determine what SACDISKs user LILY has:
safeacc query mdisk LILY
LILY 002 MR LILY 002 LILY\b\b 12 3390 CPVOL1 12 MR RPASS READ WPASS WRITE MPASS MULT HOMER:LILY.MD500
This shows that LILY has one SACDISK at address 500. It has a label of "LILY", a size of 12, is on a 3390, is on CP volume CPVOL1, has a linkmode of MR, has passwords of: READ, WRITE, MULT, and is contained in directory "HOMER:LILY.MD500"
  
|