WebSphere MQ - Early code
In previous versions and releases of WebSphere MQ, IBM recommended that you include the early code load modules in a library in the link list. This is no longer required, and we now recommend that you do not include early code libraries in the link list.
Put the libraries with the latest version, release, or maintenance level of the WebSphere MQ early code (which is loaded at system IPL) into the libraries used for the z/OS LPA, replacing older versions of these libraries. These libraries are specified in an LPALSTmm member of SYS1.PARMLIB.
The early code comprises the following load modules:
- CSQ3INI and CSQ3EPX in the library thqual.SCSQLINK
- CSQ3ECMX in the library thqual.SCSQSNLx, where x is your language letter.
WebSphere MQ includes a user modification that moves the contents of the thqual.SCSQSNLx library into the thqual.SCSQLINK and informs SMP/E. This user modification is called CSQ8ERLY.
When you have updated the early code in the LPA libraries, it is available from the next z/OS IPL (with the CLPA option) to all queue manager subsystems added during IPL from definitions in IEFSSNss members in SYS1.PARMLIB.
We can make it available immediately without an IPL for any new queue manager subsystem added subsequently by adding it to the LPA as follows:
- If you did not use CSQ8ERLY, issue these z/OS commands:
SETPROG LPA,ADD,MODNAME=(CSQ3INI,CSQ3EPX),DSNAME=thqual.SCSQLINK
SETPROG LPA,ADD,MODNAME=(CSQ3ECMX),DSNAME=thqual.SCSQSNLx- If you did use CSQ8ERLY, we can load the early code into the LPA using the following z/OS command:
SETPROG LPA,ADD,MASK=*,DSNAME=thqual.SCSQLINKIf you have applied maintenance, or you intend to restart a queue manager with a later version or release of WebSphere MQ, the early code can be made available to queue manager subsystems that are already defined,
provided the level of the early code when the z/OS system was IPLed was at least that of V5.3. To make it available, do this:.
- Add it to the LPA using z/OS SETPROG commands as described above.
- Stop the queue manager, using the WebSphere MQ command STOP QMGR.
- Ensure that the qmgr.REFRESH.QMGR security profile is set up.
- Refresh the early code for the queue manager using the WebSphere MQ command
REFRESH QMGR TYPE(EARLY)- Restart the queue manager, using the WebSphere MQ command START QMGR.
If the early code was below the V5.3 level, IPL the z/OS system (with the CLPA option) to make the updated early code available to existing queue manager subsystems. Thereafter, it can be updated and made available without an IPL.