CONFIG - Setting default CFTUTIL file names

The CONFIG command redefines the data media that the CFTUTIL utility uses. A medium refers to any data medium or local communication means.

See Defining the communication media .

When activated, CFTUTIL uses the default data media such as master files, log files, communication with the Transfer CFT, as defined in Transfer CFT. See the specific Operations Guide that corresponds to your Operating System.

The CONFIG command is needed when the user wants to read from or write to a medium other than these default media. In this case, the CONFIG command must be used before executing the other commands processed by CFTUTIL.

The CFTUTIL data media are designated in this command by the TYPE parameter. There are two different types of media categories relating to this parameter:

The media interfacing with those used by the Transfer CFT. The data associated with these media is used by CFTUTIL to:

  • Configure and query the Transfer CFT parameters with the option TYPE =PARM
  • Configure and query the partners managed by the Transfer CFT with the option TYPE = PART
  • Query the catalog used by the Transfer CFT with the option TYPE = CAT
  • Communicate with the Transfer CFT with the option TYPE = COM, through the communication media managed by the Transfer CFT

The media specific to CFTUTIL used to:

  • Send the commands to be processed (by CFTUTIL) with the option TYPE = INPUT
  • Send the commands to be processed (by CFTUTIL) with the option TYPE = INPUT

For TYPE = PARM, TYPE = PART and TYPE = CAT, the associated media can only be files. The CONFIG command is used to modify the names of these files (FNAME parameter).

For TYPE = INPUT and TYPE = OUTPUT, the CONFIG command is used to redirect the CFTUTIL input or output data stream, to a file whose name is specified by the FNAME parameter.

If the user modifies the name of the input file (TYPE = INPUT), subsequent CFTUTIL commands are read in the new input medium mentioned.

For TYPE = COM and depending on the system involved, the associated media can be:

  • A file
  • A mailbox
  • TCPIP communication

For a communication medium based on TCP/IP the media can be:

  • Host name
  • Configuration file name (refer to the structure of the configuration file found in the Appendix)

If this file does not exist or does not have the correct syntax, the user is notified only during the processing of the first transfer request.

By using this syntax, you can dynamically modify the communication media since the file is analyzed at each new transfer request.

The CONFIG command is used to change the:

  • Transfer CFT communication medium (MEDIACOM parameter)
  • Name of the associated file or mailbox (FNAME parameter)

The media that can be used for a given system and the default communication medium associated with this system. Communication media

Command syntax: CONFIG command syntax

Description

Use this command to redefine the data media with which the CFTUTIL utility operates.

Parameters

FNAME

 

For TYPE = {CAT | INPUT | OUTPUT | PARM | PART }

Name of the file associated with the medium type accessed by CFTUTIL.

 

FNAME

 

For TYPE = COM

  • Name of the Mailbox, the host, or the configuration file.

There must be a correspondence with the CFTCOM NAME parameter  that defines the communication medium as seen from Transfer CFT.

For a communication medium supported by TCP/IP (MEDIACOM=TCPIP) this is either:

  • A host name (string) using the format: "protocol://machine:port", or
  • A configuration file (filename)

MEDIACOM 

Defines the communication medium type if this medium is relevant to the system.

TYPE 

Defines the medium concerned.

Example

CONFIG       TYPE = OUTPUT,

FNAME = <filename>

This command redirects the CFTUTIL output (used during querying of the LISTPARM or LISTPART commands, etc.) to the file with the generic <filename>.

CONFIG      TYPE = COM,

MEDIACOM = FILE

FNAME = <filename>

This command is used to define the file with the generic <filename> as the Transfer CFT communication medium.

Related Links