Installing Online Interfaces › How to Complete Configuration of the XMS Online Interfaces With CA MSM › Define Security Requirements › Step 2: (Optional) Set up the TSOXMS Driver Program › TSO Cross-Memory Notes

TSO Cross-Memory Notes

Be aware of the following:

• The primary RMOXMS region should 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=XMC0 or not specified).
• If multiple RMOXMS 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 CICS user transaction.

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

• SUBSYS= parameter of the cross-memory task.

  This parameter must match the SUBSYS= parameter specified in the EBCXMCTR table entry.

• RECON=YES can be used to allow reconnection (after a TSO terminal error) at the point of exit.
• TIMEOUT= specifies how long TSO will wait 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 VTAM Online Retrieval Option

Important! This facility uses the cross-memory feature distributed with CA Deliver and must be installed with that feature. For more information about cross-memory feature, see the Install Cross‑Memory Services section in this chapter.