Installing the Online Interfaces › How to Complete Configuration of the XMS Online Interfaces with CA CSM › Define Security Requirements › ISPF Cross-Memory Notes

ISPF Cross-Memory Notes

Be aware of the following:

• The primary SARXMS region must be started with the XMSSUB=YES parameter.
• The XMSSUB=YES parameter must only be used in an XMS address space with a default subsystem ID (SUBSYS=XMC1 or not specified).
• If multiple SARXMS regions are started, they must be started with XMSSUB=NO parameter.

  Only the primary XMS region can have XMSSUB=YES specified.

• The XMS regions must have the XMS=YES parameter to make it accessible.
• The EBCXMCTR table must be assembled during installation to define the relationship between CA View and CA Deliver database high-level qualifiers. The table contains an EBCXMOPT macro to define initialization options and the EBCXMTRN macro for each CA View database transaction.

The EBCXMTRN macro also contains options for the specific database as follows:

• SUBSYS= parameter of the cross-memory task must match the SUBSYS= parameter specified in the EBCXMCTR table entry.
• RECON=YES can be used to allow reconnection (after an ISPF terminal error) at the point of exit.
• TIMEOUT= specifies how long ISPF waits for the XMS session to respond after the user enters input, in seconds.

  We recommend as high a value as possible but not less than 240 (4 minutes).

To abort the XMS session and return the user to ISPF or the TSO command prompt, press the ATTN key.

Note: The SUBMAX= parameter controls the number of user connections, not the USERMAX= parameter. USERMAX= only applies when you are using the subtask with the CICS interface.

Install the TSO/Cross-Memory Online Retrieval Option

Important! This interface requires the cross-memory services to be installed. See the previous topic Install the Cross-Memory Services in this chapter.

Note: The parameter XMSSUB must be set to YES in the JCL for the cross-memory services task.

Installation Steps

The following steps are required to install the TSO/cross-memory online retrieval option. Each step is explained in detail in the sections that follow.

1. (Optional) Add STEPLIB DD Statements to the TSO LOGON procedures if the load modules were not copied to a linklist library.
2. (Optional) Create user CLISTs to execute the CA View TSO/XMS driver program.