Domain: | USER-ADMINISTRATION |
Privileges: | STD-PROCESSING, USER-ADMINISTRATION |
This command displays terminal sets.
The system user administrator can display all the terminal sets.
Group administrators can only display the terminal sets for which SCOPE=*SYSTEM is specified together with the terminal sets of their own group and its members.
Users who do not possess administrator privileges may only view those terminal sets which are assigned to their own user ID.
This means that the number of terminal sets output and the scope of the accompanying information can be defined for each terminal set.
The number of terminal sets can be limited in two ways:
to certain classes or to certain owners within the classes.
on the basis of their attributes, i.e. they are selected if they satisfy one or more of the following criteria:
Terminal sets which are (not) used to protect a user ID
Terminal sets which are associated with no guard, any guard or a specific guard.
Terminal sets which contain a specific terminal. A fully or partially qualified terminal name can be explicitly defined or searched for using wildcards.
Terminal sets which contain a specific dialog terminal.
The selection can simulate a system access control with direct connection or a
terminal emulation.In the case of a terminal emulation, 3 protocols are available:
Check against the name of the dialog terminal assuming any privileged terminal emulation.
Check against the name of the dialog terminal assuming any terminal
emulation.Check against the name of the terminal emulation assuming any dialog
terminal.
The table below indicates the preconditions under which the terminal name is checked (+) or whether the condition is, by definition, not satisfied (-):
TYPE of terminal selection
TYPE definition of terminal entries
*STD
*NET-TERM-NAME
*APP-TERM-NAME
*NONE
+
+
+
*STD
+
+
-
*NET-TERMINAL-NAME
-
+
-
*APPLICATION-TERMINAL-NAME
-
-
+
The scope of the output information can be defined as follows:
Output of terminal sets with their attributes
The guard, user information, terminal and user ID attributes can be output individually. Terminal attribute output can be restricted to certain terminals.
By default, the user IDs which are protected by the terminal set are not output.Output list of terminal set names.
SHOW-TERMINAL-SET | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TERMINAL-SET-NAME = *ALL(...) / list-poss: <name 1..8>(...)
Specifies which terminal sets are to be displayed.
TERMINAL-SET-NAME = *ALL(...)
All terminal sets are displayed. Meaning of the SCOPE operand see TERMINAL-SET-NAME = <name 1..8>(...).
TERMINAL-SET-NAME = <name 1..8>(...)
Only terminal sets with the specified name are displayed.
SCOPE = *STD
For global user administrators, this specification has the same effect as SCOPE=*SYSTEM.
For group administrators it has the same effect as SCOPE=*GROUP(GROUP-ID=*OWN)..
SCOPE = *USER(USER-IDENTIFICATION = *ALL / *OWN / <name 1..8>)
Only terminal sets corresponding to the specified user ID are displayed.
SCOPE = *GROUP(GROUP-IDENTIFICATION = *ALL / *OWN / *UNIVERSAL / <name 1..8>)
Only terminal sets corresponding to the specified user group are displayed.
SCOPE = *SYSTEM
Publicly owned terminal sets are displayed.
SCOPE = *ANY
Terminal sets are displayed independently of their class or owner.
PUBSET = *ALL / list-poss(100): *HOME / <catid 1..4>
Pubset from whose user catalog terminal sets are displayed.
PUBSET = *ALL
Terminal sets from all local imported pubsets are displayed.
PUBSET = *HOME
Terminal sets from the home pubset are displayed.
PUBSET = <catid 1..4>
Terminal sets from the specified pubset are displayed.
SELECT =
Specifies selection criteria for the terminal sets that are to be displayed.
SELECT = *ALL
Terminal sets are displayed independently of their attributes.
SELECT = *BY-ATTRIBUTES(...)
Terminal sets are only displayed if they possess specific attributes.
ASSIGNED =
Specifies whether the terminal set is selected as a function of whether or not it is used to protect a user ID.
ASSIGNED = *ANY
Terminal sets are displayed independently of whether or not they are used to protect a user ID.
ASSIGNED = *YES
Only those terminal sets that are used to protect at least one user ID are displayed.
ASSIGNED = *NO
Only those terminal sets that are not used to protect a user ID are displayed.
ASSIGNED = *OWN
Only those terminal sets that are used to protect the user’s own user ID are displayed.
ASSIGNED = <name 1..8>
Only those terminal sets that are used to protect the specified user ID are displayed.
GUARD-NAME =
Specifies whether terminal sets are selected as a function of their association with a guard.
GUARD-NAME = *ANY
Terminal sets are displayed independently of whether or not they are associated with a guard.
GUARD-NAME = *YES
Only those terminal sets that are associated with a guard are displayed.
GUARD-NAME = *NONE
Only those terminal sets that are not associated with a guard are displayed.
GUARD-NAME = <filename 1..18 without-cat-gen-vers>
Only those terminal sets that are associated with the specified guard are displayed.
TERMINAL =
Specifies whether terminal sets are selected as a function of the terminal names they contain.
TERMINAL = *ANY
Terminal sets are displayed independently of the terminal names they contain.
TERMINAL = *BY-ENTRY-DEFINITION(...)
Terminal names that contain specific terminal names are selected.
PROCESSOR =
Processor part of the terminal name.
PROCESSOR = <c-string 1..16>
Terminal entries are selected by comparing their terminal names with a string pattern.
PROCESSOR = <name 1..8 with-wild(16)>
A specific terminal entry is selected by prespecifying its terminal name.
STATION =
Terminal part of terminal name.
STATION = <c-string 1..16>
Terminal entries are selected by comparing their terminal names with a string pattern.
STATION = <name 1..8 with-wild(16)>
A specific terminal entry is selected by prespecifying its terminal name.
TERMINAL = *BY-LOGON-ACCESS(...)
The terminal sets are selected on the basis of a simulated interactive mode access. Those terminal sets whose terminal entries contain a specific terminal are selected.
CHECK-MODE =
Specifies the examination protocol which is to be used. The logon can simulate a direct access or a terminal emulation.
CHECK-MODE = *NONE
Simulates a direct access. The terminal’s CHECK-MODE attribute is ignored. All terminal entries are recorded.
CHECK-MODE = *STD
Simulates a trusted terminal emulation. The terminal name is predefined. Terminal entries with CHECK-MODE=*STD or CHECK-MODE=*NET-TERMINAL-NAME are recorded.
CHECK-MODE = *NET-TERMINAL-NAME
Simulates a terminal emulation. The terminal name is predefined. Terminal entries with CHECK-MODE=*NET-TERMINAL-NAME are recorded.
CHECK-MODE = *APPLICATION-TERMINAL-NAME
Simulates a terminal emulation with a predefined name. Terminal entries with
CHECK-MODE=*APPLICATION-TERMINAL-NAME are recorded.
INFORMATION = *ATTRIBUTES(...) / *NAMES-ONLY
Determines the information which is to be output.
*ATTRIBUTES(...)
The following terminal set attributes are output.
GUARD-NAME = *YES / *NO
Specifies whether the associated guard is to be output.
USER-INFORMATION = *YES / *NO
Specifies whether the user information is to be output.
TERMINALS = *YES / *NO / *SELECTED
Specifies whether the terminal entries are to be output.
TERMINALS = *SELECTED
Only the terminals selected in the SELECT operand are output.
PROTECTED-USER-IDS = *NO / *YES
The user IDs that are protected by the terminal set are output.
*NAMES-ONLY
Only the names of the selected terminal set are output
OUTPUT =
Specifies where the information is to be output.
OUTPUT = *SYSOUT
The output is sent to SYSOUT.
OUTPUT = *SYSLST(...)
The output is sent to SYSLST.
SYSLST-NUMBER = *STD / <integer 0..99>
Output to SYSLST (specification *STD) or to a SYSLST file from the file set SYSLST01 to SYSLST99.
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command executed without errors | |
2 | 0 | SRM6001 | Command executed with a warning |
1 | SRM6010 | Syntax error in command | |
32 | SRM6020 | System error during command processing | |
64 | SRM6040 | Semantic error during command processing | |
130 | SRM6030 | Command cannot be executed at present time | |
64 | OPS0002 | Output of S variables interrupted | |
130 | OPS0001 | Not possible to output S variables | |
32 | CMD2009 | System error during output of S variables | |
130 | CMD2009 | OPS not available |
Example: Output of terminal set
|
Output in S variables
The command’s INFORMATION operand specifies the S variables to which values are assigned. The following specifications are possible for INFORMATION:
Notation in command | Condition in table |
INFORMATION = *ATTRIBUTES | 1 |
INFORMATION = *NAMES-ONLY | 2 |
Output information | Name of the S variable | T | Contents | Condition |
Name of terminal set | var(*LIST).NAME | S | <name 1..8> | 1 |
Owner of terminal set | var(*LIST).OWNER | S | <name 1..8> | 1 |
Class of terminal set | var(*LIST).SCOPE | S | *USER | 1 |
List of terminal sets | var(*LIST).TER-SET(*LIST).NAME | S | <name 1..8> | 2 |
List of owners | var(*LIST).TER-SET(*LIST).OWNER | S | <name 1..8> | 2 |
List of classes | var(*LIST).TER-SET(*LIST).SCOPE | S | *USER | 2 |
CatID of pubset | var(*LIST).PUBSET | S | <catid 1..4> | 1,2 |
Name of guard | var(*LIST).GUARD | S | <filename 1..18> | 1 |
User information | var(*LIST).USER-INFO | S | *NONE | 1 |
Sorting the terminal entries | var(*LIST).SORT-TER | S | *BY-PROCESSOR | 1 |
Processor name | var(*LIST).TER(*LIST).PROCESSOR | S | <name 1..16> | 1 |
Terminal name | var(*LIST).TER(*LIST).STATION | S | <name 1..16> | 1 |
Terminal type | var(*LIST).TER(*LIST).CHECK-MODE | S | *STD | 1 |
List of user IDs | var(*LIST).USER-ID(*LIST) | S | <name 1..8> | 1 |
Example: Output of terminal set in S variable
VAR(*LIST).NAME = 'TERMSET1' VAR(*LIST).SCOPE = '*GR' VAR(*LIST).OWNER = 'SYSUID' VAR(*LIST).PUBSET = 'B' VAR(*LIST).GUARD = '$TSOS.MYGUARD' VAR(*LIST).USER-INFO = '''This should protect one''''s UserID''' VAR(*LIST).SORT-TER = '*BY-PROCESSOR' VAR(*LIST).TER(*LIST).PROCESSOR = 'D016KR27' VAR(*LIST).TER(*LIST).STATION = 'DSB23571' VAR(*LIST).TER(*LIST).CHECK-MODE(*LIST) = '*STD' *END-OF-VAR VAR(*LIST).TER(*LIST).PROCESSOR = 'D017KR12' VAR(*LIST).TER(*LIST).STATION = 'DSB15837' VAR(*LIST).TER(*LIST).CHECK-MODE(*LIST) = '*NET-TER-NAME' *END-OF-VAR VAR(*LIST).TER(*LIST).PROCESSOR = 'D016ZE04' VAR(*LIST).TER(*LIST).STATION = '*' VAR(*LIST).TER(*LIST).CHECK-MODE(*LIST) = '*APP-TER-NAME' *END-OF-VAR VAR(*LIST).TER(*LIST).PROCESSOR = 'PGTD1563' VAR(*LIST).TER(*LIST).STATION = '$$$060//' VAR(*LIST).TER(*LIST).CHECK-MODE(*LIST) = '*NET-TER-NAME' VAR(*LIST).TER(*LIST).CHECK-MODE(*LIST) = '*APP-TER-NAME' *END-OF-VAR VAR(*LIST).USER-ID(*LIST) = 'SYSDUMP' VAR(*LIST).USER-ID(*LIST) = 'SYSPRIV' VAR(*LIST).USER-ID(*LIST) = 'SYSUSER' VAR(*LIST).USER-ID(*LIST) = 'TSOS' *END-OF-VAR