Previous Topic

Next Topic

Book Contents

Book Index

Step 14.4 – Add resource definitions

Add a TRANSACTION entry for each transaction type.

Figure 22 Adding resource definitions example - TRANSACTION

      DEFINE TRANSACTION (transaction_name) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA TRANSACTION) 

               PROGRAM      (IOACICS) 

               SPURGE       (YES) 

               TPURGE       (YES) 

               TWASIZE      (0) 

               TASKDATALOC  (ANY) 

               TASKDATAKEY  (CICS) 

               ISOLATE      (NO) 

MRO is supported in the following way: The defined transaction is pseudoconversational. The first transaction of the defined name that a user issues (transaction_name above) can be routed to any AOR. In this AOR a session is established with a specific IOAOMON, and the user must be routed back to the same IOAOMON. Therefore, all subsequent instances of transaction_name after the first one in a specific session must be routed back to the same AOR. Such support is possible when transaction_name is defined in CICS as an AFFINITY GROUP with relation of LUNAME and lifetime of PCONV.

The following predefined transactions are available in IOA, and they can be found in the IOA IOAENV library: BMAN, DFTR, DMAN, DOLV, TMAN, TMNO, and TMNT. If you need to make changes in any transaction, copy the member to the IOA PARM library and make your changes there.

Add the following program definitions:

Figure 23 Adding resource definitions example - program definitions

      DEFINE PROGRAM        (IOACICS) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (CICS) 

 

      DEFINE PROGRAM        (IOACICNV) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (CICS) 

 

      DEFINE PROGRAM        (IOAX009) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (USER) 

 

      DEFINE PROGRAM        (IOASE09) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (USER) 

 

      DEFINE PROGRAM        (IOAX037) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (USER) 

 

      DEFINE PROGRAM        (CTMSUSIE) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (USER) 

 

      DEFINE PROGRAM        (IOAJPED) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (BELOW) 

               EXECKEY      (USER) 

The program definition (CTMSUSIE) is mandatory. If you intend to install French, German, or Japanese language support, you must also add one or more of the following program definitions:

      DEFINE PROGRAM        (CTMSUSIF) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (USER) 

      DEFINE PROGRAM        (CTMSUSIG) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (USER) 

      DEFINE PROGRAM        (CTMSUSIJ) 

               GROUP        (IOA) 

               DESCRIPTION  (IOA PROGRAM) 

               LANGUAGE     (ASSEMBLER) 

               DATALOCATION (ANY) 

               EXECKEY      (USER) 

In some versions of CICS, you may need to shut down CICS to update the PPT and PCT. In later versions, the update can be performed online using CEDA if they are new. If they are old, a NEWCOPY is enough.

If security for CICS system programmer commands is in use, add the IOACICNV load module to the CICS PLT table.

Parent Topic

Step 14 – Install IOA CICS support (optional)