LPALSTxx (LPA library list)

Use the LPALSTxx member to add your installation's read-only reenterable user programs to the pageable link pack area (PLPA). Placing programs in the PLPA allows them to be shared among users of the system.

Use one or more LPALSTxx members to concatenate your installation's program library data sets to SYS1.LPALIB. The system uses this concatenation, which is referred to as the LPALST concatenation, to build the PLPA.

The modules in the data sets that you define in LPALSTxx must meet the same requirements as the modules defined in SYS1.LPALIB. For example, these modules must be reentrant and executable.

During NIP, the system opens and concatenates each data set specified in LPALSTxx in the order in which the data set names are listed, starting with the first-specified LPALSTxx member.

The LPALST concatenation can have up to 255 extents. If you specify more data sets than the concatenation can contain, the system truncates the LPALST concatenation and issues messages that indicate which data sets were not included in the concatenation.

If one or more LPALSTxx members exist, and the system can open the specified data sets successfully, the system uses the LPALST concatenation to build the PLPA (during cold starts and IPLs that include the CLPA option). If a library named in LPALSTxx cannot be opened, message IEA712I is issued for that library and the system continues to build the LPA list concatenation with the other libraries named in LPALSTxx. If no LPALSTxx members exist, or none of the libraries named in LPALSTxx can be opened, the system builds the PLPA from only the modules named in SYS1.LPALIB.

The data sets in the LPALST do not have to be APF-authorized. However, any module in the pageable link pack area is treated by the system as though it came from an APF-authorized library. Ensure that you have properly protected any data set in the LPALST to avoid system security and integrity exposures, just as you would protect any APF-authorized library.

Data sets to be concatenated to SYS1.LPALIB must be cataloged in the system master catalog or a user catalog identified in the LPALSTxx member. (The system does not check OS CVOLs and only checks user catalogs when a data set name and pack VOLSER are listed in LPALSTxx.)

You cannot use PDSEs in the LPALST concatenation.

To identify which LPALSTxx members the system is to use, specify the member suffixes on the LPA parameter in IEASYSxx or as a parameter entered during IPL.