[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Files Reference


Options and Flags for HCON File Transfer Header Files

The fxfer.h and fxfer.inc header files have the fxc structure in common. This structure defines options used by both the C and Pascal header file.

C and Pascal Options

The options in the C structures and Pascal record declarations for the File Transfer Program Interface are:

f_logonid Contains the host login ID string. This value should contain the host login ID, the AUTOLOG node ID, and two optional AUTOLOG parameters, all separated by commas. This list is passed to the automatic login procedure.

At run time, the operator is asked to enter a password. The host login session is maintained for subsequent file transfers, eliminating the need to log in again. The file transfer wait period in the HCON session profile variable determines the length of time the login session is maintained.

f_inputfld Specifies a host input field. This option enables the user to place host file transfer program (IND$FILE) options on the host file-transfer program command line. It also allows the user to place comments within the command. This option is valid only for CICS and VSE hosts.
f_aix_codepg Specifies an alternate code set to use for an ASCII-to-EBCDIC or EBCDIC-to-ASCII translation. If this field is null, the ASCII code set is extracted from the system locale.
FXC_APPND Appends the file specified by the source file to the destination file if the destination file exists when the FXC_APPND flag is set in the fxc_opts.f_flags field. This option is ignored if the destination file does not exist. This option is not valid when uploading to a CICS or VSE host.
FXC_CICS Specifies the host as CICS/VS when the FXC_CICS flag is set. The user must specify the correct host operating system. The file-transfer program does not distinguish between the four host operating systems.
FXC_CMS Specifies the host as VM/CMS when the FXC_CMS flag is set in the fxc_opts.f_flags field. The user must specify the correct host operating system. The file-transfer program does not distinguish between the four host operating systems.
FXC_DOWN Downloads the file from a host file to a file when the FXC_DOWN flag is set in the fxc_opts.f_flags field.
FXC_QUEUE Executes the file transfer asynchronously as a background process when set in the fxc_opts.f_flags field. If any file transfers have not completed, the current transfer request is queued. If this option is not specified, the file-transfer operation is synchronous.
FXC_REPL Replaces an existing file on the host (upload) or replaces an existing file (download) when the FXC_REPL flag is set in the fxc_opts.f_flags field. When uploading to a CICS host, this option is the default.
FXC_TSO Specifies the host as MVS/TSO (Multiple Virtual Storage/Time Sharing Option) when set in the fxc_opts.f_flags field. The user must specify the correct host operating system. The file-transfer program does not distinguish between the four host operating systems.
FXC_TNL Translates EBCDIC to ASCII when downloading files, if set in the fxc_opts.f_flags field. During uploading, the FXC_TNL option translates ASCII to EBCDIC. This option assumes the file is a text file and is used when transferring formatted text files. The default is no translation. The new-line character is the line delimiter.
FXC_TCRLF Performs the same function as the FXC_TNL option when set in the fxc_opts.f_flags field, except that the line delimiter is the carriage return/line-feed (CR-LF) character sequence. This option is used to translate PC-DOS files. A PC-DOS end-of-file character is inserted at the end of the downloaded file.

Note: If neither the FXC_TNL nor the FXC_TCRLF option is specified, the file transfer assumes no translation and transfers the data in binary form. When transferring a binary file to the host, the host file-transfer program defaults the host file to a fixed record format. If the user wishes not to have the host file padded with blanks at the end, the FXC_VAR option should be specified to delineate a variable record format.
FXC_UP Uploads the file from the operating system file to the host file when set in the fxc_opts.f_flags field.
FXC_VSE Specifies the host as VSE/ESA (Virtual Storage Extended/Enterprise Systems Architecture) or VSE/SP (VSE/System Product) when set in the fxc_opts.f_flags field. The user must specify the correct host operating system. The file transfer program does not distinguish between the four operating systems.

Host File Flags

The following flags specify host file characteristics. They can be used only to upload files, with the exception of the FXC_FIXED option, which can be used when downloading from a VSE host.

f_blksize Specifies the nonzero block size of the host data set. This option is only used in the MVS/TSO environment. For new files, the default is the logical record length. This flag is ignored if the file is being appended.
f_lrecl Specifies the nonzero logical record length of the host file. For new files, the default is 80. For variable-length records, the f_lrecl field is the maximum size of the record. This field is ignored if the file is being appended. If using this option while uploading to a CICS or VSE host, the FXC_FIXED option flag must also be specified.
FXC_FIXED Specifies fixed-length records when set in the fxc_opts.f_flags field. This is the default if none of the following flags are set: FXC_VAR, FXC_TNL, and FXC_TCRLF. This flag is ignored if the file is being appended. If specifying this option while uploading to a CICS or VSE host, either the FXC_TNL or the FXC_TCRLF option flag must be specified. If this option is specified when downloading from a VSE host, all trailing blanks are downloaded. The default option when downloading a translatable file from a VSE host causes all trailing blanks to be deleted.
FXC_UNDEF Specifies records of undefined length when set in the fxc_opts.f_flags field. This option can only be used in the MVS/TSO environment and is ignored if the file is being appended.
FXC_VAR Specifies variable-length records when set in the fxc_opts.f_flags field. This is the default if the FXC_FIXED flag is not set and either the FXC_TNL or the FXC_TCRLF flag is set. This flag is ignored if the file is being appended.
s_space Specifies the non-zero number of units of space to be allocated for a new data set. This option can only be used in the MVS/TSO environment. The s_space field has the following optional subfields:
s_increment Specifies the number of units of space to be added to the data set each time the previously allocated space is filled.
s_unit Specifies the unit of space. A value of FXC_TRACKS indicates the unit of allocation is tracks. A value of FXC_CYLINDERS indicates the unit of allocation is cylinders. Otherwise, the s_space field specifies the average block size (in bytes) of the records to be written to the data set. If the s_space field has a value of zero, the default unit of allocation is the value specified by the f_blksize field. If the f_blksize field is not specified, the host file-transfer program uses the default value of 80.

Related Information

The cfxfer function, fxfer function, g32_fxfer function.

The fxfer command.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]