Display user switches set to ON
Component: | BS2000 |
Functional area: | User management |
Domain: | USER-ADMINISTRATION |
Privileges: | STD-PROCESSING |
Function
The SHOW-USER-SWITCHES command displays the numbers of the user switches that are set to ON.
32 user switches are available to each user ID (switches numbered 0 to 31); each job running under that user ID has access to these switches. If a new user ID is created by a system administrator or if the system is newly generated, all user switches will be cleared (value OFF).
User switches are not cleared at job end (in contrast to job switches, see SHOW-JOB-SWITCHES command).
With SHOW-USER-SWITCHES the user switch settings for other user IDs can also be checked; however, only the user switch settings for the user’s own ID can be changed (MODIFY-USER-SWITCHES command).
Format
SHOW-USER-SWITCHES | Alias: SHUSW |
USER-IDENTIFICATION = *OWN / <name 1..8> | |
Operands
USER-IDENTIFICATION = *OWN / <name 1..8>
User ID whose user switches are to be checked.
USER-IDENTIFICATION = *OWN
The user switches for the user’s own ID are checked.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | CMD0202 | Syntax error | |
32 | EXC0041 | System error | |
64 | EXC0868 | User ID not found | |
130 | CMD2382 | User switches not available because the user ID is locked |
Example
/mod-user-sw on=(0,2,4) ——————————————————————————————————————————————— (1)
/show-user-sw
USER SWITCHES ON EQUAL-
0, 2, 4
/show-user-sw user-id=xyz ————————————————————————————————————————————— (2)
ALL USER SWITCHES SET OFF
(1) | Switches 0, 2 and 4 for the user’s own ID are set to ON. |
(2) | All switches for the user ID XYZ are set to OFF. |