Restore (POP) Library List (RSTLIBL)

The Restore (POP) Library List (RSTLIBL) command retrieves a previously saved library list from the library list save area and changes the job's library list to match it. It then deletes the saved library list from the save area. The command can restore the following portions of the library list: *USRLIBL, *CURLIB, *PRDLIB. The *SYSLIBL portion is not restored by

The *SYSLIBL (system portion) of the library list is NOT restored. However it is saved by the SAVLIBL command.

Parameters

Keyword	Description	Choices	Notes
LIBL	Library List save area	Qualified object name	Optional, Positional 1
	Qualifier 1: Library List save area	Name, USER, DFT, JOB, JOBNAME, *JOBNBR
	Qualifier 2: Library	Name, CURLIB, QTEMP*
RMV	Remove from LIBL save area	YES, NO	Optional, Positional 2
USRLIBL	Restore USRLIBL	YES, NO	Optional, Positional 3
CURLIB	Restore CURLIB	YES, NO	Optional, Positional 4
PRODLIBL	Restore PRODLIBL	YES, NO	Optional, Positional 5
SYSLIBL	Restore SYSLIBL (ignored)	*NO	Optional, Positional 6

Top

Library List save area (LIBL)

Specifies the name of the save area (user space) where a previously run SAVLIBL command saved the library list.

Qualifier 1: Library List save area

*USER: The save area is named the same as the user running the command.
*DFT: The default save area is used. As of this writing, the default save area is a User Space (*USRSPC) object named COZSAVLIBL in QTEMP.
*JOB or *JOBNAME: The job name is used as the save area name.
*JOBNBR: The save area is named QJOB999999 where QJOB is a constant and 999999 is the 6-digit job number.
name: Specify the name of the save area (user space) where the library list from which the library list is restored.

Remove from LIBL save area (RMV)

Specifies whether the library list is removed from the save area after it is restored.

*YES: The library list is removed from the save area after it is restored.
*NO: The library list remains in the save area and the active (last) library list point continues to point to it. A subsequent RSTLIBL will restore the same library list.

Restore USRLIBL (USRLIBL)

Specifies whether or not to restore the user-portion of the library list.

*YES: The user portion of the library list is restored.
*NO: The user portion of the library list is not restored.

Restore CURLIB (CURLIB)

Specifies whether or not to restore the current library.

*YES: The current library is restored to the library list.
*NO: The current library is not restored to the library list.

Restore PRODLIBL (PRODLIBL)

Specifies whether or not to restore the Product library names.

*YES: The product library names are restored to the library list.
*NO: The product library names are not restored to the library list.

Restore SYSLIBL (ignored) (SYSLIBL)

Specifies whether or not to restore the system-portion of the library list. It is a future objective to support SYSLIBL(*YES).

*NO: The system porition of the library list is not restored. This is the only possible value.