[z/OS]

Preparing the sample applications for the CICS environment on z/OS

How to prepare a sample application that runs in the CICS® environment on z/OS®.

Before you begin

Before you run the CICS sample programs, log on to CICS using a LOGMODE of 32702. This is because the sample programs have been written to use a 3270 mode 2 screen.

About this task

The following sample application programs are available for the CICS environment on z/OS:

Procedure

  1. Create the symbolic description map and the physical screen map for the sample by assembling the BMS screen definition source (supplied in library thlqual.SCSQMAPS, where thlqual is the high-level qualifier used by your installation).
    When you name the maps, use the name of the BMS screen definition source (not available for Put and Get sample programs), but omit the last character of that name.
  2. Perform the same steps that you would when building any CICS IBM® MQ for z/OS application.
    These steps are listed in Building CICS applications in z/OS. The library members to use are listed in CICS Put and Get samples, CICS Queue Attributes sample, CICS Mail Manager sample (COBOL only), and CICS Credit Check sample.

    Alternatively, where there is an executable form of a sample, you can run it from the thlqual.SCSQCICS load library.

  3. Identify the map set, programs, and transaction to CICS by updating the CICS system definition (CSD) data set. The definitions that you require are in the member thlqual.SCSQPROC(CSQ4S100).
    For guidance on how to do this, see The CICS-IBM MQ Adapter section in the CICS Transaction Server for z/OS 4.1 product documentation at: CICS Transaction Server for z/OS 4.1, The CICS-IBM MQ adapter.
    Note: For the Credit Check sample application, you get an error message at this stage if you have not already created the VSAM data set that the sample uses.
  4. For the Credit Check and Mail Manager sample applications, ensure that the queues that they use are available on your system.
    For the Credit Check sample, they are defined in the member thlqual.SCSQPROC(CSQ4CVB) for COBOL, and thlqual.SCSQPROC(CSQ4CCB) for C. For the Mail Manager sample, they are defined in the member thlqual.SCSQPROC(CSQ4CVD). To ensure that these queues are always available, you could add these members to your CSQINP2 initialization input data set, or use the CSQUTIL program to load these queue definitions.

    For the Queue Attributes sample application, you could use one or more of the queues that are supplied for the other sample applications. Alternatively, you could use your own queues. However, in the form that it is supplied, this sample works only with queues that have the characters CSQ4SAMP in the first eight bytes of their name.