Parameters

The parameters are:

xx: Specifies the one or two character suffix used to identify the LOADxx member that you want to process.
PARMLIB: Specifies that the system is to process the PARMLIB statements in the LOADxx member according to the filter parameters (HWNAME, LPARNAME, VMUSERID). For more information on filter parameters, see the LOADxx member in z/OS MVS Initialization and Tuning Reference.
IEASYM: Specifies that the system is to process the static system symbol definitions identified by the IEASYM statement of the LOADxx parmlib member located by the parmlib concatenation or by the optional dsname and volume specifications according to the filter parameters (HWNAME, LPARNAME, VMUSERID).The resulting system symbol table replaces the one that is in use by this system. No updates are sent to remote systems, so JES and ARM processing on remote systems on behalf of this system will continue to use the original system symbol table they received when this system was IPLed. If the IEASYM statement does not contain a valid suffix list, the system processes as if the member IEASYM?? had been specified, and issues a message that member IEASYM?? was not found. For more information on system symbols and the IEASYM statement, see the z/OS MVS Initialization and Tuning Reference.
DSNAME or DSN =dsn: Specifies the 1 to 44 character name of the data set where the LOADxx member resides.
The default is to locate the LOADxx member specified in a data set within the existing parmlib concatenation.
VOLUME or VOL or VOLSER =vol: Specifies the 1 to 6 character serial number identifier of the volume where the specified data set resides.
The default is to locate the data set by the volume information in the master catalog.

Note: After the parmlib changes, the DISPLAY PARMLIB command will no longer show either the master JCL or any errors that occurred during the IPL.

Example 1:

Dynamically change the parmlib concatenation

SETLOAD 02,PARMLIB

This command tells the system to process the PARMLIB statements in member LOAD02, which resides in a data set in the existing parmlib concatenation.

Example 2:

SETLOAD 03,PARMLIB,DSN=sys4.relson

This command tells the system to process the PARMLIB statements in member LOAD03. Member LOAD03 resides in the data set "sys4.relson" which is catalogued in the master catalog.

Example 3:

SETLOAD 04,PARMLIB,DSN=sys5.relson,VOL=123456

This command tells the system to process the PARMLIB statements in member LOAD04. Member LOAD04 resides in the data set "sys5.relson" which can be located on volume "123456."

Example 4:

SETLOAD 02,IEASYM,DSN=sys2.relson,VOL=123456

Start of change This command tells the system to process the IEASYM statement in member LOAD02. Member LOAD02 resides in the data set "sys2.relson" which can be located on volume "123456." These updates to the system symbol table will occur only on this system. End of change

Note: When a SETLOAD command is issued and fails, messages issued by IEFPRMLB (Logical parmlib Service) that contain jobname and stepname will contain Master's jobname and the stepname of the last step that ran under Master. This is because the SETLOAD command runs under Master but does not run as its own step. In this case the error is related to the SETLOAD processing and NOT the step whose name appears in the message.