ADDLIBLE (Add Library List Entry)

ADDLIBLE Command syntax diagram

 

Purpose

The Add Library List Entry (ADDLIBLE) command adds a library name to the user portion of the library list (after the current library list entry if it exists) for the process in which the command was entered. The user can specify whether the library is added to the beginning or the end of the library list. In addition to this, the user can specify whether the library is added before, after, or replaces an existing library in the library list.

 

Required Parameters

LIB

Specifies the name of the library added to the user portion of the library list. Up to 250 libraries may exist in the user portion of the library list. Only one library name is added at a time with this command.

 

Optional Parameters

POSITION

Specifies the position in the user portion of the library list where the library is added.

*FIRST: The library is inserted before the existing libraries in the user portion of the library list, after the current library, if it exists.

*LAST: The library is added to the end of the user portion of the library list.

Element 1: Library Position

*AFTER: The library specified on the LIB parameter is added to the user portion of the library list after the reference library specified on the POSITION parameter.

*BEFORE: The library specified on the LIB parameter is added to the user portion of the library list before the reference library specified on the POSITION parameter.

*REPLACE: The library is inserted into the library list in the position currently held by the reference library, and the reference library is removed from the list.

Element 2: Reference Library Name

reference-library-name: Specify the name of a library that already exists in the user portion of the library list. The library specified in the LIB parameter is added after this library, before this library, or replaces this library in the user portion of the library list.

Example for ADDLIBLE

ADDLIBLE  LIB(TESTLIB)  POSITION(*LAST)

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

Error messages for ADDLIBLE

*ESCAPE Messages

CPF2103

Library &1 already exists in library list.

CPF2106

Library list not changed.

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.