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:
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.
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:
The Restart Menu for the File Transfer Facility figure shows an example of restart 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.
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.
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.
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.
Each file transfer menu contains toggle and edit fields for choosing file transfer options.
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:
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. |