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.

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.

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.

Examples

ADDLIBLE  LIB(TESTLIB)  POSITION(*LAST)

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

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.