Recording mode for statistical data

The CFTACCNT object defines the recording mode for statistical data of correctly terminated transfers.

Related topics

About the CFTACCNT object

Two recording modes are available:

  • Recording data in Transfer CFT files. When the primary file is full, Transfer CFT switches to an alternate file. This mode is available on all operating systems.
  • Recording data in the files of the operating system accounting utility.

The CFTACCNT object can be permanently deleted from the configuration. Once the CFTACCNT is deactivated, it appears grey in the left pane object manager. For more information refer to Deleting the CFTACCNT (GUI) object.

In addition to defining the CFTACCNT object, for the statistical mode to operate, you must define the CFT ACCNT parameter in the CFTPARM object.

CFTACCNT is used to define the recording mode of the statistical data for correctly terminated transfers, that is transfers that are in the T or X state. This command is taken into account when the ACCNT parameter of the CFTPARM command is defined.

Transfer CFT authorizes only one identifier of the CFTACCNT type.

Two recording modes can be used, depending on the system:

  • Recording of data in Transfer CFT files
    In this case, the CFTACCNT command defines the names of the files receiving the data and their management (parameter setting TYPE = FILE). This mode is available on ALL SYSTEMS.
  • Recording of data in the files of the accounting utility of the operating system in question parameter setting TYPE = SYST. This mode is only available on z/OS (MVS) systems.

For more information on the TYPE parameter in the statistical recording mode, see Recording mode TYPE.

For each transfer terminated, the Transfer CFT records the information contained in the following table.

CFTACCNT list of headings

Heading

Offset

Transfer mode (server or requester) 

0

Transfer direction 

1

Transfer type (File, Message or Reply message)  

2

Immediate partner identifier (PART) 

3

Sender identifier (SPART) 

36

Receiver identifier (RPART) 

69

Identifier of the sending user application (SUSER) 

102

Identifier of the receiving user application (RUSER) 

135

Model file identifier (IDF) 

168

Local application identifier (IDA) 

201

Transfer identifier (IDT) 

234

Number of records sent 

243

Number of characters in the file (FBYTE)

254

Number of characters sent over the line (NBYTE)

265

Date and time of command entry in the catalog 

276

Date and time of start of transfer 

294

Date and time of end of transfer 

312

Transfer duration (in seconds) 

330

Broadcasting list indicator 

337

Application protocol identifier 

338

Transfer owner identifier (USERID) 

371

Group identifier (GROUPID) 

404

On line data compression rate 

437

File record maximum size (FLRECL) 

440

File (FRECFM) 

446

Protocol compression code (NCOMP) 

447

Name of the file sent (FNAME) 

450

Transfer CFT private parameter (PARM) 

963

Sender application identifier (SAPPL) 

1476

Receiver application identifier (RAPPL) 

1525

Partner group (GROUP) 

1574
Number of characters in the file (FBYTE_EXTENDED) 1607
Number of characters sent over the line (NBYTE_EXTENDED) 1623
Unused 1639

Total

2048

Recording mode TYPE

This section describes the parameters to define the type of recording mode. You can select from either the saving the recorded information in a file, or in the system. Declaring where to save transfer information is defined in the TYPE parameter.

Setting TYPE to FILE

When you define the Type parameter to File in the CFTACCNT object, you must define the following parameters as well.

  • afname
  • exec
  • fname
  • maxrec
  • switch

The Transfer CFT statistical file is full when the maximum number of records, the MAXREC parameter, is reached. When this happens, the Transfer CFT switches to an alternate file and executes the procedure defined by the EXEC parameter.

The SWITCH operating command also allows the operator to manually switch the statistical file on request.

Transfer CFT requires at least 1 empty statistical file at the time it is activated. If the first file designated by FNAME is not empty, Transfer CFT switches to the second file labeled AFNAME. The procedure associated with the switching can regenerate an empty file.

The statistical files must be created before the Transfer CFT is activated. This operation is performed in the command CFTFILE TYPE = ACCNT.

When you shut down Transfer CFT, using the SHUT command, Transfer CFT executes the switching procedure to empty the last statistical file in process.

Setting TYPE to SYST

When you define the Type parameter as SYST in the CFTACCNT object, you must define the ACCID parameter as well.

The CFTACCNT command references the Transfer CFT application via the utility.

Protocol Details

GCOS7, MVS (z/OS)

The ACCID parameter identifying the Transfer CFT application must be defined.

Related Links