Management utilities

This topic describes the following management utilities:

Management utilities descriptions

cftinit

cftinit is a general Transfer CFT initialization utility.

Syntax

cftinit [<filename> [<filename>...]]

Standard use

cftinit is normally used with a single parameter, which is the name of the Transfer CFT configuration file.

cftinit my_config.cft

Advanced use

Several file names can be included in the command line. Normally, all Transfer CFT parameters are declared in a single file. However, for organizational reasons, you may wish to separate the configuration into several files (for example, a file describing the CFTPART cards and another file containing the CFTPARM, CFTLOG cards, and so on).

cftinit partners.cft the_rest.cft

Note  
  • If no file name is passed as a parameter, the program requests one or more file names
  • If no name is supplied, the program stops
  • When you run cftinit, it creates the catalog and communication files. You can modify the default sizes of these files to suit your requirements by updating the uconf values for cft.cftcat.default_size and cft.cftcom.default_size (these values are expressed as a number of records).

cft start

The cft start utility performs a controlled start of Transfer CFT and its additional elements.

Syntax

cft start

Standard use

cft start is normally used without parameters. It checks the Transfer CFT environment to ensure that Transfer CFT starts up correctly. It then runs Transfer CFT, waits for the processes to start up and displays an information message with the process identifier (PID) of the CFTMAIN process.

% cft start
Starting CFT with IDPARM "IDPARM0"
Starting CFTMAIN ... started
Starting CFTTCOM .... started
Starting CFTTPRO ... started
Starting CFTLOG ... started
CFT started correctly.
CFTMAIN process ID is 23564.
%

cft stop

The cft stop utility performs a controlled shutdown of Transfer CFT.

Syntax

cft stop [-kill]

Standard use

The cft stop command, used without parameters, shuts down Transfer CFT by sending the SHUT FAST=YEScommand. It then waits until the various Transfer CFT processes are stopped.

% cft stop
Waiting for CFTLOG .... stopped
Waiting for CFTTCPS ... stopped
Waiting for CFTTPRO ... stopped
Waiting for CFTTCOM ... stopped
Waiting for CFTTFIL ... stopped
Waiting for CFTMAIN ....stopped
CFT stopped correctly.
%

If cft stop detects abnormal behavior during the shutdown phase, it displays the following message:

% cft stop
Invalid state of Transfer CFT.

Use Cft force-stop to force Transfer CFT to shut down.

Advanced use

In the event of a problem, the program recommends that you shut down Transfer CFT using theCft force-stopcommand.

This command then forces a Transfer CFT shutdown. It is normally successful, but depending on the state of the system, more serious malfunctions may be encountered.

If a serious malfunction occurs at Transfer CFT level, an alarm message is displayed before continuing with the housekeeping procedure, to inform you about the possible consequences of the next command.

% cft stop
Invalid state of CFT.
UseCft force-stop to force shutdown of Transfer CFT
% cft stop -kill

Stopping Transfer CFT...

Transfer CFT stopped correctly.

cftupdate

The cftupdate utility is used to update the configuration.

Syntax

cftupdate <filename> [<filename> ...]

Note  
  • You can only update the CFTPART, CFTxxx (for the networks), CFTSEND cards, and so on.
  • This command should be considered to be an alias of CFTUTIL #<filename> for each file name passed as a parameter in the command line.

Related Links