CFTSEND - Send template

This topic describes how to define the CFTSEND template. Use this command to SEND a file or files to a partner.

Related topics

Parameter Description
ACKEXEC Name of the file describing the procedure to be executed when receiving an acknowledgement reply for the transfer.

COMMENT

Local alphanumeric comment associated with the send transfer.

CYCDATE

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

CYCLE

Number of units defining the transfer cycle period.

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.

EXEC

Name of the file describing the procedure to be executed on completion of the transfer.

EXECSUB

Submission policy of the end-of-transfer procedure, when sending a group of files.
EXECSUBA Submission policy of the procedure to launch receiving acknowledgement, when sending a group of files.
EXECSUBPRE Submission policy of the pre-processing procedure, when sending a group of files.

EXIT

Identifier of the CFTEXIT command associated with this transfer.

Used to activate a file EXIT user task. The value of this parameter may be equal to the symbolic variable &IDF.

FACTION

Action on the file after a send transfer.

FBLKSIZE

Block size of sent file.

FCODE

Code of the data to be sent.

FDISP

File sharing option.

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 local file, directory, indirection file, selection mask or selection directory to be sent.

See also Additional filename information

FORCE

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

FORG 

Organization of the file to be sent:

  • SEQ: sequential
  • INDEXED: indexed
  • DIRECT: relative direct access

FRECFM

Record format of the file to be sent:

  • F: fixed
  • V: variable,
  • U: undefined

FSPACE 

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

FTYPE

Type of local file to be sent. Also see the NTYPE parameter.

GROUPID

Information completing the USERID of the CFTSEND command.

ID 

Local identifier of the model file (IDF) to be sent.

IMPL

Implicit send.

MAXDATE

Transfer validity final date.

MAXTIME

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

MINDATE

Minimum transfer validity date.

Only taken into account in requester mode

NBLKSIZE

File block size, in protocol terms.

NCODE 

Sent data code.

NCOMP

Compression of on-line data required by the sender.

NETBAND

Select the outgoing port range.

NFNAME

Name of the physical file sent to the receiver partner.

NKEYLEN

Length (in bytes) of the key of an indexed file.

NKEYPOS

Location (in bytes) of the key in the records of an indexed file.

NLRECL

For records of:

  • Fixed format (FRECFM = F): size in bytes of the records of the receiver file
  • Variable format (FRECFM = V): maximum size in bytes of the records

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.

NRECFM

Format of the records of the file defined in protocol terms.

NTYPE 

File type, in protocol terms.

OPERMSG 

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

PARM 

User parameter sent to the receiver.

PREEXEC Name of the file describing the procedure to be executed before the transfer, as per the preprocessing phase.

PRI

Send request selection priority.

RUSER

Identifier of the file receiver user.

SELFNAME 

Name of the file that contains the list of files selected for sending.

SOURCEAPPL The identifier of the local file sender application.

SPART 

Network designation by which the local Transfer CFT monitor identifies itself to its partner.

STATE

Defines the transfer request state.

SUSER 

Identifier of the file sender user.

TARGETAPPL Identifier of the local file receiver application.

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 to send a group of files selected in line with the generic name specified in FNAME.

XLATE 

Identifier of the translation table used for send transfers relative to this model file.

Additional filename information

In the sender server with implicit send operating mode, the use of the FNAME parameter is mandatory in CFTSEND.

In sender requesteror sender server mode with a hold for sending request, the filename can be defined in the send transfer request (SEND command or CFTAPI call) rather than in the CFTSEND object. Click on the links in the following table for examples and details.

Format 

Processing 

FNAME = filename 

Sends a file or a version of a file 

FNAME = {mask | dirname} 

Lists a directory 

FNAME = #filename  

Sends a group of files, the list of which is located in the specified file 

FNAME = {#mask | #dirname} 

Sends a group of files selected in line with the generic name specified (#mask)

Sends all files in the directory specified (#dirname) 

Examples

This section provides examples on how to define the CFTSEND template.

Implicit send example

CFTSEND

MODE = REPLACE,

 

ID = SNDIMPL,

/* IDF implicit send transfers */

IMPL = YES,

 

FCODE = EBCDIC,

/* EBCDIC data in file */

FNAME = ’JSTATI’

/* called ... */

Only used if:

  • The value of the transfer IDF is SNDIMPL
  • Transfer CFT responds to a send request from the partner, where Transfer CFT is the sender server
  • There is no SEND request for this IDF pending in the catalog
  • An implicit send mechanism is involved where IMPL = YES

Default description of the model file example

CFTSEND

MODE = REPLACE,

 

ID = IDFDEF,

/* default IDF */

IMPL = NO,

 

FCODE = ASCII

/* EBCDIC data in file */

Corresponds to a send transfer when the SEND command specifies an IDF not described by a CFTSEND object. This is the default description of the model file to be sent. The CFTPARM object must specify:

CFTPARM

DEFAULT = IDFDEF, ...

The SEND command specifies the name of the file to be sent, the FNAME parameter.

Cyclic send example

CFTSEND

MODE = CREATE,

 

ID = STAT,

/* File identifier */

FLRECL = 128,

* of max length 128 bytes */

FACTION = DELETE

/* Delete after send */

FCODE = ASCII,

/* File coding */

MINDATE = 19920703,

/* From 03/07/92 */

MINTIME = 1000,

/* at 10:00 (Monday) */

MAXDATE = 19921231,

/* Until 31/12/92 */

MAXTIME = 2000,

/* at 20:00 */

CYCLE = 7

/* Every week */

TCYCLE = DAY,

/* CYCTIME takes the value 1000 */

CYCDATE = 19920705,

/* Activation possible */
/* the first 3 days of */
/* the week, before */
/* Wednesday 10:00 */

PARM = ’Day statistic’

/* Associated parameter.for.*/
/*PeSIT CFT profile */

Meets a specific cyclic send requirement.

Related Links