IBM MQ for z/OS stub programs

Before we can run a program written with IBM MQ for z/OS, we must link-edit it to the stub program supplied with IBM MQ for z/OS for the environment in which we are running the application.

The stub program provides the first stage of the processing of our calls into requests that IBM MQ for z/OS can process.

IBM MQ for z/OS supplies the following stub programs:

CSQBSTUB

Stub program for z/OS batch programs

CSQBRRSI

Stub program for z/OS batch programs using RRS by way of the MQI

CSQBRSTB

Stub program for z/OS batch programs using RRS directly

CSQCSTUB

Stub program for CICS programs

CSQQSTUB

Stub program for IMS programs

CSQXSTUB

Stub program for distributed queuing non-CICS exits

CSQASTUB

Stub program for data-conversion exits

Attention: If we use a stub program other than one listed for a specific environment, it might have unpredictable results. Note: If we use the CSQBRSTB stub program, link-edit with ATRSCSS from SYS1.CSSLIB. (SYS1.CSSLIB is also known as the Callable Services Library ). For more information about RRS see Transaction management and recoverable resource manager services.

Alternatively, we can dynamically call the stub from within your program. This technique is described in Dynamically calling the IBM MQ stub.

In IMS, you might also need to use a special language interface module that is supplied by IBM MQ.

Do not run applications that are link-edited with CSQBSTUB and CSQQSTUB in the same IMS MPP region. This can cause problems such as DFS3607I or CSQQ005E messages. The first MQCONN call in an address space determines which interface is used, therefore CSQQSTUB and CSQBSTUB transactions must run in different IMS message regions.

Parent topic: IBM MQ stub programs and library files