Domain: | SECURITY-ADMINISTRATION |
Privileges: | GUARD-ADMINISTRATION, TSOS |
System administrators and guard administrators can use this function to display user and group IDs from a user ID guard.
SHOW-DEFAULT-PROTECTION-UID (SHO-DEF-PRO-U) | ||||||||||||||||||||
| ||||||||||||||||||||
GUARD-NAME = <filename 1..24 without-gen-vers with-wild(40)>
This operand designates the name of the guard of type DEFPUID whose user and user group IDs are to be displayed. The length of the name without wildcards, catalog ID and user ID must not exceed 8 characters.
If wildcards are used in the name of the guard, then a single command displays the contents of multiple guards.
Only a guard administrator can specify wildcards in the user ID.
The specification of the system default ID in the guard name, e.g. $<filename> or $.<filename>, is not supported.
INFORMATION=
Specifies the extent of the information which is to be output for each guard.
INFORMATION = *USER-ID-LIST
The user IDs and user groups are displayed.
INFORMATION = GUARD-NAMES-ONLY
Only the names of the guards are displayed.
OUTPUT = list-poss(2):
This operand defines the destination of the output.
OUTPUT = *SYSOUT
Output is directed to the terminal if the command was issued in interactive mode. In batch mode, the output destination depends on the specifications in the job.
OUTPUT = *SYSLST(...)
Output is directed to the system file SYSLST.
SYSLST-NUMBER = *STD
Output is directed to the system file SYSLST.
SYSLST-NUMBER = <integer 1..99>
Two-digit number nn used to form the file name SYSLSTnn.
Output layout (INFORMATION = *USER-ID-LIST)
------------------------------------------------------------------------------
GUARD :ABCD:$TSOS.SYS.LIST DEFAULT PROTECTION UID
------------------------------------------------------------------------------
USER DUSR
NUSR
SUSR
GROUP GRP1
SYSTEM
------------------------------------------------------------------------------
GUARD :ABCD:$TSOS.USR.LIST DEFAULT PROTECTION UID
------------------------------------------------------------------------------
USER AUSR
BUSR
------------------------------------------------------------------------------
GUARDS SELECTED: 2 END OF DISPLAY
Output layout (INFORMATION = *GUARD-NAMES-ONLY)
------------------------------------------------------------------------------ LIST OF USER ID GUARDS DEFAULT PROTECTION UID ------------------------------------------------------------------------------ :ABCD:$TSOS.SYS.LIST :ABCD:$TSOS.USR.LIST ------------------------------------------------------------------------------ GUARDS SELECTED: 2 END OF DISPLAY
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command successfully executed | |
1 | DEF3100 | An incorrect operand value was detected. | |
32 | DEF3200 | An internal error has occurred. A SERSLOG entry has been generated to permit detailed analysis. | |
64 | DEF3302 | The user is not authorized to execute the function. | |
64 | DEF3306 | A specified guard is not of the required guard type. | |
64 | DEF3308 | A user ID is unknown. | |
64 | DEF3309 | Remote file access not supported. | |
64 | DEF3313 | A specified public volume set is not available. | |
64 | DEF3314 | Error in MRS communications resources. | |
64 | DEF3315 | A specified public volume set is not known in the local GUARDS administration. | |
64 | DEF3400 | The specified user ID guard does not exist. | |
64 | DEF3401 | No user ID corresponds to the selection criteria. | |
64 | DEF3402 | No user ID guard corresponds to the selection criteria. | |
128 | DEF3900 | There is no longer sufficient system storage space available. | |
128 | DEF3901 | A guard which has to be processed is currently locked by another task and cannot be processed at the present time. | |
128 | DEF3902 | A guard is temporarily unavailable because the GUARDS catalog is being changed or a master change is taking place in the computer network. | |
128 | OPS0002 | Output of S variables has been aborted | |
130 | OPS0001 | It was not possible to output the S variables | |
32 | CMD2009 | System error during output of S variables |
Output in S variables
The command’s INFORMATION operand is used to determine which of the S variables are to be assigned values. The following specifications are possible for INFORMATION:
Notation in command | Abbreviated notation in table |
INFORMATION = *USER-ID-LIST | 1 |
INFORMATION = *NAMES-ONLY | 2 |
Output information | Name of the S variable | T | Contents | Condition |
Name of the user ID guard | VAR(*LIST).GUARD-NAME | S | <filename 1.24> | 1, 2 |
Specification of whether the ID | VAR(*LIST).ID(*LIST).TYPE | S | *USER | 1 |
ID | VAR(*LIST).ID(*LIST).ID | S | *UNIVERS | 1 |