How to configure CA Datacom MUF for XCF use

Document ID : KB000038170
Last Modified Date : 14/06/2018
Show Technical Document Details
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.
Instructions:
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 AXCUS01/BDCUS01 for version 14.0 and 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.

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.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 
For CA Datacom version 14.02, please refer to the CA Datacom/DB version 14.02 Database and System Administration Guide, in the section “Establishing Communication with z/OSConnecting Using Cross-System Coupling Facility (XCF)


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