Preparing the sample applications for the CICS environment
Before you run the CICS(R) 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.
To prepare a sample application that runs in the CICS environment, perform
the following steps:
- 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.
- Perform the same steps that you would when building any CICS WebSphere MQ for z/OS application.
These steps are listed in Building CICS applications. The library members to use are
listed in Table 35, Table 36, Table 37, and Table 38.
Alternatively, where we supply an executable form of a sample, you can run
it from the thlqual.SCSQCICS load library.
-
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 WebSphere MQ for z/OS System Setup Guide.
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.
- 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.