Placing the subsystem member entry in IMS.PROCLIB
Each SSM entry in IMS.PROCLIB defines a connection from an IMS region to a different queue manager.
To name an SSM member, concatenate the value (one to four alphanumeric characters) of the IMSID field of the IMS IMSCTRL macro with any name (one to four alphanumeric characters) defined by your site.
One SSM member can be shared by all the IMS regions, or a specific member can be defined for each region. This member contains as many entries as there are connections to external subsystems. Each entry is an 80-character record.
Positional parameters
SSN,LIT,ESMT,RTT,REO,CRCwhere:
- SSN
- Specifies the WebSphere MQ queue manager name. It is required, and must contain one through four characters.
- LIT
- Specifies the language interface token (LIT) supplied to IMS. This field is required, its value must match one in the CSQQDEFV module.
- ESMT
- Specifies the external subsystem module table (ESMT). This table specifies which attachment modules must be loaded by IMS. CSQQESMT is the required value for this field.
- RTT
- This option is not supported by WebSphere MQ.
- REO
- Specifies the region error option (REO) to be used if an IMS application references a non-operational external subsystem or if resources are unavailable at create thread time. This field is optional and contains a single character, which can be:
- R
- Passes a return code to the application, indicating that the request for WebSphere MQ services failed.
- Q
- Ends the application with an abend code U3051, backs out activity to the last commit point, does a PSTOP of the transaction, and requeues the input message. This option only applies when an IMS application tries to reference a non-operational external subsystem or if the resources are unavailable at create thread time.
WebSphere MQ completion and reason codes are returned to the application if the WebSphere MQ problem occurs while WebSphere MQ is processing the request; that is, after the adapter has passed the request on to WebSphere MQ.
- A
- Ends the application with an abend code of U3047 and discards the input message. This option only applies when an IMS application references a non-operational external subsystem or if the resources are unavailable at create thread time.
WebSphere MQ completion and reason codes are returned to the application if the WebSphere MQ problem occurs while WebSphere MQ is processing the request; that is, after the adapter has passed the request on to WebSphere MQ.
- CRC
- This option can be specified but is not used by WebSphere MQ.
CSQ1,MQM1,CSQQESMT,,R,
CSQ1 The default subsystem name as supplied with WebSphere MQ. We can change this to suit your installation. MQM1 The default LIT as supplied in CSQQDEFV. CSQQESMT The external subsystem module name. You must use this value. R REO option.
Keyword parameters
WebSphere MQ parameters can be specified in keyword format; to do this specify
SST=DB2. Other parameters are as described in Positional parameters, and shown in the following example: