Transfer CFT 3.8 Users Guide Save PDF Selected topic Selected topic and subtopics All content 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 Command syntax CFTSEND Object concepts Default send templates Parameter Description ACKEXEC Name of the file describing the procedure to be executed when receiving an acknowledgement reply for the transfer. ARCHIVEFNAME The archived source file name after transfer completion if FACTION=ARCHIVE. Note The fname and archivefname must be on the same volume (all platforms). 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 preprocessing 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. If you are using FACTION=DELETE, see the FACTION parameter specifics. FBLKSIZE Block size of sent file. FCODE Code of the data to be sent. FDISP File sharing option. FILTER Defines the filter value to be used when filtering using method defined in filtertype. FILTERTYPE Defines the type of filter to be applied when sending a generic transfer. 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. IDA Local transfer identifier assigned by the user or user application. 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. Note When using SELFNAME and FACTION=DELETE, the FNAME must be a directory and not a MASK. For example, #dir is deleted, whereas #dir/* is ignored. 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 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 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 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, /* Activate possible */ /* first 3 days of */ /* week, before */ /* Wednesday 10:00 */ PARM = ’Day statistic’ /* Associated parameter.for.*/ /*PeSIT CFT profile */ Meets a specific cyclic send requirement. Related Links
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 Command syntax CFTSEND Object concepts Default send templates Parameter Description ACKEXEC Name of the file describing the procedure to be executed when receiving an acknowledgement reply for the transfer. ARCHIVEFNAME The archived source file name after transfer completion if FACTION=ARCHIVE. Note The fname and archivefname must be on the same volume (all platforms). 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 preprocessing 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. If you are using FACTION=DELETE, see the FACTION parameter specifics. FBLKSIZE Block size of sent file. FCODE Code of the data to be sent. FDISP File sharing option. FILTER Defines the filter value to be used when filtering using method defined in filtertype. FILTERTYPE Defines the type of filter to be applied when sending a generic transfer. 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. IDA Local transfer identifier assigned by the user or user application. 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. Note When using SELFNAME and FACTION=DELETE, the FNAME must be a directory and not a MASK. For example, #dir is deleted, whereas #dir/* is ignored. 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 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 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 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, /* Activate possible */ /* first 3 days of */ /* week, before */ /* Wednesday 10:00 */ PARM = ’Day statistic’ /* Associated parameter.for.*/ /*PeSIT CFT profile */ Meets a specific cyclic send requirement.