List Active Subsystems (QWCLASBS) API
Required Parameter Group:
| 1 | Qualified user space name | Input | Char(20) |
| 2 | Format name | Input | Char(8) |
| 3 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: No
The List Active Subsystems (QWCLASBS) API retrieves a list of active subsystems. QWCLASBS replaces any existing data. It does not add the new list to an existing one. To retrieve more information about active subsystems, see Retrieve Subsystem Information (QWDRSBSD) API.
Authorities and Locks
- User Space Authority
- *CHANGE
- Library Authority
- *EXECUTE
- User Space Lock
- *EXCLRD
Required Parameter Group
- Qualified user space name
- INPUT; CHAR(20)
The user space that receives the list, and the library in which it is located. The first 10 characters contain the user space name. The second 10 characters contain the library name. You can use these special values for the library name:
*CURLIB The job's current library *LIBL The library list
- Format name
- INPUT; CHAR(8)
The format to use for the list of active subsystems. You can use this format name:
SBSL0100 Basic subsystem list. See Format of the Generated List.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Format of the Generated List
The list of active subsystems that the QWCLASBS API returns into the user space consists of:
- A user area
- A generic header
- An input parameter section
- A list data section
The user area and generic header are described in User spaces. The remaining items are described in the following sections. For detailed descriptions of the fields in the tables, see Field Descriptions.
Input Parameter Section
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | User space name |
| 10 | A | CHAR(10) | User space library specified |
| 20 | 14 | CHAR(8) | Format name specified |
SBSL0100 Format
This section is repeated for each active subsystem.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | Subsystem description name |
| 10 | A | CHAR(10) | Subsystem description library name |
Field Descriptions
Format name specified. The format name as specified in the call to the API.
Subsystem description library name. The name of the library in which the active subsystem description resides.
Subsystem description name. The name of the active subsystem about which information is being returned.
User space library specified. The library name or special value specified in the call to this API.
User space name. The name of the user space that receives the list.
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPF3CF1 E | Error code parameter not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPF3C21 E | Format name &1 is not valid. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF8122 E | &8 damage on library &4. |
| CPF9801 E | Object &2 in library &3 not found. |
| CPF9802 E | Not authorized to object &2 in &3. |
| CPF9803 E | Cannot allocate object &2 in library &3. |
| CPF9807 E | One or more libraries in library list deleted. |
| CPF9808 E | Cannot allocate one or more libraries on library list. |
| CPF9810 E | Library &1 not found. |
| CPF9820 E | Not authorized to use library &1. |
| CPF9830 E | Cannot assign library &1. |
| CPF9838 E | User profile storage limit exceeded. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
API introduced: V2R1