CHGLIBL (Change Library List)

CHGLIBL Command syntax diagram

 

Purpose

The Change Library List (CHGLIBL) command changes the user's portion of the current job's library list 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 any other job's library list.

Restriction: The user must have *USE authority for all the specified libraries before the job's current library list is changed. If the user is not authorized to one of the libraries, the library list is not changed.

 

Optional Parameters

LIBL

Specifies the libraries that are placed in the user's portion of the current job's library list.

*SAME: The value does not change.

*NONE: No libraries are in the user's portion of the job's library list.

library-name: Specify the names of the libraries in the order in which they are searched. The number of libraries that can be specified ranges from 1 through 250.

CURLIB

Specifies the library that replaces the current library entry in the job's library list.

*SAME: The value does not change.

*CRTDFT: No library is in the current library entry of the library list. If objects are created into the current library, the QGPL library is used as the default current library.

library-name: Specify the name of the library that replaces the current library entry in the job's library list.

Example for CHGLIBL

CHGLIBL   LIBL(ULIB10  ULIB15  QGPL)

This command changes the user's portion of the current job's library list that existed before this command was entered. The new library list contains libraries ULIB10, ULIB15, and QGPL. They are searched in that order.

Error messages for CHGLIBL

*ESCAPE Messages

CPF2106

Library list not changed.

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.