Add Library List Entry (ADDLIBLE)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes

The Add Library List Entry (ADDLIBLE) command adds a library name to the user portion of the library list for the current thread. The user portion is the last portion of the library list. It follows the system portion and, if they exist, any product libraries and the current library entry. You can specify where the library should be placed in the user portion of the library list.

Top

Parameters

Keyword	Description	Choices	Notes
LIB	Library	Name	Required, Positional 1
POSITION	Library list position	Single values: FIRST, LAST Other values: Element list	Optional, Positional 2
	Element 1: List position	AFTER, BEFORE, *REPLACE
	Element 2: Reference library	Name

Top

Library (LIB)

Specifies the library to be added to the user portion of the library list for the current thread. A maximum of 250 libraries may exist in the user portion of the library list. Only one library name is added at a time with this command.

This is a required parameter.

name: Specify the name of the library to be added to the user portion of the library list for the current thread.

Top

Library list position (POSITION)

Specifies the position in the user portion of the library list for the current thread where the library is inserted. This parameter can be specified as a single value or as a list of two elements.

Single values

*FIRST: The library is inserted in front of the libraries existing in the user portion of the library list for the current thread.
*LAST: The library is added to the end of the user portion of the library list for the current thread.

Element 1: List position

*AFTER: The library specified for the Library (LIB) parameter is added to the user portion of the library list for the current thread after the reference library (element 2).
*BEFORE: The library specified for the LIB parameter is added to the user portion of the library list for the current thread before the reference library (element 2).
*REPLACE: The library specified for the LIB parameter is inserted into the library list for the current thread in the position currently held by the reference library (element 2) and the reference library is then removed from the list.

Element 2: Reference library

name: Specify the name of the library to be the reference library when *AFTER, *BEFORE, or *REPLACE is specified for the list position (element 1). This library must exist in the user portion of the library list for the current thread.

Top

Examples

ADDLIBLE  LIB(TESTLIB)  POSITION(*LAST)

This command adds the library TESTLIB to the end of the user portion of the library list.

Top

Error messages

*ESCAPE Messages

CPF2103: Library &1 already exists in library list.
CPF2106: Library list not available.
CPF2110: Library &1 not found.
CPF2113: Cannot allocate library &1.
CPF2118: Library &1 not added.
CPF2149: Library &1 was not found in the user library list.
CPF2176: Library &1 damaged.
CPF2182: Not authorized to library &1.

Top