Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Appendix B Configurations for Communications : Configuring XCF Communications

Configuring XCF Communications
Review this section if you are using Cross System Coupling Facility (XCF) services to communicate between TIBCO Object Service Broker components, where the Execution Environments and the external database gateways are running on different systems in a sysplex.
Requirements for XCF Communications
You must have the following in place in order to use XCF:
XCF can be used only if the Execution Environment, the Data Object Broker, and the gateways are executing in the same sysplex.
A properly configured relay file, to define XCF group name and member names for TIBCO Object Service Broker components.
The Relay File
RELAYXCF, in the CNTL data set, contains information about TIBCO Object Service Broker components that use XCF communications. This is a text file in XML format that defines the XCF group name and member names for TIBCO Object Service Broker components.
If TCP/IP relay is deployed, XCF parameters must be merged with the TCP/IP relay parameters, and the combined parameters are contained in RELAYCFG in the CNTL data set. For details on TCP/IP parameters, see Configuring TCP/IP.
The order of the relay parameters for each node name will be the order of selection for that node. If merged with TCP/IP parameters, XCF will be considered before TCP/IP for nodes PRODZDOB and PRODZNEE; see Relay File Samples. Run USERMODD in the JCL data set to customize the data set name of the relay file.
The installation process for TIBCO Object Service Broker copies RELAYCFG to the data set $HLQNONV$.$SLQ$.RELAYCFG. This data set contains your live XCF and TCP/IP information. If you need to make changes to your XCF configuration, use the CNTL member RELAYCFG to make and verify your changes, then copy the new information to $HLQNONV$.$SLQ$.RELAYCFG.
To override the data set name set by USERMODD, add a DDNAME S6BRELAY to your TIBCO Object Service Broker component. If this override is invalid during the component initialization, then the XCF support is disabled until you provide a valid parameter file. Once the relay file has been processed during component initialization, it is freed.
The relay file consists of a set of protocol specific parameters followed by a directory that maps communications identifiers to protocol specific parameters.
Relay File Samples
The following is a sample of a relay configuration file for XCF

 
<relay xmlns="http://www.tibco.com/OSB/relayparms.xsd">
   <xcfparms groupname='S6BOSB'/>
   <directory>
      <node name="PRODZDOB">
         <xcf/>
      </node>
      <node name="PRODZNEE">
         <xcf/>
      </node>
   </directory>
</relay>

 
The following is a sample of merged relay configuration file for TCP/IP and XCF:

 
<relay xmlns="http://www.tibco.com/OSB/relayparms.xsd">
   <tcpipparms tcbnum="3" maxtcbsockets="50" />
   <xcfparms groupname='S6BOSB'/>
   <directory>
      <node name="PRODZDOB">
         <xcf/>
         <tcpip host="zos1.mydomain.com" service="emprec" />
      </node>
      <node name="PRODSDOB">
         <tcpip host="solaris5.mydomain.com" port="26360" />
      </node>
      <node name="PRODZEE">
         <xcf/>
         <tcpip host="zos1.mydomain.com" port="22636" />
      </node>
      <node name="TESTDOB">
         <tcpip host="168.192.0.101" port="26362"/>
      </node>
   </directory>
</relay>

 
Verifying Relay File Syntax
The S6BRLYVA program allows the administrator of TIBCO Object Service Broker to verify that the syntax of a relay file is correct before starting a TIBCO Object Service Brokercomponent that uses the file. The utility will parse the relay file allocated to the S6BRELAY DD name and will display any error messages in the SYSPRINT DD name.

 
//MYUSERGN JOB (0),'VERIFY PARMS',MSGCLASS=A,NOTIFY=MYUSER,TIME=10
//VALIDATE EXEC PGM=S6BRLYVA,REGION=0M
//STEPLIB DD DISP=SHR,DSN=$HLQNONV$.$INSTVER$.AUTH
//S6BRELAY DD DISP=SHR,DSN=$HLQNONV$.$SLQ$.RELAYCFG
//SYSPRINT DD SYSOUT=*

 
Refer to the RELAYVAL member in the JCL data set for sample JCL to run the utility.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved