Configuring the environment

This topic describes how to configure the environment for a directory type exit. Before you submit a directory type EXIT, you must customize the following Transfer CFT objects:

  • CFTPROT defines both the application protocol type and profile
  • CFTEXIT describes the EXIT environment and how this EXIT is activated

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.

EXIT type directory tasks are activated in memory when Transfer CFT is started and de-activated when the monitor is shut down.

Defining the CFTPROT object

The parameters mentioned here are the ones that are specific to this EXIT.

Syntax

CFTPROT
ID = identifier,
...
[EXITA = identifier,..,]
....
[DYNAM = identifier,]
     ...

Parameters

ID = identifier

Protocol identifier.

[ EXITA = identifier]     

Directory EXIT identifier.

To activate a directory type EXIT for the protocol considered, an EXIT identifier of this type should be indicated. There can only be one directory type EXIT task per protocol command.

The directory type EXIT identifier can include the symbolic variable &NPART:(EXITA = (&NPART, ...) where NPART designates the remote partner network name.

DYNAM  = identifier

Identifier of the dynamic partner in server mode.

The value of this identifier corresponds to that of the model CFTPART object ID parameter.

Defining the CFTEXIT object

Syntax

CFTEXIT
ID = identifier,
TYPE = ACCESS,
[FORMAT = { V23 | V24 }]
[LANGUAGE = {COBOL | C},]
[MODE = MODE,]
[PARM = string,]
[PROG = {CFTEXIT | string},]
[RESERV = {1024 | n}]

Parameters

ID = identifier

Command identifier.

The value of this identifier corresponds to the identifier defined in the EXITA parameter of the related CFTPROT object.

[ FORMAT = V23 | V24 ]

Optional parameter. Indicates the format for the communication area.

  • V23 (Default value)
  • V24

[ LANGUAGE = {COBOL | C}]

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 = string64]

Free user field.

[ PROG  = {CFTEXIT | string512}]

Name of the executable module associated with the EXIT task.

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

[ RESERV  = { 1024 | n}]     {0 ...1024}    

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 = ACCESS

EXIT type.

Related Links