Building z/OS batch applications

To build an application for WebSphere MQ for z/OS that runs under z/OS batch, create job control language (JCL) that performs these tasks:

  1. Compile (or assemble) the program to produce object code. The JCL for your compilation must include SYSLIB statements that make the product data definition files available to the compiler. The data definitions are supplied in the following WebSphere MQ for z/OS libraries:
  2. Link-edit the object code created in step 1 (or step 2 for a C application) to produce a load module. When you link-edit the code, you must include one of the WebSphere MQ for z/OS batch stub programs (CSQBSTUB or one of the RRS stub programs: CSQBRRSI or CSQBRSTB).
    CSQBSTUB
    single-phase commit provided by WebSphere MQ for z/OS
    CSQBRRSI
    two-phase commit provided by RRS using the MQI
    CSQBRSTB
    two-phase commit provided by RRS directly
    Note:
    If you use CSQBRSTB, you must also link-edit your application with ATRSCSS from SYS1.CSSLIB. Figure 20 and Figure 21 show fragments of JCL to do this. The stubs are language-independent and are supplied in library thlqual.SCSQLOAD.
  3. Store the load module in an application load library.

Figure 20. Fragments of JCL to link-edit the object module in the batch environment, using single-phase commit

  ·
  ·
  ·
//* //* WEBSPHERE MQ FOR Z/OS LIBRARY CONTAINING BATCH STUB //* //CSQSTUB DD DSN=++HLQ.MQM100++.SCSQLOAD,DISP=SHR //*
  ·
  ·
  ·
//SYSIN DD * INCLUDE CSQSTUB(CSQBSTUB)
  ·
  ·
  ·
/*

Figure 21. Fragments of JCL to link-edit the object module in the batch environment, using two-phase commit

  ·
  ·
  ·
//* //* WEBSPHERE MQ FOR Z/OS LIBRARY CONTAINING BATCH STUB //* //CSQSTUB DD DSN=++HLQ.MQM100++.SCSQLOAD,DISP=SHR //CSSLIB DD DSN=SYS1.CSSLIB,DISP=SHR //*
  ·
  ·
  ·
//SYSIN DD * INCLUDE CSQSTUB(CSQBRSTB) INCLUDE CSSLIB(ATRSCSS)
  ·
  ·
  ·
/*

To run a batch or RRS program, you must include the libraries thlqual.SCSQAUTH and thlqual.SCSQLOAD in the STEPLIB or JOBLIB data set concatenation.

To run a TSO program, you must include the libraries thlqual.SCSQAUTH and thlqual.SCSQLOAD in the STEPLIB used by the TSO session.

To run an OpenEdition batch program from the OpenEdition shell, add the libraries thlqual.SCSQAUTH and thlqual.SCSQLOAD to the STEPLIB specification in your $HOME/.profile like this:

  STEPLIB=thlqual.SCSQAUTH:thlqual.SCSQLOAD
  export STEPLIB