Chapter Contents
Previous
Next
Tutorial: Creating a Simple Transaction

CICS and the Sample Program

CICS sees the example program as follows:

  1. Terminal control reads the data entered and passes control to task control.

  2. A task is created and validated against the program control table (PCT).

  3. If all is valid, program control then loads the associated example application program to process the task.

  4. Control is then passed to the example application program.

  5. The example application program terminates when processing is complete, and CICS passes control back to task control.

To prepare the example program to run under CICS you must first ensure that the library in which the executable load modules were stored is available on the CICS DFHRPL DD. The local CICS system programmer or the SAS Software Representative for SAS/C software products can be of help in locating this library.

Next, you need to define a transaction ID in the PCT for the example program. This may be accomplished by using RDO (resource definition online, transaction CEDA) or DFHCSDUP. For older releases of CICS, table-generation macros may be used. The DFHCSDUP input is used here because it is easiest to understand. Contact your local CICS system programmer for assistance. Example DFHCSDUP input follows: 

DEFINE TRANSACTION(SASC) GROUP(your-group-name)
       DESCRIPTION(SAS/C Example transaction)
       PROGRAM(SASCSAMP)

Finally, you need to define a program name in the PPT for the example program in a manner similar to the way you defined the transaction. Example DFHCSDUP input follows: 

DEFINE PROGRAM(SASCSAMP) GROUP(your-group-name)
       DESCRIPTION(SAS/C Example Program)
       LANGUAGE(ASSEMBLER)

SAS/C application programs are defined as assembler language programs to CICS.

After defining the transaction and program (using RDO or DFHCSDUP), you must make them known to CICS by installing them (using the INSTALL command) with the CEDA transaction. If you have used the older table-generation method, then CICS will need to be restarted so that the definitions will be recognized.


Chapter Contents
Previous
Next
Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.