Syntax format of the LPA statements

Syntax Format of LPA ADD:

 LPA ADD
      MODNAME(modname,...) | MASK(mask)
      DSNAME(dsname | LNKLST)
      [FIXED|PAGEABLE]
      [PAGEPROTPAGE]
      [,SVCNUMDEC(svcnum) | ,SVCNUMDEC(svcnum,routcode)] 
      [,ADDALIAS | ,NOADDALIAS]

Syntax Format of LPA DELETE:

 LPA DELETE
      MODNAME(modname,...)
      FORCE(YES)
      [CURRENT|OLDEST]

Syntax Format of LPA CSAMIN:

 LPA CSAMIN
      (below,above)

LPA

Statement type indicating that an action may be performed on LPA.

Note: LPA ADD and LPA DELETE cannot be used during IPL. They are for use in PROGxx members pointed to by SET PROG=xx after IPL.

ADD

Specifies that one or more modules is to be added to LPA.

Default Value: None

DELETE

Specifies that one or more modules is to be deleted from LPA. Only modules added to LPA after an IPL are eligible for dynamic deletion.

Default Value: None

CSAMIN

Specifies the minimum amount of CSA and ECSA that must remain after a module is added to LPA. If the requested ADD operation would reduce the CSA or ECSA below the defined minimum, the system rejects the operation.

Modules added to the system via dynamic LPA processing are placed into CSA or ECSA storage. Therefore, it is important to ensure that the system CSA and ECSA sizes are adequately defined to handle the additional consumption of CSA storage resulting from the issuance of the dynamic LPA request. Further protection can be gained through the use of the CSADMIN parameter.

Default Value: (0,0)

below

The minimum amount of below-16M CSA storage that must remain after the ADD operation, expressed in the format n|nK|nM, where n is a decimal number, nK is n*1024, and nM is n*1024*1024,

above

The minimum amount of above-16M CSA storage that must remain after the ADD operation, expressed in the format n|nK|nM, where n is a decimal number, nK is n*1024, and nM is n*1024*1024,

MODNAME(modname,...,modname)

modname is the 1-8 character LPA module name or alias. If the last character of the modname is "*", it will be treated as X'C0'. This lets you directly specify the name of a load module that ends with that nonprintable character. Wildcard characters are not supported within modname. A maximum of 128 module names can be provided. MOD and MODULE can be used as synonyms of MODNAME.

Default Value: If MODNAME is not specified, MASK must be specified.

MASK(mask)

mask is the 1-8 character mask that is to be applied to all the members of the specified data set. It can contain wildcard characters "*" and "?" and all members that match will be processed.

Default Value: If MASK is not specified, MODNAME must be specified.

DSNAME(dsname)

dsname is the 1-44 character data set name that contains the module(s) or alias(es). When MODNAME is specified, you can specify DSNAME(LNKLST) if you want the system to search the lnklst instead of a particular data set. LNK, LNKLIST, LINKLST or LINKLIST can be specified as an alternative to LNKLST. The data set must be cataloged. It may be allocated as a PDS or PDSE program library.

The attribute of the CSA for each module is assigned as OWNER=SYSTEM. DSN, LIB, and LIBRARY can be used as synonyms of DSNAME.

Default Value: None

FIXED | PAGEABLE

Indicates whether the modules are to be placed in fixed or pageable storage. PAGE can be used as a synonym of PAGEABLE.

Default Value: PAGEABLE

PAGEPROTPAGE

Indicates whether or not to page protect the modules entirely. The default is to page protect the entire module. Be aware that when that default is taken, storage utilization for the modules increases, as each module gets allocated a number of whole pages (so that they can be page protected), rather than just the amount of storage that is truly necessary to load the module.

When PAGEPROTPAGE is requested, however, only the whole pages within each load module are page protected, which keeps the storage use to the minimum amount but which makes it possible that a storage overlay of the beginning or end of the load module can occur.

PPPAGE and PPP can be used as synonyms of PAGEPROTPAGE.

Default Value: Page protect entire modules.

SVCNUMDEC=svcnum | SVCNUMDEC=(svcnum,routcode)

SVCNUMDEC, or SVCDEC, identifies the entry within the SVC Table to update. The SVC number, svcnum, can be from 0 - 255. For an extended SVC (109, 116, 122, 137), you must specify the routcode, which is the extended SVC routing code. The routcode must be within the range that is supported by the SVC. For example, for SVC 109, the routcode must be from 0 - 255. The routcode for other extended SVC number depends on the release of z/OS®. Use the SVCNUMDEC function for updating already-defined SVC Table entries. Do not use it to create new entries, as you might not get all of the attributes that you need.

Default Value: This is not an SVC routine. The SVC table is not updated.

ADDALIAS | NOADDALIAS

ADDALIAS, or ALIAS, indicates to process provided names and aliases of the provided names. NOADDALIAS, or NOALIAS, indicates to process only the names provided. You can use NOADDALIAS to override the default values set by DEFAULTS LPA ADDALIAS.

Default Value: NOADDALIAS, or the value set by DEFAULTS LPA ADDALIAS | NOADDALIAS.

FORCE(YES)

Confirms that the delete requestor understands the ramifications of deleting a module from LPA, when the system can have no knowledge of whether any code is currently executing within the specified module.

Default Value: None. Required parameter.

CURRENT | OLDEST

CURRENT specifies that the current copy is to be deleted. OLDEST specifies that the oldest dynamic copy other than the current one is to be deleted. CUR can be used as a synonym of CURRENT. OLD can be used as a synonym of OLDEST.

Default Value: CURRENT