How to configure CA Datacom MUF for XCF use

Article Id: 38170
Status: Published
Updated On: 29-03-2019 12:13
Legacy Id: TEC1423887
Products:
CA Datacom , CA CIS , CA Common Services for z/OS , CA 90s Services , CA Database Management Solutions for DB2 for z/OS , CA Common Product Services Component , CA Common Services , CA Datacom/AD , CA ecoMeter Server Component FOC , CA Easytrieve Report Generator for Common Services , CA Infocai Maintenance , CA IPC , Unicenter CA-JCLCheck Common Component , CA Mainframe VM Product Manager , CA Chorus Software Manager , CA On Demand Portal , CA Service Desk Manager - Unified Self Service , CA PAM Client for Linux for zSeries , CA Mainframe Connector for Linux on System z , CA Graphical Management Interface , CA Web Administrator for Top Secret , CA CA- Xpertware
Issue/Introduction:

In order to access a CA Datacom Multi-User Facility (called MUF) from an LPAR in the Sysplex other than where the MUF is running, it is necessary to define a number of parameters to the MUF to support XCF (IBM Cross-system Coupling Facility) processing.

This document describes what is needed.



Environment:

This applies to z/OS systems.

Resolution:

Here are a few things that you need to do to set up your MUF in support of both local and remote (XCF) processing:

  1. In your DBSIDPR assemble (found in INSTJCL member AXCUSNEW/BDCUSNEW for version 15.x), you need to have CONNECT_ALLOW_PRIORITY=(LOCAL,XCF) to run from multiple LPARs.
  2. In the same DBSIDPR, you need to ensure you have a unique name for the MUF in TARGET_MUF_LIST=(), and that you are using a different TOGROUP from any other MUF. The unique MUF name is very important to keep your data integrity. When you make these changes, reassemble DBSIDPR.
  3. In your MUF startup options (CUSMAC member AXDATIN1 (CA Datacom/AD) or DBDATIN2 (/DB) ), ensure that the MUF option has an asterisk (*) in the first parameter.
  4. In the MUF options, be sure that XCF_FROM is uncommented and that the XCF group name has the same value as the TOGROUP from DBSIDPR.
  5. In the MUF options, be sure the TASKS option has an appropriate value in the 5th parameter (XCF value) to support the number of tasks you will be running on remote LPARs for your application. Many clients will set this to at least 50-80 percent of the total TASKS value.
  6. To utilize XCF processing, be sure your CAAXLOAD (CA Datacom/AD) or CABDLOAD (/DB) and your CUSLIB files are APF authorized on all LPARs where your tasks are running, and that you have loaded the CA Datacom PC Call routines with CAS9/CAIRIM on each of those LPARs. 
In summary, you need:
DBSIDPR assembly 
  • CONNECT_ALLOW_PRIORITY=(LOCAL,XCF)
  • TOGROUP=<<1-8 character unique group name that you create>>
  • TARGET_MUF_LIST=<<1-7 character unique MUF/CXX name that you create>>
*  Note that the MUF name must be different from the TOGROUP name and in the case of a Shadow MUF, both MUFs have the same 1-7 root name plus a one-character suffix (preferably A and B, or something like that).

MUF startup options 
  • XCF_FROM  *,*,GROUPNAME,YES  <<groupname matches TOGROUP above>>
  • MUF       *,99,NO            <<first value should be *>>
  • TASKS     250,32K,0,0,100    << 5th value must be greater than 0>>
These points will cover the greatest majority of causes for applications on remote LPARs to not connect to a MUF.

Additional Information:

For more information about using XCF with the MUF, please refer to the following Guides:
For CA Datacom version 15.1, see the DocOps webpage for CA Datacom Core -15.1, and the section Administrating > CA Datacom/DB Database and System Administration > Establishing Communication with z/OS 
For CA Datacom version 15.0, see the DocOps webpage for CA Datacom Core -15.0, and the section Administrating > CA Datacom/DB Database and System Administration > Establishing Communication with z/OS 

As always, please contact CA Technologies support for CA Datacom if you have further questions.