Configuring the environment

This topic describes how to configure the environment for an end-of-transfer type exit. Before you submit this EXIT, you must customize the following Transfer CFT objects:

Each CFTEXIT object corresponds to an EXIT task. The number of EXIT tasks of all types simultaneously active is limited to a number depending on the operating system.

An end of transfer EXIT task is activated in memory before the EXECxx submission call is deactivated, following a time-out or monitor shutdown.

Defining the CFTEXIT object

Syntax

CFTEXITID = identifier,
TYPE = EXEC,
[FORMAT = { V23 | V24 }]
[LANGUAGE = {COBOL | C},]
[MODE = {REPLACE | CREATE | DELETE},]
[PARM = string,]
[PROG = {CFTEXIT | string},]
[RESERV = string ]
[WAITTASK = {1441 | n}]

Parameter

Definition

ID 

(Mandatory)

Command identifier (32 +1). The value of this identifier corresponds to the identifier defined in the EXITEOT parameter of the related CFTPARM object.

FORMAT

Indicates the format for the communication area.

  • V23 (Default value): The communication area between Transfer CFT and user’s exits remains the same.
  • V24: The communication area takes into account the length of the new identifier.

LANGUAGE

Language in which the user program is written.

The possible values are COBOL and C language.

Transfer CFT uses this attribute to exchange data with the program using the EXIT via the structure best suited to the language in which it is implemented.

PARM 

Free user field (64 +1).

PROG  

Name of the executable module associated with the EXIT task (512 +1). This module is built from the interface provided with Transfer CFT linked to the program written by the user. In order to facilitate identification of the associated module, it is advised to name it CFTEXIE.

RESERV  

Size of the working area reserved for the user.

This area is not used by the Transfer CFT interface. You can use it to save data required for the processing of the program that you have written. This area is de-allocated when the Transfer CFT interface de-selects the file.

TYPE 

(Mandatory)

EXEC

WAITTASK  

Time during which a file access task is inactive (in minutes) before being shut down

Defining the CFTPARM object

Syntax

CFTPARM
ID = identifier,
[EXITEOT = identifier,]
....

Parameter

Definition

ID

(Mandatory)

CFTPARM object identifier.

EXITEOT 

EXIT identifier. To activate an end of transfer EXIT, you must specify an identifier that points to a CFTEXIT object.

 

Related Links