| File | 81 |
|---|---|
| Op-Sys | BS2000/OSD |
| Statement | PROCESS
|
| Task | Query the user switches for a specified user ID.
When running in single-user mode, switches belonging to your own user ID can be reset, and the job switches of the same task can also be queried, set and reset. |
| Dictionary Field Name | F/L | Mu | DE | Remarks |
|---|---|---|---|---|
ERROR-CODE
|
N3 | |||
ERROR-TEXT
|
A58 | |||
NODE
|
N5 | D | ||
NODE-NAME
|
A16 | D | ||
SYSTEM-MESSAGE-CODE
|
A10 | |||
SYSTEM-CODE
|
B2 | |||
OPTION
|
A6 | D | Relevant when FUNCTION=WRITE.
|
|
SWITCH-NUMBERS
|
A64 | D | Relevant when FUNCTION=WRITE.
|
|
SWITCH-TYPE
|
A7 | D | ||
SWITCH-VALUES
|
A32 | D | ||
USERID
|
A8 | D | Relevant when FUNCTION=READ.
|
|
FUNCTION
|
A8 | D | Required. |
| Code | Text | BS2000/OSD |
|---|---|---|
| 530 | Access denied by Security Facility | X |
| 600 | Unknown function | X |
| 733 | User ID does not exist | X |
| 750 | Invalid operand within operand list | X |
| 755 | Invalid or no SWITCH-TYPE specified
|
X |
| 799 | Entire System Server internal error | X |
| 983 | Function not supported by multi-user mode | X |
| Field Name | Type/Length | Operating System |
|---|---|---|
FUNCTION
|
(A8) |
Specifies the function to be performed on the switches. Possible options:
| Option | Explanation |
|---|---|
READ
|
Read switch status. |
WRITE
|
Set switches given in field SWITCH-NUMBERS
according to OPTION field.
|
For restrictions, see the field SWITCH-TYPE.
| Field Name | Type/Length | Operating System |
|---|---|---|
OPTION
|
(A6) |
Operation when FUNCTION=WRITE:
| Operation | Explanation |
|---|---|
INVERT
|
Invert value of the switches given in the list. |
OFF
|
Set switches in the list to OFF.
|
ON
|
Set switches in the list to ON.
|
| Field Name | Type/Length | Operating System |
|---|---|---|
SWITCH-NUMBERS
|
(A64) |
Relevant when FUNCTION=WRITE. Gives the list of switches
to be handled. Each switch must be specified as a 2-digit number between
00 and 31. There is no delimiter between switch
numbers.
The value 031229 means switches 3,
12 and 29.
| Field Name | Type/Length | Operating System |
|---|---|---|
SWITCH-TYPE
|
(A7) |
Defines whether the switches are USER switches or
PROCESS switches. Query and modification of PROCESS
switches is only possible when the Entire System Server runs in single-user
mode. The same goes for WRITE of USER switches. In
multi-user mode, the function is executed by the Entire System Server server
task and the switches would be set there for the user ID of the server task.
| Field Name | Type/Length | Operating System |
|---|---|---|
SWITCH-VALUES
|
(A32) |
Returns the status of all switches. Possible values:
| Value | Explanation |
|---|---|
N
|
Switch is off. |
Y
|
Switch is on. |
| Field Name | Type/Length | Operating System |
|---|---|---|
USERID
|
(A8) |
Valid only when FUNCTION=READ and
SWITCH-TYPE=USER: user ID for which switches are to be read.