 |
» |
|
|
|
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
HP-UX Command Prompt”. Setting Host File Transfer Parameters | |
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 Chapter 6 “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 Figure 5-2 “The Options for SESSnn
Dialog Box”
is displayed. 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 some are used only for double-byte
languages. These parameters can still be set in all cases, but are
ignored when they do not apply. Table 5-1 “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. Table 5-1 File Transfer Parameters | Parameter | Host
TSO | VM/CMS | CICS |
|---|
| Host | X | X | X | | EBCDIC to ASCII
conversion | X | X | X | | Strip/Add LF
from each line | X | X | X | | Add to end of
existing file | X | X | R | | Host record format | S | S | - | | Host record length | S | S | - | | Host block size | S | - | - | | Send SO | S | S | S | | Receive NOSO | R | R | R | | Units of space | S | - | - | | BLOCKS: Average
block size for file (bytes) | S | - | - | | Initial units
of space | S | - | - | | Incremental units
of space | S | - | - |
Key: - X
This parameter is used for both Send and Receive. - -
This parameter is not used for this host type; the
field is not selectable. - R
This parameter is used only for Receive. It
is ignored for Send. - S
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
SESSnn dialog box. To set host parameters,
complete the fields that apply to your host type and transfer type,
as indicated in Table 5-1 “File Transfer Parameters” - Host
Specify your host type as TSO, VM/CMS, or CICS. - EBCDIC to ASCII conversion
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 HP-UX 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 HP-UX computer).
The default values are the appropriate host and local code pages
for the host language you are using (specified by the LANG environment
variable). 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”). - Strip/Add LF from each line
Check this box to remove line-feed (LF) characters
from any HP-UX text file sent to the host, or to add them to any
HP-UX text file received from the host. Use this option for standard
text files. - Add to end of existing file
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. | | | |  | CAUTION: If you do not select this parameter, the target file
is overwritten. | | | | |
- Host record format
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. - Host record length
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. - Host block size
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. - Send SO
Check this box to add shift out / shift in (SO/SI)
characters to any HP-UX text file sent to the host, or leave it
unchecked to transfer the file without adding these characters.
If the file was previously received without using the Receive NOSO
parameter, so that SO/SI characters were converted to right- and
left-arrow symbols, this parameter converts the right- and left-arrow
symbols back to SO/SI characters. This parameter is used only for files containing double-byte
characters, and only when sending to the host with the EBCDIC to ASCII conversion
parameter selected. It is ignored if the selected host language
is a single-byte language, if EBCDIC to ASCII conversion
is not selected, or when receiving a file from the host. - Receive NOSO
Check this box to remove shift out / shift in (SO/SI)
characters from any HP-UX text file received from the host. If you
leave it unchecked, any SO and SI characters in the file will be
converted to right-arrow and left-arrow symbols (0x2D3E and 0x3C2D)
respectively. If you then need to send the file back to the host,
you can use the Send SO
parameter to convert the right- and left-arrow symbols back to SO/SI
characters. This parameter is used only for files containing double-byte
characters, and only when receiving from the host with the EBCDIC to ASCII conversion
parameter selected. It is ignored if the selected host language
is a single-byte language, if EBCDIC to ASCII conversion
is not selected, or when sending a file to the host. - Units of space
Specify one of the following units of measure used
for record size in the file to be created: - Tracks
Tracks are used as the unit of measure used for
record size. - Cylinders
Cylinders are used as the unit of measure for record
size. - Blocks
Blocks are used as the unit of measure for record
size. The size of the blocks is specified in the Average block size for file
parameter.
- Average block size for file (bytes)
If you specified Blocks as the Units of space
parameter, specify the size of the blocks in bytes. - Initial units of space
Specify the amount of space, in Blocks, Cylinders,
or Tracks,
as specified in the Units of space
parameter, that you want to allocate for the host data set. - Incremental units of space
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 Chapter 6 “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”. Supported Code Pages | |
Many code pages for ASCII and EBCDIC are supported by the
TN3270 emulation program. You need to consider national language
variants of ASCII or EBCDIC to determine which code page to use.
Table 5-2 “ASCII Code Pages” and Table 5-3 “EBCDIC Code Pages” show the ASCII
and EBCDIC codes pages supported by the TN3270 emulation program. The default code page used for file transfers depends on the
language you are using, which is defined by the LANG environment
variable. Refer to your operating system documentation for information
about the names of languages you can set. Table 5-2 ASCII Code Pages | 8859 | Generalized ASCII
code page defined by ISO 8859, used to support all language variants | | ROM8 | Generalized Roman
8 code page, used to support all language variants | | HP15 | Double-byte code
page: Japanese, Korean, and Traditional Chinese | | BIG5 | Double-byte code
page: Traditional Chinese (using a different encoding from HP15) | | EUC | Double-byte code
page: Japanese (Extended UNIX Code) |
Table 5-3 EBCDIC Code Pages | 037 | U.S. English,
Canadian Bilingual, Netherlands, Portuguese | | 273 | German | | 277 | Danish, Norwegian | | 278 | Finnish, Swedish | | 280 | Italian | | 284 | Spanish, Latin
American | | 285 | U.K. English | | 297 | French | | 500 | Belgian (New),
Swiss French, Swiss German | | 871 | Icelandic | | 930 | Japanese, including
Katakana characters | | 931 | Japanese, including
lowercase English characters | | 933 | Korean (Hangul) | | 937 | Traditional Chinese |
Transferring Files with an MVS/TSO
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 Figure 5-3 “Transfer TSO
File on SESSnn Dialog Box” is displayed. 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 ( ) FT
is displayed on the status line until the transfer has finished.
For more information about status line messages, see Appendix B “Status Line Information” Transfer TSO File on SESSnn
Dialog Box FieldsThe following list describes the fields of the Transfer TSO
File on SESSnn dialog box. Before transferring
files, enter the required information. - Send
/ Receive
Choose Send
to transfer a named HP-UX file to the host, or Receive to
transfer a host data set to the HP-UX computer. - Local file name
The name of the HP-UX file sent to the host or the
HP-UX file receiving data from the host. This can be any valid
HP-UX file name. If the file is not in the current directory, specify
the full path (not a relative path). - Host dataset
The name of the data set to which a named HP-UX
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. - Member name
Optionally included name of the member within the
host partitioned data set to which a named HP-UX file is sent, or
from which data is received by the HP-UX 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. - Password
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. - File Transfer Parameters
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.
The following push buttons are available on the Transfer TSO
File on SESSnn dialog box: - <OK>
Choose <OK>
to begin sending or receiving. - <Cancel>
Choose <Cancel>
to abandon the file transfer process.
Transferring the TSO FileTo transfer the file, use the following procedure: Choose Send or Receive. Enter appropriate information
in the fields of the Transfer TSO File on SESSnn
dialog box. Choose <OK> to transfer the
file. A dialog box, shown in Figure 5-4 “TSO File Transfer
in Progress” gives details on the file transfer
in progress. Choose <Exit Message> to acknowledge
this message. 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 Figure 5-1 “File Transfer Dialog
Box”
Transferring Files with a VM/CMS
Host | |
To start a file transfer, highlight a session in the File
Transfer dialog box and choose <Start transfer>. The
dialog box shown in Figure 5-5 “Transfer
VM/CMS on SESSnn Dialog Box” is displayed. 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 ( ) FT
is displayed on the status line until the transfer has finished.
For more information about status line messages, see Appendix B “Status Line Information” Transfer VM/CMS File on
SESSnn Dialog Box FieldsThe following list describes the fields of the Transfer VM/CMS
File on SESSnn dialog box: - Send
/ Receive
Choose Send
to transfer a named HP-UX file to the host, or Receive to
transfer a host file to your HP-UX computer. - Local file name
The name of the HP-UX file sent to the host or the
HP-UX file receiving data from the host. This may be any valid
HP-UX file name. If the file is not in the current directory, specify
the full path (not a relative path). - Host filename
The host file to which the data is sent, or the
file received from the host. - Host filetype
The VM/CMS file type of the host file. - Host filemode
The VM/CMS file mode of the host file. This parameter
is optional; if you do not specify it, the default A1 is used. - File Transfer Parameters
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.
The following push buttons are available on the Transfer VM/CMS
File on SESSnn dialog box: - <OK>
Choose <OK>
to begin sending or receiving. - <Cancel>
Choose <Cancel>
to abandon the file transfer process.
Transferring the VM/CMS FileTo transfer the file, use the following procedure: Choose Send or Receive. Enter appropriate information
in the fields of the Transfer VM/CMS File on SESSnn
dialog box. Choose <OK> to transfer the
file. A message appears as shown in the Figure 5-6 “VM/CMS File
Transfer in Progress” giving details on the file transfer. Choose <Exit Message> to acknowledge
this message. 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 Figure 5-1 “File Transfer Dialog
Box”
Transferring Files with a CICS Host | |
To start a file transfer, highlight a session in the File
Transfer dialog box, and choose <Start transfer>. The
dialog box shown in Figure 5-7 “Transfer
CICS File on SESSnn Dialog Box” is displayed. 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 ( ) FT
is displayed on the status line until the transfer has finished.
For more information about status line messages, see Appendix B “Status Line Information” Transfer CICS File on SESSnn
Dialog Box FieldsThe following list describes the fields of the Transfer CICS
File on SESSnn dialog box: - Send
/ Receive
Select Send
to transfer a named HP-UX file to the host, or Receive to
transfer a host file to the HP-UX computer. - Local filename
The name of the HP-UX file sent to the host or the
HP-UX file receiving data from the host. This may be any valid
HP-UX file name. If the file is not in the current directory, specify
the full path (not a relative path). - CICS filename
This is the host file to which the data is sent,
or the file received from the host. - Comments
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. - File Transfer Parameters
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.
The following push buttons are available on the Transfer CICS
File on SESSnn dialog box: - <OK>
Choose <OK>
to begin sending or receiving. - <Cancel>
Choose <Cancel>
to abandon the file transfer process.
To transfer a file, use the following procedure: Choose Send or Receive. Enter appropriate information
in the fields of the Transfer CICS File on SESSnn
dialog box. Choose <OK> to transfer the
file. A message appears as shown in the Figure 5-8 “CICS File Transfer
in Progress” giving details on the file transfer. Choose <Exit Message> to acknowledge
this message. 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 Figure 5-1 “File Transfer Dialog
Box”
|
Printable version
