Defining CFTXXX

This topic describes the CFTXXX command, where the XXX represents the network type that you are defining. The network type described in this topic is CFTTCP parameter description.

The following table describes the parameters common to all of the specific commands below. The description of the general parameters is not repeated. Definition and parameters vary according to the network type.

Related topics

Description

Use this command to define the network parameters of partners for a given type of network.

Parameters

CNXIN 

Maximum number of sessions allocated to this partner, for incoming connections (server mode).

The maximum value supported for each system is indicated in the CNXINOUT parameter comment, in tabular form.

CNXINOUT

Maximum number of sessions for communicating with this partner over this network resource.

CNXOUT

Maximum number of sessions for outgoing connections with this partner (requester mode).

The maximum value supported for each system is indicated in the CNXINOUT parameter comment, in tabular form.

The parameters CNXIN, CNXOUT and CNXINOUT are independent with respect to each other.

In the case of DMZ usage, this parameter must be initialized to zero at the start, refer to Using the Turn command .

ID

Name identifying the partner.

This value makes reference to a partner description (CFTPART ID = ...).

When ID is set to the CFTPARM command DEFAULT parameter value, the command describes the default network configuration of a calling partner (hence operation in SERVER mode if the partner is only a REQUESTER). In this case, the parameters specific to a partner and the parameters specific to outgoing calls (DIALNO, CNXOUT, RETRY*, O*TIME) are not applicable.

IMAXTIME

Maximum time after which the partner can no longer call over this type of network.

IMINTIME 

Minimum time before which the partner cannot call over this type of network.

IMINTIME, IMAXTIME hence represent the authorized time slot for calls coming from this partner over this type of network.

OMAXTIME

Maximum time after which the partner can no longer be called over this type of network.

OMINTIME

Minimum time before which the partner cannot be called over this type of network.

OMINTIME, OMAXTIME therefore represent the permitted time slot for calling this partner over this type of network.

RETRYM 

Maximum number of reconnection attempts.

If this parameter equals 0 and if the initial connection fails, no further reconnection attempts are made.

RETRYN 

Corresponds to the number of reconnection attempts with a time interval of RETRYW between attempts.

When RETRYN attempts have been made without success, Transfer CFT divides RETRYN by two and multiplies RETRYW by two and then begins the sequence again up to the total number of times specified (RETRYM).

RETRYW

Time interval between reconnection attempts (expressed in minutes).

Example:

RETRYW = 01,
RETRYN = 08,
RETRYM = 20

means:

  • eight retries at one-minute intervals,
  • four retries at two-minute intervals,
  • two retries at four-minute intervals,
  • one retry after an eight-minute interval,
  • five retries at sixteen-minute intervals.

CFTTCP

z/OS (MVS), IBM i (OS400), UNIX, OpenVMS, Windows

The CFTTCP command defines the network parameters associated with a partner for a TCP/IP connection.

Each partner can only have one CFTTCP object.

In DELETE mode, the following parameters must be defined:

  • ID parameter
  • CLASS parameter if its value is not the default value 1

Only the parameters specific to the CFTTCP object are described. The complete list of the permitted parameters is nevertheless given below.

Command syntax: CFTTCP

Description

Use this command to define the network parameters associated with a partner for a TCP/IP connection.

Parameters

HOST

HOST     = (string64, string64, …)

VERIFY

Option to verify the IIP address (HOST) on an incoming connection request (the first 'n' digits of the caller number are checked).

If VERIFY = 0, no verification is performed.

 

The correspondent IP address or the list of correspondent IP addresses with which the user wants to start a session. The maximum number of addresses for this list is 4.

This address (expressed in the form of a character string) may be defined:

  • either with the real IP address in the "dot notation" (for example: 192.9.200.10)
  • or with the logical name HOSTNAME associated with the real IP address and configured in the corresponding "database" file (HOST), supplied with any TCP/IP package

CLASS 

Class of the TCP local resource(s) used to establish the connection with the partner.

This class value is defined in the CFTNET command corresponding to the network access method used to communicate with the partner.

This parameter is used for an outgoing connection request, to select this CFTTCP using the protocol imposed by CFTPART (this mechanism allowing several CFTTCP commands to be associated with a CFTPART command).

This parameter gives rise to a simple verification for an incoming connection request.

IMINTIME  

The minimum time of the authorized time slot for calls coming over this type of network, or with the partner if defined in CFTPART, before which the partner cannot be called.

IMAXTIME

The maximum time of the authorized time slot for calls coming over this type of network, or with a partner if defined in CFTPART, after which the partner can no longer be called.

OMINTIME

The authorized time slot for calls coming over this type of network.

OMAXTIME

The maximum time of the authorized time slot for calls over the network type or by the partner if defined, after which the partner can no longer make a call over this type of network.

RETRYM 

Use this field to specify the number of reconnection attempts to make with a time interval

CNXINOUT

Maximum number of communication sessions.

CNXIN 

Maximum number of sessions for input connections.

CNXOUT 

Maximum number of sessions for output connections.

RETRYW 

The time interval (expressed in minutes) between reconnection attempts.

RETRYN 

Use this field to specify the number of reconnection attempts to make with a time interval of retryw between attempts.

Example

CFTTCP   MODE     = CREATE,  /* TCP access point  */

 ID   = PARIS5,   /* to the PARIS5 partner     */

  HOST   = SUN3,

  RETRYM  = 6,   /* reconnection attempt    */

  RETRYN   = 4,          /* parameters     */

  RETRYW   = 2

The PARIS5 partner has a TCP/IP address corresponding to the mnemonic SUN3.

The intervals between connection attempts, or retries, are calculated by the following algorithm:

  • 4 retries at 2-minute intervals
  • 2 retries at 4-minute intervals

Related Links