Update the subsystem name table
The subsystem name table of z/OS, which is taken initially from the SYS1.PARMLIB member IEFSSNss, contains the definitions of formally defined z/OS subsystems. To define each WebSphere MQ subsystem, add an entry to this table, either by changing the IEFSSNss member of SYS1.PARMLIB, or, preferably, by using the z/OS command SETSSI.
If you use the SETSSI command, the change takes effect immediately, and there is no need to IPL your system. You should update SYS1.PARMLIB as well, so that the changes remain in effect after subsequent IPLs.
The SETSSI command to dynamically define a WebSphere MQ subsystem is:
SETSSI ADD,S=ssid,I=CSQ3INI,P='CSQ3EPX,cpf,scope'The corresponding information in IEFSSNss can be specified in one of two ways:
- The keyword parameter form of the WebSphere MQ subsystem definition in IEFSSNss. This is the recommended method.
SUBSYS SUBNAME(ssid) INITRTN(CSQ3INI) INITPARM('CSQ3EPX,cpf,scope')- The positional parameter form of the WebSphere MQ subsystem definition.
ssid,CSQ3INI,'CSQ3EPX,cpf,scope'
Do not mix the two forms in one IEFSSNss member. If different forms are required, use a separate IEFSSNss member for each type, adding the SSN operand of the new member to the IEASYSpp SYS1.PARMLIB member. To specify more than one SSN, use SSN=(aa,bb,...) in IEASYSpp.
In the examples above,
ssid
- The subsystem identifier. It can be up to four characters long. All characters must be alphanumeric (uppercase A through Z, 0 through 9), it must start with an alphabetic character. The queue manager will have the same name as the subsystem, therefore we can only use characters that are allowed for both z/OS subsystem names and WebSphere MQ object names.
cpf
- The command prefix string (see Defining command prefix strings for information about CPFs).
scope
- The system scope, used if you are running in a z/OS sysplex (see CPFs in a sysplex environment for information about system scope).
Figure 3 shows several examples of IEFSSNss statements.
Figure 3. Sample IEFSSNss statements for defining subsystemsCSQ1,CSQ3INI,'CSQ3EPX,+mqs1cpf,S' CSQ2,CSQ3INI,'CSQ3EPX,+mqs2cpf,S' CSQ3,CSQ3INI,'CSQ3EPX,++,S'Note:Once you have created objects in a subsystem, we cannot change the subsystem name or use the page sets from one subsystem in another subsystem. To do either of these, unload all the objects and messages from one subsystem and reload them into another.Table 4 gives a number of examples showing the associations of subsystem names and command prefix strings (CPFs), as defined by the statements in Figure 3.
Table 4. Subsystem name to CPF associations WebSphere MQ subsystem name CPF CSQ1 +mqs1cpf CSQ2 +mqs2cpf CSQ3 ++