Prepare the sample applications for the CICS environment

 

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.

To prepare a sample application that runs in the CICS environment, perform the following steps:

  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 WebSphere MQ for z/OS application. These steps are listed in Building CICS applications. The library members to use are listed in Table 1, Table 2, Table 3, and Table 4.

    Alternatively, where we supply an executable form of a sample, we 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 WebSphere MQ for z/OS System Setup Guide.

    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.

 

Parent topic:

Sample programs for WebSphere MQ for z/OS


fg18160_