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

VTAM Cross-Memory Notes

Be aware of the following:

• For VTAM only regions, you can start the primary SARXMS task with the XMSSUB=NO parameter. However if this is not a VTAM‑only region, we recommend that you start the primary SARXMS region with the XMSSUB=YES parameter.
• If multiple SARXMS regions are started, they must be started with XMSSUB=NO parameter.

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

• VTAM only XMS regions can have the XMS=NO parameter to make it accessible.
• All XMS interfaces require the EC2XMCTR table. You must assemble the table during installation to:
  • Define the relationship between CA View and CA Deliver database high-level qualifiers and the session options to be used
  • Provide information used to build the XMS database table. Only the database high-level qualifier is used for VTAM XMS users.
• Specify the SARAPPL=applid parameter. This parameter provides VTAM user signon capability.

  Note: When you are using multiple VTAM XMS regions, each region must have a unique applid.

• To pass VTAM signon requests to other XMS regions, specify the VTAMPASS=YES parameter.
• When you are using multiple VTAM XMS regions, the values for LGNFMT=, SARVDTB=, VTMQUERY=, and VTMSAA= must be the same in each region or the XMS interface may react in unpredictable ways.
• To activate the VTAM generic resource support for your cross‑memory regions, specify the VGRAPPL= parameter.

  For more information about VTAM generic resources, see the following topic.

VTAM Generic Resource Name

If the VGRAPPL parameter is specified in an EMAS complex, this parameter specifies a common VTAM generic resource name for the entire EMAS complex.

Specifying the common VTAM generic resource name in the session request can initiate VTAM cross‑memory sessions to any of the EMAS members.

When you are using the VTAM generic resource name, by default VTAM tries to request a session with an EMAS member in the same MVS image.

If it is not possible to get the session that was requested, VTAM uses normal load balancing when passing the session request to one of the active EMAS members.

Install the CA Roscoe/Cross-Memory Online Retrieval Option

The CA Roscoe/cross-memory online retrieval option runs as a command processor under ETSO/Roscoe.

Important! This interface requires cross-memory services to be installed. See the previous topic Installing Cross-Memory Services in this chapter. Be sure to set the parameter XMSSUB to YES in the JCL for the cross-memory services task.

Installation Steps

The following steps are required to install the CA Roscoe/Cross Memory Online Retrieval option. Each step is explained in detail in the sections that follow.

1. (Optional) Concatenate the Load Module Library to the ETSOLIB DD statement, if the load modules were not copied to a linklist library.
2. Add the control statement for the SARROS command processor to the Eligible Program List (EPL).
3. Invoke CA Roscoe/Cross Memory Online Retrieval.