[ Previous | Next | Contents | Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

HCON Utility Program File Transfer Facility

Use the HCON utility program to issue explicit file transfer requests from a menu-driven interface. Upload or download files to either a VM/CMS, MVS/TSO, CICS/VS, VSE/ESA, or VSE/SP host. Enter the information needed for the file transfer on the File Transfer menu screen.

Before entering the file transfer facility, you must have started an HCON session with the e789 or xhcon command, and you must be logged on to the host from either the command line or by using the utility program logon facility.

Note: To issue an implicit file transfer, use the fxfer command.

The file transfer facility uses seven screens and menus:

Many of the file transfer menus contain fields for choosing transfer options. These fields are described in "Transfer Fields for the CICS, CMS, VSE, and TSO Menus". For more information about file transfers, refer to:

Session Profile Prompt Screen

The Session Profile Prompt screen requests an HCON session profile name from the session configuration used to read in the default information for the file transfer. The session name defaults to the value of the $SNAME environment variable. If the $SNAME environment variable is not set, the letter a is the default session name. The name entered must specify a valid profile owned by the current user. If the session profile does not exist, another session profile name is requested through an error message.

The Session Profile Prompt screen for the File Transfer Facility figure shows an example profile screen.

Restart Menu

The Restart menu displays when you enter the Utility Program File Transfer facility while a RESTART file is in the $HOME directory. The Restart menu displays the choices for the RESTART file. Highlight a choice and press the Enter key to accept the choice. The Restart menu displays the following options:

Transfer the RESTART file The current restart information becomes the default and displays on the transfer screens. The RESTART file is deleted after the information it contains is processed.
Defer the RESTART file The RESTART file is ignored. The session profile information is used as the default information on the transfer screens.
Discard the RESTART file The RESTART file is deleted. The information from the session profile is used as the default information on the transfer screens.

The Restart Menu for the File Transfer Facility figure shows an example of restart menu.

CMS Menu

The CMS menu allows the input of parameters to use for a file transfer. To execute the file transfer, press the Enter key. The Transfer Fields section discusses the fields in this menu. The CMS Menu for the File Transfer Facility in an SBCS Environment figure shows an example menu for file transfers to and from a CMS host.

The CMS Menu for the File Transfer Facility in a DBCS Environment figure shows an example menu for file transfers to and from a CMS host.

TSO Menu

The TSO menu is similar to the CMS file transfer menu, but has five additional fields. Use these additional fields to specify information unique to the TSO system. The TSO Menu for the HCON File Transfer Facility in an SBCS Environment figures show example menus for file transfers to a TSO host.

The first TSO/SBCS Menu figure shows page 1 of 2 of the TSO Menu in an SBCS environment, containing the options Host type through Operating System Code Set.

The second TSO/SBCS figure shows page 2 of 2 of the TSO Menu in an SBCS environment, containing the options Block Size and Space allocation.

The TSO menu for the File Transfer Facility in a DBCS Environment figures show example menus for a file transfer to a TSO host. The first TSO/DBCS figure shows page 1 of 2 of the TSO menu in a DBCS environment, containing the options Host type through Release.

The second TSO/DBCS figure shows page 2 of 2 of the TSO menu in a DBCS environment, containing the options Block size through Operating System Code Set.

CICS Menu for CICS/VS and VSE Menu for VSE/ESA

The CICS and VSE file transfer menus are the same as the CMS file transfer menu, except for the Transfer Fields for the CICS, CMS, VSE, and TSO menus. The CICS file transfer can be used for CICS/MVS and CICS/VSE. The VSE option can be used for VSE/ESA or CICS/VSE. The CICS menu for the File Transfer Facility in an SBCS Environment figure shows an example menu for a file transfer to a CICS host.

The CICS Menu for the File Transfer Facility in a DBCS Environment figure shows an example menu for a file transfer from a CICS/VS host.

File Transfer Message Window

The file transfer pop-up window displays the status of a file transfer request. This pop-up window displays after the file transfer completes. The message contains the status of the file transfer request along with any appropriate error messages. The File Transfer Message Window for the File Transfer Facility figure shows an example of the window.

For VSE/ESA, the host error message displays at the host screen. For more information about host error messages, see the IBM VSE/ESA Messages and Codes.

Transfer Fields for the CICS, CMS, VSE, and TSO Menus

Each file transfer menu contains toggle and edit fields for choosing file transfer options.

Toggle Fields

The toggle fields have a limited number of values. Use the Left Arrow and Right Arrow keys to move between the values within the menu. The toggle fields are:

Host type Specifies the type of host the data transfers to or from. The type of host also determines which fields appear on the transfer screen. The default is the value of the Host Type characteristic in the session profile.
Transfer direction Specifies whether the transfer sends a file from the local system to the host (up ) or from the host to the local system (down ). The default is the value of the File Transfer Direction characteristic in the session profile.
Translation Specifies the type of translation the file transfer should perform on the file. In an SBCS environment, there are three choices: no (the default), text , and DOS . In a DBCS environment, there are two choices: no (the default) and yes .
CRLF The CRLF field is only valid in a DBCS environment. CRLF specifies the CR (carriage return) and LF (line-feed) characters handling methodology. The following three choices are available:
no No CRLF handling. No is the default.
AIX For an AIX file type in an uploading file transfer, CRLF appends LF characters to the CR character sequence. In a downloading file transfer, CRLF removes the LF characters from the CRLF character sequence.
DOS For a DOS file type in an uploading file transfer, CRLF removes the EOF designator. In a downloading file transfer, CRLF adds an EOF code (0x1A) as an end-of-file designator.
Replace Specifies whether to replace the destination file with the new file if the destination file exists. The default is no .
Append Specifies whether to append the transferred file to the destination file if the destination file exists. The default is no .
Record type Specifies the type of host file format to use for the transferred file. On a VSE/CICS/CMS screen, the choices are defaultvariable , and fixed . On a TSO menu, one additional choice exists: undefined . The default is default . This field is valid only on upload file transfers. It is ignored on download file transfers, with the exception of fixed on a VSE screen, where trailing blanks are downloaded.
Space allocation Defines the amount of space to allocate for the host file. This field is valid only on upload file transfers. It is ignored on all download file transfers. The valid values are host default (the default) and user input .

This field is only available on TSO file transfer requests. For the user input value, the user must also fill in the edit fields for Quantity , Increments , and Type .

Alternate language Specifies an alternate host code page for JISCII-EBCDIC translation. If the field is no , the language used for translation is defined by the Language characteristic in the session profile. If the field is yes , the language used for translation is the alternate Japanese language.

For example, if the Language characteristic in the session profile is JPK (Japanese katakana), a yes will use Japanese-English to translate the file. Specify this option when the Translation field is text or DOS . This field is only available in a Japanese language environment.

SO/SI Specifies SO/SI option usage. When you select the SO/SI option, the following fields are provided:
Upload SO/SI characters are not inserted in DBCS fields.
Download Replaces SO/SI characters with control characters (0x1E/0x1F) in DBCS fields. This field is only available on file transfer requests in a DBCS environment.
Blank Specifies that blanks are not deleted at the end of each record when this option is specified. This option can be specified when the Translation field is yes . This field is only available in a DBCS environment.
Delete Deletes the temporary storage queue at the completion of the file transfer. This field is only available on CICS file transfer requests and is only available in a DBCS environment.
Release Releases unused records in the data set at the completion of the file transfer. This field is only available on TSO file transfer requests and is only available in a DBCS environment.
Operating System Code Set Specifies an alternate code set to use for ASCII-EBCDIC translation. The default code set is specified by the system locale that can vary from shell to shell. Each shell can have an individually set locale permitting the use of several code pages. The following code sets are supported:
Default Uses current local system ASCII code page.
IBM-850 Uses IBM code page 850 for translation in an SBCS environment.
IBM-932 Uses IBM code page 932 for translation in a DBCS environment.
ISO8859-1 Uses ISO 8859-1 Latin alphabet number 1 code page.
ISO8859-7 Uses ISO 8859-7 Greek alphabet.
ISO8859-9 Uses ISO 8859-9 Turkish alphabet.
IBM-eucJP Uses IBM Extended UNIX Code for translation in the Japanese language environment.
IBM-eucKR Uses IBM Extended UNIX Code for translation in the Korean language environment.
IBM-eucTW Uses IBM Extended UNIX Code for translation in the Traditional Chinese language environment.

Edit Fields

Enter the information to answer the prompt in the following edit fields of each menu:

Source file name Names the file to be transferred. If the transfer direction is down , this is the name of a host file. If the transfer direction is up , then this is the full path name of a file. The maximum size of this field is 1024 characters. This is a required field; the default value is blank.
Destination file name Names the file to be created, replaced, or appended. If the transfer direction is up , this is the name of a host file. If the transfer direction is down , this is the full path name of a file. The maximum size of this field is 1024 characters. This is a required field; the default value is blank.
Logical record length Gives the logical record length of the host file. This option is valid only on upload file transfers and is ignored on download file transfers. The maximum size of this field is five characters. The default value is 80 .
Block size Gives the host block size. This field is valid only on upload file transfers and is ignored on download file transfers. This field is only available on TSO file transfer requests. The default value is 80 .
Quantity Specifies the number of units of space to be added initially. Only a positive integer can be specified. This field is only available on TSO file transfer requests and need not be filled in unless the value of the Space allocation field is user input . The default value is 0 .
Increments Specifies the number of units of space to be added to the data set each time the previously allocated space is filled. This field is only available on TSO file transfer requests and need not be filled in unless the value of the Space allocation field is user input . The default value is 0 .
Type Defines the unit used for space allocation and may be T for tracks, C for cylinders, or a number specifying the average block size (in bytes) of the records to be written to the data set. This field is only available on TSO file transfer requests and need not be filled in unless the value of the  Space allocation field is user input . The default value is T.
Host Options Lists the file transfer options passed to the host without error checking by the local system. The maximum size of this field is 64 characters.
Volume Specifies the volume serial number of the host disk for data set allocation. This field is only available on TSO file transfer requests and is only available in a DBCS environment.
Unit Specifies the unit of the host disk for data set allocation. This field is only available on TSO file transfer requests and is only available in a DBCS environment.

[ Previous | Next | Contents | Search ]