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 cftinit is launched, 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 startup of Transfer CFT and its additional elements.

Syntax

cftstart [<idparm> | -batch]

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.
%

Advanced use

If Transfer CFT is configured with advanced settings, the IDPARM field can be passed as a parameter. If no parameter is entered, IDPARM0 is used by default. If an invalid IDPARM value is entered, cftstart displays the values available in the Transfer CFT configuration.

%cftstart IDPARM1
Invalid IDPARM "IDPARM1".
Valid IDPARMs are:
CFTPARM ID = 'IDPARM0',
CFT not started.
%

Batch mode

You must only use the cftstart command with the -batch option when starting up Transfer CFT automatically at system startup. This additional option only modifies the way in which the command is displayed

The logger() system command is used to store any error messages displayed during automatic startup. Therefore, for this device to operate correctly, the syslogd() system daemon must be running on your system. The system administrator will easily identify in the system log files the specific Transfer CFT messages, which are:

  • Error level and local0 facility for error messages
  • Information level and local0 facility for correct startup

The -batch parameter cannot be used with the IDPARM parameter.

Notes: cftstart triggers a timeout each time a process required by Transfer CFT is activated. Normally, this timeout is sufficiently long, but if the system has an excessive load or is an old system that is too slow, cftstart may generate a spurious error. If this happens, edit the cftstart shell and change the start_timeout field at the beginning of the file to a suitable value (in seconds).

When the system is delivered, cftstart does not automatically activate the additional Transfer CFT elements such as SCOPE or Copilot by default. To customize cftstart operation, refer to Using Additional Elements.

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.

Note In the event of a serious malfunction, this command removes the message queues, shared memory segments and semaphore vectors assigned to the Transfer CFT user. This could be fatal to any other applications started up by the user and calling on the same types of resources.

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

 

 

***************
*** WARNING ***
***************

Using this action can seriously damage the IPC status of other
applications running on the same login (as X server).

If you are not sure, use the ^C command and contact
your technical support.

If you want to continue, enter the word 'yes' : yes

### Process destruction ###
Killing process 'CFTLOG', pid 18210
Killing process 'CFTTCPS', pid 38966
Killing process 'CFTTPRO', pid 38438
Killing process 'CFTTCOM', pid 36388
Killing process 'CFTTFIL', pid 36268

### IPC destruction ###
Removing msg queue 61455
Removing msg queue 57360
Removing msg queue 98321
Removing msg queue 90130
Removing msg queue 233491
Removing shared memory 69638
Removing shared memory 36871
Removing semaphore 49167
Removing semaphore 49168
CFT stopped.
%

Note  
  • cftstop triggers a timeout each time a process required by Transfer CFT is shut down.
    Normally, this timeout is sufficiently long, but if transfers are in progress or the system has an excessive load or is an old system that is too slow, cftstop may generate a spurious error. If this happens, simply edit the cftstop shell and change the stop_timeout field at the beginning of the file to a suitable value (in seconds) to correspond to the DISCTD and DISCTS fields in your configuration.
  • When the system is delivered, cftstop does not automatically shut down the additional Transfer CFT elements such as SCOPE or Copilot by default.
    To customize cftstop operation, refer to Using Additional Elements.

cftupdate

The cftupdate utility is used to update the configuration.

Syntax

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

Notes:

  • 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

cftutil

The cftutil command submits a standard CFTUTIL instruction, but displays the results without a banner. In addition, if the command return code is non-null, a message is displayed.

Syntax

cftutil <command>

Use

% cftutil listcat type=z
CFTU26E LISTCAT _ Error (TYPE Bad value for parameter)
cftutil code 115
%

secinit

The secinit utility is used to initialize the Transfer CFT security environment.

Syntax

secinit [<filename> [<filename>...]]

Standard use

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

secinit my_config.cft

Advanced use

Several file names can be included in the command line. Normally, all Transfer CFT security parameters are declared in a single file. However, for organizational reasons, you may wish to separate the parameters into several files.

secinit start_my_config.cft the_rest.cft

Note  
  • If no file name is passed as a parameter, the program will request one or more file names
  • If no name is supplied, the program stops
  • When activated, secinit creates the security database

secupdate

The secupdate utility is used to update the Transfer CFT security environment.

Syntax

secupdate <filename> [<filename> ...]

This command should be considered to be an alias of SECUTIL @<filename> for each file name passed as a parameter in the command line.

 

Related Links