Installing the Online Interfaces › How to Configure the Online Interfaces Without CA CSM › Install the Cross-Memory Services › Step 2: Modify, Assemble, and Link the EC1XMCTR Module

Step 2: Modify, Assemble, and Link the EC1XMCTR Module

The EC1XMCTR module defines the relationship between a transaction identifier and the database, and session attributes. Also, the execution options for the cross-memory subtask system are also defined in this module. All interfaces except VTAM require the EC1XMCTR table.

Be aware of the following:

• You must assemble the EC1XMCTR table during installation to define the relationship between CA View and CA Deliver database qualifiers, and the session options to be used, and to provide information used to build the XMS database table.
• The table contains an EBCXMOPT macro to define initialization options and one EBCXMTRN, RMOXMTRN, or INBXMTRN macro for each TSO user session. For all users except VTAM, the transaction being used for each session must be defined in an EBCXMTRN statement. Only the database high-level qualifier is used for VTAM XMS users.
• The transaction definition macros are searched by database name, and the first match is used. If no entry is found in the EC1XMCTR table, the session is rejected.

A sample EBCXMCTR source program is in the CAI.CVDESRC library, which is unloaded as part of CA Deliver's installation. The source is comprised of one or more assembler macros.

Format of the Macros

The first statement defines the system options and has this format:

EBCXMOPT DESTID=dest,SRVTRAN=transaction,MSGLVL=level,          X
      DESTID=CICS-dest,LOGWAIT=timout-val,SGNCNT=nn,            X
      USERMAX=user-number,WAITCNT=maxcount

The next group of statements is for each transaction and or database to be accessed; they have this format:

EBCXMTRN TYPE=SAR,                                              X
       TRANID=tranid,INDEX=high-level-name,TIMEOUT=sec,         X
       SUBSYS=subsysid,RECON=yes|no,                            X
       MSGSUPP=yes|no

The last statement generates the transaction table:

EBCXMTRN TYPE=GEN

Finally, an assembler END statement is needed to end the macro:

END