Entire Net-Work XCF Option Installation Procedure

The Entire Net-Work XCF Option currently supports the z/OS operating systems only.

If Entire Net-Work is not already installed, see the section Installation Overview. Then perform the following additional steps:

  1. Using IEBCOPY, unload the Entire Net-Work XCF Option library from the installation media into your Entire Net-Work load library.

    Refer to the Software AG Product Delivery Report for the correct data set sequence numbers and names.

  2. The XCF line driver requires APF authorization. To make Entire Net-Work APF-authorized:

    • Ensure that all load libraries in your STEPLIB concatenation have been defined to z/OS as authorized libraries; and

    • Ensure that module ADARUN has been linked with AMODE(31) and AC(1).

  3. Add a DRIVER statement that specifies your requirements to the Entire Net-Work parameter data set. The DRIVER statement is required. For more information, read XCF DRIVER Statement.

  4. Optionally, add one or more LINK statements. LINK statements describe Entire Net-Work partner nodes, and are currently not required. For more information, read XCF LINK Statement .

  5. Define the z/OS-related XCF parameters:

    • Class and Group for Entire Net-Work.

    • Entire Net-Work list structures.

    For more information, read XCF Line Driver Values.

  6. Start Entire Net-Work (on multiple nodes) and run verification tests. For example:

    • Test your applications running across Entire Net-Work. Run one application at a time and verify the results.

    • Run a load test through the network (that is, multiple users on each node accessing data on the partner node).


XCF Line Driver Values

Software AG recommends that you add the values used by the Entire Net-Work XCF line driver to the COUPLExx member in SYS1.PARMLIB, as follows:

  • Add a CLASSDEF statement with CLASS(ENTIRE) and GROUP(NETWORK) specified.

  • Add a PATHIN statement with STRNAME(IXC_NETWORK) specified.

  • Add a PATHOUT statement with STRNAME(IXC_NETWORK) and CLASS(ENTIRE) specified.

For example:

COUPLE SYSPLEX(USRSPLX1)
       PCOUPLE(SYS1.SYSPLEX.USRSPLX1.CDS01)
           ACOUPLE(SYS1.SYSPLEX.USRSPLX1.CDS02)
           INTERVAL(120)

CLASSDEF
           CLASS(ENTIRE)
           CLASSLEN(8192)
           GROUP(NETWORK)
           MAXMSG(4096)
LOCALMSG
           MAXMSG(4096)
           CLASS(ENTIRE)
PATHIN STRNAME(IXC_DEFAULT,IXC_NETWORK)
PATHOUT STRNAME(IXC_DEFAULT)
PATHOUT STRNAME(IXC_NETWORK) CLASS(ENTIRE)

Note:
No changes to the COUPLExx member are required. If values are not specified, the system defaults will be used.

You will need to run a job similar to the following example in order to define to XCF a list structure for Entire Net-Work:

//STEP20   EXEC PGM=IXCMIAPU
//SYSPRINT DD   SYSOUT=X
//SYSABEND DD   SYSOUT=X
//SYSIN    DD   *

     DATA TYPE(CFRM) REPORT(YES)
 
     DEFINE POLICY NAME(POLICY1) REPLACE(YES) 
          CF NAME(CF)
              TYPE(009674)
                   MFG(IBM)
                   PLANT(02)
                   SEQUENCE
                   PARTITION(1)
                   CPCID(00)
                   DUMPSPACE(2000)
          STRUCTURE NAME(IXC_DEFAULT)
                   SIZE(1000)
                   PREFLIST(CF)
          STRUCTURE NAME(IXC_NETWORK)
                   SIZE(8192)
                   PREFLIST(CF) 

Contents of the Release Media

The following table describes most of the libraries included on the release (installation) media. Once you have unloaded the libraries from the media, you can change these names as required by your site, but the following lists the names that are delivered when you purchase Entire Net-Work XCF Option.

Note:
The complete list of libraries provided with Entire Net-Work can be found in the full Entire Net-Work documentation.

Library Name Description
WXFvrs.LOAD The z/OS load library for Entire Net-Work XCF Option. The vrs in the library name represents the version of Entire Net-Work XCF Option.