CFTRECV - Receive templates

This topic describes the   receive template. You can use this command to:

  • give the default name and local physical characteristics of the file to receive
  • define the default actions to perform locally during and after the transfer (translation, compression, call to a user EXIT, an end-of-transfer procedure...)
  • authorize the default time slot and default user associated with the transfers

Related topics

Parameter Description

COMMENT

Local alphanumeric comment associated with receive transfers.

CYCDATE

Upper final date for activating the first transfer of a cycle.

CYCTIME

Upper limit time for activating the first transfer of a cycle.

DELETE 

Automatic deletion of the catalog entries in the "X" phase (done) for the corresponding IDF.

EXIT

Identifier of the CFTEXIT command associated with this transfer.

FACTION

Action on the file for a receive transfer.

FBLKSIZE

This parameter (in bytes) controls the "blocking factor" of the receiver file records: according to the system, it defines the disk block size and/or the file input/output buffer size.

FCHECK

Checks record length attributes.

FCODE

Code of the receiver file data (local data code).

FDISP

Presence check indicator of the receiver file used to determine the action of the Transfer CFT monitor.

FKEYLEN 

Key length of an indexed file.

FKEYPOS

Key position relative to 0 in the record of an indexed file.

FLOWNAME The local flow descriptor.

FLRECL 

File record length in bytes.

FNAME

Name of the physical receiver file (filename or complete pathname) of the directory.

FORCE 

Determines the priority with which the parameters set in CFTRECV are taken into account relative to the parameters set in an associated RECV command.

FORG 

Organization of the file to be sent.

FRECFM 

Record format of the receiver file.

FSPACE 

Size of the receiver file, in K-bytes (1 K-byte = 1024 bytes).

FTYPE

Type of the receiver file.

GROUPID

Information completing the USERID of the CFTRECV command.

ID 

Local model file identifier (IDF).

MACTION 

Action on the files transferred by COPY at the time of creation.

MAXDATE

Transfer validity final date.

MAXTIME

Transfer validity limit time for the final date (MAXDATE).

MINDATE

Minimum transfer validity date.

MINTIME

Transfer initial validity time, from the first day (MINDATE).

NCOMP

Compression of on-line data requested by the receiver.

NETBAND

Select the outgoing port range.

NOTIFY

Defines the destination of the messages associated with the send transfer selected from the log file messages, by the value of the OPERMSG parameter.

OPERMSG 

Defines the categories of transfer information messages intended for the operator (all the messages also being written in the log file).

PRI

Receive request selection priority.

RUSER

Identifier of the file receiver user.

SOURCEAPPL The identifier of the local file sender application.

STATE 

Defines the transfer request state.

SUSER 

Identifier of the file sender user.

TARGETAPPL Identifier of the local file receiver application.

TCYCLE 

Transfer cycle period unit.

TRK 

Specification of how much detail Transfer CFT provides Sentinel about transfers. Transfer CFT sends detail about the transfers in the form of tracked instances.

USERID

Identifier of the transfer owner.

WFNAME 

Name of the temporary file used during the transfer.

XLATE 

Identifier of the translation table used for the receive transfers.

Examples

This section displays examples for a default receive template.

Example 1

CFTRECV

MODE = REPLACE,

 

ID = SRCFILES,

/* IDF for source files */

FDISP = BOTH

/* already exists or not */

FACTION = ERASE,

/* if exists erase */

XLATE = ETOA

/* with this table  */

The set of parameters corresponding to this command is used, during a data receive transfer, if the explicit value of the transfer IDF is "SRCFILES".
The monitor thereby has default values for receiver file management. The FNAME parameter is not defined. The monitor can consequently only operate if a RECV command specifying FNAME has been entered (Transfer CFT is requester), or if the partner (Transfer CFT is server) has specified the receiver file name (open mode for receive transfers).

Example 2

CFTRECV

MODE = REPLACE,

 

ID = IDFDEF,

/* default IDF */

FDISP = BOTH,

/* already exists or not */

FACTION = DELETE,

/* if exists - delete */

FNAME = &IDT

/* file as per IDT value */

This command corresponds to the data receive transfer case where the identifier (IDF) has no explicit description (CFTRECV object). This is the default receiver model file. The CFTPARM object must specify: CFTPARM DEFAULT = IDFDEF, ... Transfer CFT then creates a file whose name contains the unique transfer identifier.

IBM i: This command corresponds to the general database file receive transfer case.

Related Links