|
|
|
|
Setting host file transfer parameters provides step-by-step instructions for setting the host parameters so that you can transfer files using the menu interface, with notes on the differences for different host types. Following this is a section about starting the file transfer for each host type. For instructions for transferring files using the command line option, see Transferring Files from the Solaris Command Prompt.
Before starting a file transfer, you must set host file transfer parameters, which identify your host's operating system and specify the size and format of files to be transferred. You can set these parameters independently for each 3270 session.
File transfer parameters are stored in your style file. If you wish to keep the changed parameters for future use, use the File menu to save the current style (for more information, see Customizing 3270 Emulation).
To set host file transfer parameters, use the following procedure:
From the File Transfer dialog box, highlight the session you want to use.
Choose <Host Parameters>.
The dialog box in The Options for SESS
Modify the file transfer parameters as appropriate.
Choose <OK> to set parameters or <Cancel> to abandon any changes. Either action returns to the File Transfer dialog box.
Depending on the host type you choose as the first parameter in the Options for SESSnn dialog box, some of the remaining parameters in the dialog box may not be required. When you choose the host type, any parameters not applicable to this host type become not selectable.
In addition, some parameters are used only when sending files or only when receiving files, and are ignored otherwise.
File Transfer Parameters, lists the parameters in the dialog box, and shows for which tasks and for which host types they are used. Check the table to find which parameters you need to set for a particular file transfer.
Key:
This parameter is used for both Send and Receive.
This parameter is not used for this host type; the field is not selectable.
This parameter is used only for Receive . It is ignored for Send.
This parameter is used only for Send, when creating a new host file. It is ignored for Receive, or when replacing or appending to an existing host file.
The following list describes the fields in the Options for SESS nn dialog box. To set host parameters, complete the fields that apply to your host type and transfer type, as indicated in File Transfer Parameters.
Specify your host type as TSO, VM/CMS, or CICS.
Use this parameter only for text files. Mark the check box to convert files between EBCDIC format at the host and ASCII format at the Solaris computer.
When you choose this parameter, default values appear for the code pages
used for the translation (Host code page
is the EBCDIC code
page used by the host, and Local code page
is the ASCII code
page used by your Solaris computer).
If you started the 3270 emulation program with the option (indicating a user-defined translation table), the default in both edit boxes is
USER, which indicates that the user-defined translation table will be used. To override this translation, you must specify a code page in both edit boxes; you cannot set one of them and leave the other as
USER.
If you started the 3270 emulation program with the (international) option, the defaults are
037(host code page) and
8859(local code page). If you did not use either the or options, the defaults are
037(host code page) and
437(local code page). If you need to use a different host code page or local code page, specify the correct ones here (for more information, see Supported Code Pages). The entry
USERis not valid if you did not start the program with the option.
Check this box to remove line-feed (LF) characters from any Solaris text file sent to the host, or to add them to any Solaris text file received from the host. Use this option for standard text files.
Check this box if the transferred data (using Send or Receive) is to be added to the end of an existing target file. For a CICS host, this parameter is valid only for Receive, and is ignored for Send.
If you do not select this parameter, the target file is overwritten.
Choose Default, Fixed, Variable, or Undefined to specify how individual records are structured. The value Undefined is valid only for TSO.
The Default option is equivalent to Variable if the Strip/Add LF from each line parameter is selected, and to Fixed if it is not selected. Choose Default unless you are sending data to an application that requires a specific record format.
If you specified Host record format as Fixed, specify the length (in bytes) of the records to be created. If you specified Host record format as Variable, specify the maximum length (in bytes) of the records to be created. In both cases, the default is 80 bytes.
A TSO host groups records into blocks; the default block size is the same as the record length (one record per block). If you need to block records into larger groups, specify the block size you want to use.
Specify one of the following units of measure used for record size in the file to be created:
If you specified
Specify the amount of space, in
Specify the number of additional units of space you want to allocate if the amount specified in the Initial units of space parameter is insufficient to hold the file.
When you have finished setting the parameters, choose <OK> to save the parameters, or choose <Cancel> or press Esc to abandon the changes and return to the previous settings.
You can also save any changes you have made to these parameters in your style file for future use, using the File menu. For more information, see Customizing 3270 Emulation.
Once you have set file transfer parameters, you are ready to send or receive files. For more information, see Transferring Files with an MVS/TSO Host, Transferring Files with a VM/CMS Host, or Transferring Files with a CICS Host.
To transfer files, highlight an active session in the File Transfer
dialog box and choose <Start transfer>.
(An error message is displayed if you try to start transfer on an inactive
session.) The dialog box shown in Transfer TSO File on SESS
You cannot communicate with the host on this session, or transfer another file, while the file transfer is in progress; the Wait for File Transfer message
X ( ) FTis displayed on the status line until the transfer has finished. For more information about status line messages, see Status Line Information.
The following list describes the fields of the Transfer TSO File on SESSnn dialog box. Before transferring files, enter the required information.
Choose Send to transfer a named Solaris file to the host, or Receive to transfer a host data set to the Solaris computer.
The name of the Solaris file sent to the host or the Solaris file receiving data from the host. This can be any valid Solaris file name. If the file is not in the current directory, specify the full path (not a relative path).
The name of the data set to which a named Solaris file is sent, or the data set from which data is received. If you supply a fully qualified name (that is, the first element of the name is a user ID), enclose the complete name in single quotation marks.
Optionally included name of the member within the host partitioned data set to which a named Solaris file is sent, or from which data is received by the Solaris file. If the host data set is not a partitioned data set, this parameter is not required.
If you are sending a file to a partitioned data set, the data set must already exist on the host. The file transfer program cannot create a new partitioned data set.
Optionally included password used to access the host data set. If the host data set is not protected by a password, this parameter is not required.
If your host file transfer program requires any other parameters or options that are not included in the Options for SESSnn dialog box, enter them here in the format expected by the host program. Your System Administrator or host support personnel can provide you with information about any additional parameters required here. If you do not need to use any additional parameters, leave this edit box blank.
Choose <OK> to begin sending or receiving. Choose <Cancel> to abandon the file transfer process.
To transfer the file, use the following procedure:
Enter appropriate information in the fields of the Transfer TSO File on SESSnn dialog box.
Choose <OK> to transfer the file.
To monitor progress of the file transfer, view the File Transfer dialog box and read the information in the Status, Transfer Status, and Messages for File Transfer with SESSnn fields. To see an example of the File Transfer dialog box, see File Transfer Dialog Box.
To start a file transfer, highlight a session in the File Transfer dialog
box and choose <Start transfer>.
The dialog box shown in Transfer VM/CMS on SESS
You cannot communicate with the host on this session, or transfer another file, while the file transfer is in progress; the Wait for File Transfer message
X ( ) FTis displayed on the status line until the transfer has finished. For more information about status line messages, see Status Line Information.
The following list describes the fields of the Transfer VM/CMS File on SESSnn dialog box:
Choose Send to transfer a named Solaris file to the host, or Receive to transfer a host file to your Solaris computer.
The name of the Solaris file sent to the host or the Solaris file receiving data from the host. This may be any valid Solaris file name. If the file is not in the current directory, specify the full path (not a relative path).
The host file to which the data is sent, or the file received from the host.
The VM/CMS file mode of the host file. This parameter is optional; if you do not specify it, the default A1 is used.
If your host file transfer program requires any other parameters or options that are not included in the Options for SESSnn dialog box, enter them here in the format expected by the host program. Your System Administrator or host support personnel should provide you with information about any additional parameters required here. If you do not need to use any additional parameters, leave this edit box blank.
Choose <OK> to begin sending or receiving a file. Choose <Cancel> to abandon the file transfer process.
To transfer the file, use the following procedure:
Enter appropriate information in the fields of the Transfer VM/CMS File on SESSnn dialog box.
Choose <OK> to transfer the file.
To monitor progress of the file transfer, view the File Transfer dialog box and read the information in the Status, Transfer Status, and Messages for File Transfer with SESSnn fields. To see an example of the File Transfer dialog box, see File Transfer Dialog Box.
To start a file transfer, highlight a session in the File Transfer dialog
box, and choose <Start transfer>.
The dialog box shown in Transfer CICS File on SESS
You cannot communicate with the host on this session, or transfer another file, while the file transfer is in progress; the Wait for File Transfer message
X ( ) FTis displayed on the status line until the transfer has finished. For more information about status line messages, see Status Line Information.
The following list describes the fields of the Transfer CICS File on SESSnn dialog box:
Select Send to transfer a named Solaris file to the host, or Receive to transfer a host file to the Solaris computer.
The name of the Solaris file sent to the host or the Solaris file receiving data from the host. This may be any valid Solaris file name. If the file is not in the current directory, specify the full path (not a relative path).
This is the host file to which the data is sent, or the file received from the host.
You can add a comment when sending a file; it is written to the first record of the host file. Comments are not valid when receiving a file. The comment may be up to 80 characters, although some hosts may impose a lower limit.
If your host file transfer program requires any other parameters or options that are not included in the Options for SESSnn dialog box, enter them here in the format expected by the host program. Your System Administrator or host support personnel should provide you with information about any additional parameters required here. If you do not need to use any additional parameters, leave this edit box blank.
Choose <OK> to begin sending or receiving the file, or <Cancel> to abandon file transfer.
To transfer a file, use the following procedure:
Enter appropriate information in the fields of the Transfer CICS File on SESSnn dialog box.
Choose <OK> to transfer the file.
To monitor progress of the file transfer, view the File Transfer dialog box and read the information in the Status, Transfer Status, and Messages for File Transfer with SESSnn fields. To see an example of the File Transfer dialog box, see File Transfer Dialog Box.
|
|
|
 |
|