Managing Transfer CFT to Sentinel communication parameters

This topic describes the configuration files and parameters you set to enable interoperability between Transfer CFT and Sentinel.

Viewing parameter values

To view the values of all Transfer CFT exchange parameters:

  1. Open a command console.
  2. Enter an absolute path to the cftuconf user file (cftuconf.dat).
  3. Enter the command:
  4. CFTUTIL listuconf id=sentinel.*

To view the value of a specific Transfer CFT Sentinel exchange parameter:

  1. Open a command console.
  2. Enter an absolute path to the cftuconf user file (cftuconf.dat).
  3. Enter the command:
  4. CFTUTIL listuconf id=sentinel.[parameter_name]
  5. Example (returning the TRKTYPE value):
  6. CFTUTIL listuconf id=sentinel.TRKTYPE

Setting parameter values

To set the value of a Transfer CFT exchange parameter:

  1. Open a command console.
  2. Enter an absolute path to the cftuconf user file (cftuconf.dat).
  3. Enter the command:
  4. CFTUTIL uconfset id=sentinel.[parameter_name]
  5. Example (setting the TRKTYPE value):
  6. CFTUTIL uconfset id=sentinel.TRKTYPE,value=TCP

TCP exchange parameters

The following table lists the principal parameters that you define to enable Transfer CFT to generate and send event-related messages to Sentinel via TCP.

Event Router TRKUTIL Transfer CFT 2.6.x
Configuration file USEPARIN TRKCONF UCONFThe Transfer CFT Universal Configuration file (UCONF) contains static configuration paramters for Transfer CFT, including parameters that control network exchanges, and characteristics of exchanges with Sentiel. You can modify this file using either CFTUTIL line commands or the GUI UCONF interface. For complete details on using UCONF, refer to the Transfer CFT online documentation.
TCP definition

(AGENT)

queue="NOQ"

TRKTYPE=TCP UCONFSET ID=sentinel.TRKTYPE,VALUE=TCP
(TCPSOURCE) sap=nnnn TRKIPPORT=nnnn UCONFSET ID=sentinel.TRKIPPORT,VALUE=nnnn

(TCPSOURCE)

local_address=

TRKIPADDR= UCONFSET ID=sentinel.TRKIPADDR,VALUE=

UCONF parameters for Sentinel interoperability

All platforms

The following table lists the UCONF values that are currently used in Transfer CFT to define Sentinel interoperability. You can set these UCONF values either in the GUI or by using a command line.

UCONF value Default value Former Sentinel parameter name
[sentinel.xfb.enable] NO XFB.Sentinel (trkapi.cfg)

[sentinel.xfb.transfer]

ALL

XFB.Transfer (trkapi.cfg)

[sentinel.xfb.shut]

0

XFB.Shut (trkapi.cfg)

[sentinel.xfb.log]

IEWF

XFB.Log (trkapi.cfg)

[sentinel.trktname]

$(cft.runtime_dir)

/data/trkapi.buf

TRKTNAME (trkapi.cfg)

[sentinel.trksharedfile]

No

TRKSHAREDFILE

[sentinel.trklenmsg]

 

TRKLENMSG

[sentinel.trklocmaxtime]

300

TRKLOCMAXTIME

[sentinel.trktmode]

DIFFER

TRKTMODE

[sentinel.trktconnretry]

60

TRKTCONNRETRY

[sentinel.trkretrydelay]

10

TRKRETRYDELAY

[sentinel.trkretrynb]

6

TRKRETRYNB

[sentinel.trkdelay]

10

TRKDELAY

[sentinel.trktimeout]

60

TRKTIMEOUT

[sentinel.trkproductname]

CFT

TRKPRODUCTNAME

[sentinel.trkipaddr]

sentinel-server-hostname

TRKIPADDR

[sentinel.trkipport]

1761

TRKIPPORT

[sentinel.trk_min_port]

5000

TRK_MIN_PORT

[sentinel.trk_max_port]

32000

TRK_MAX_PORT

[sentinel.trkipaddr_bkup]

 

TRKIPADDR_BKUP

[sentinel.trkipport_bkup]

1761

TRKIPPORT_BKUP

[sentinel.trk_min_port_bkup]

5000

TRK_MIN_PORT_BKUP

[sentinel.trk_max_port_bkup]

32000

TRK_MAX_PORT_BKUP

[sentinel.trktype]

TCP

TRKTYPE

[sentinel.trkgmtdiff]

60

TRKGMTDIFF

[sentinel.trktrcfile]

$(cft.runtime_dir)

/run/sentinel.trc

TRKTRCFILE

[sentinel.trktrace]  

0

TRKTRACE

Communication with the Event Router

Z/OS environment

The following table describes the definition of communication with the Event Router via XCF. In this configuration:

  ER TRKUTIL Transfer CFT 2.6.x
Configuration file USEPARIN TRKCONF UCONF
SVC

(SYSTEM)

svc_nb=nnn

TRKSVC=nnn UCONFSET ID=sentinel.TRKSVC,VALUE=nnn
XCF definition (AGENT)queue= TRKQUEUE= UCONFSET ID=sentinel.TRKQUEUE,VALUE=xxxx
TRKTYPE=XCF UCONFSET ID=sentinel.TRKTYPE,VALUE=XCF

Overflow file definition

Z/OS environment

The following table describes the overflow file definition for the Logger file. In this configuration:

  Event Router TRKUTIL Transfer CFT 2.6.x
Configuration file USEPARIN TRKCONF UCONF
Logger file

(AGENT)

api_file=

TRKTNAME= UCONFSET ID=sentinel.TRKTNAME, VALUE=xxxx.xxxx.xxx
  TRKSHAREDFILE=YES UCONFSET ID=sentinel.TRKSHAREDFILE,VALUE=YES