Change Library List (CHGLIBL)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Change Library List (CHGLIBL) command changes the user portion of the library list for the current thread with the list of libraries specified by the user. This command does not affect the system portion of the library list, nor does it affect library list for any other thread.
Restrictions: You must have use (*USE) authority for all the specified libraries before the library list is changed. If you are not authorized to one or more of the libraries, the library list is not changed.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| LIBL | Libraries for current thread | Single values: *SAME, *NONE Other values (up to 250 repetitions): Name |
Optional, Positional 1 |
| CURLIB | Current library | Name, *SAME, *CRTDFT | Optional, Positional 2 |
| Top |
Libraries for current thread (LIBL)
Specifies the libraries that are placed in the user portion of the library list for the current thread. This parameter can be specified as a single value or as a list of one or more names.
Single values
- *SAME
- The libraries that are in the user portion of the library list for the current thread are not changed.
- *NONE
- No libraries are in the user portion of the library list for the current thread.
Other values
- name
- Specify the names of the libraries to be added to the user portion of the library list for the current thread in the order in which they are to be searched. Up to 250 names can be specified.
| Top |
Current library (CURLIB)
Specifies the library to replace the current library in the library list for the current thread.
- *SAME
- The current library in the library list for the current thread is not changed.
- *CRTDFT
- No library should be in the current entry in the library list for the current thread. If objects are created into the current library, the QGPL library is used as the default current library.
- name
- Specify the name of the library that replaces the current library entry in the library list for the current thread.
| Top |
Examples
CHGLIBL LIBL(ULIB10 ULIB15 QGPL)
This command changes the user portion of the library list for the current thread. The new library list contains libraries ULIB10, ULIB15, and QGPL. They are searched in that order.
| Top |
Error messages
*ESCAPE Messages
- CPF2106
- Library list not available.
- CPF2110
- Library &1 not found.
- CPF2113
- Cannot allocate library &1.
- CPF2176
- Library &1 damaged.
- CPF2182
- Not authorized to library &1.
- CPF2184
- Library list not replaced.
| Top |