Transferring Files

Z and I Emulator for Windows File Transfer enables you to transfer one or more files between a host system and workstation at the same time. Transfer types and translation tables can be defined in advance.

You can perform the following file transfer functions:

Note:

PCT400 was withdrawn from marketing 3/98.

Host Requirements

For PC/3270 File Transfer in SBCS mode, you need one or more of the following host file-transfer programs (referred to as IND$FILE):

Sending Files to the Host System

To send a file from your workstation to the host system:

  1. Sign on to the host system.
  2. Click Send File to Host from the Actions menu of the session window. (You can also select the Send button on the tool bar.)

    The Send File to Host window opens.

  3. To use a list file, click Open List. Select the list to be used for transfer. See Creating List Files for details of how to create list files.

    If you do not want to use a list file, proceed to the next step.

  4. Type the name of the PC File to be sent to the host system, or click Browse to select the file. If a template is provided for the file type you are transferring, the host file name and transfer type appear automatically.
  5. Type the Host File Name. For MVS/TSO, you can click Browse to view the datasets and members on the host (3270 only). Select the files to send, then click OK to add the files to the transfer list.
  6. Select the Transfer Type.
  7. Click Send.

    The file is sent to the host system. The send status appears in the Send a File Status window.

Receiving Files from the Host System

To transfer a file from the host system to your workstation:

  1. Sign on to the host system.
  2. Click Receive File from Host from the Actions menu. (You can also select the Receive button from the tool bar.)

    The Receive File from Host window opens.

  3. To use a list file, click Open List. Select the list to be used for transfer. See Creating List Files for details of how to create list files.

    If you do not want to use a list file, proceed to the next step.

  4. Type the name of the Host File to be received. You can also specify the host file name as follows:

    If a template is provided for the file type you are transferring, the PC file name and transfer type appear automatically.

  5. Type the PC File Name or click Browse button to select a location for the file.
  6. Select the Transfer Type.
  7. Click Receive.

    The receive status appears in the Receive a File Status window.

Using List Files

If the same files are transmitted frequently, you can create a list of the files and save it.

A list file can be used for both Send and Receive. The default list file extension is .SRL.

Creating List Files

To create a list file:

  1. Select Receive File from Host from the Actions menu or Send File to Host from the Actions menu of the session window; or click the Send or Receive buttons on the tool bar.

    The corresponding window opens.

  2. Select a file to be transferred from the Host-File Name or PC-File Name list box by pointing to the name of a file to be selected. While holding down the Ctrl key, click the left mouse button.

    The file name, its corresponding workstation or host file name (according to the available templates), and the transfer type appear in the Transfer List part of the window.

    Note:
    You can also click the Browse button (for sending files) or the Clipboard button (for receiving files) to open the corresponding dialog box, which allows you to select files for transferring; when you click OK, the selected files are shown in the Transfer List.
  3. Click the Add to List button to include a selected file in the Transfer List.
  4. After all desired files have been selected, click Save List.

    The Save File-Transfer List File As window opens.

  5. Enter or select a list name, and click OK.

Editing Lists

To edit the contents of a previously created list:

  1. As explained in Sending Files to the Host System and Receiving Files from the Host System, display the Send File to Host or Receive File from Host window.
  2. Select Open List.

    The Open File-Transfer List File window opens.

  3. Select the name corresponding to the list file to be edited, then click OK.
  4. The contents of the selected list appear in the Send File to Host or Receive File from Host window.
  5. Edit the contents of the list file.
    Changing the contents of a list:
    Choose the file to be changed from the list, and overwrite the items to be changed in the text box; then click the Update in List button.
    Removing a file from the list:
    Choose the file to be removed, and click Remove from List.
    Adding a file to the list:
    Double-click the file to be added from the list of host or workstation files.
  6. Select Save List.

    The Save File-Transfer List File As window opens.

  7. Enter a name and then click OK.

Managing Templates

A template is a set of rules to be used by the workstation to automatically generate a workstation or host file name and transfer type when you specify a file to be sent or received.

You can have up to 32 templates. They are automatically numbered from 1 to 32.

When you specify a file to be transferred, the workstation scans the templates, starting from template 1. It uses the first matching template to generate a name for the transferred file and the transfer type.

To manage a template:

  1. Click Receive File from Host from the Actions menu or Send File to Host from the Actions menu of the session window; or click the Send or Receive buttons on the tool bar.

    The Send File to Host or Receive File from Host window opens.

  2. Select Template.

    The Template window opens. The contents of the window depend on the connected host system.

Adding Templates

The list box for the Template window lists the currently stored templates.

To add a template:

  1. Select any template from the list box.

    The contents of the selected template appear under the list box.

  2. Change the workstation or host file names or extensions by overwriting them; then select the transfer type. (For details of the transfer types, see Defining Transfer Types.)
  3. Click Add.

    The window for determining where in the list to display the new template opens.

  4. Select a template number and specify whether to display the new template before or after the template that has that number. Click OK.

    The new template is added to the list in the appropriate position.

Replacing and Deleting Templates

To change the contents of a currently stored template, or to delete a template:

  1. Select the template to be changed or deleted.

    The contents of the selected template appear under the list box.

  2. To change the contents, overwrite the appropriate part and then click Replace.

    To delete a template, click Delete.

    The selected template is changed or deleted, and the contents of the template list box are changed.

Testing Templates

To test the contents of an added or changed template:

  1. Select the template to be tested from the list box.

    The number of the selected template appears in the Test Templates box in the lower part of the window.

  2. Select or enter data for the following items:
    Test Mode
    Determine which mode is to be used for the test: the mode in which a file is transmitted from the workstation to the host system (send), or the mode in which a file is transmitted from the host system to the workstation (receive).
    Templates
    Determine which templates to test: only the template selected in step 1, or all registered templates.
    Source File
    Enter the name of the file to be used for the test.
  3. Click Test.

    Target File indicates the name that has been generated by the template.

Note:
Testing a template does not transfer a file.

Defining Transfer Types

Transfer types define the option information used for controlling file transfer. Up to 32 transfer types can be defined for each host system. Text, binary, and append (excluding CICS) are the defaults.

To add or change transfer types:

  1. Click Edit -> Preferences -> Transfer from the session window.
  2. Click the tab for your host type or modem protocol.

    The property page for the selected host or modem protocol opens. The items that appear depend on the selected host system.

  3. Enter transfer-type names in the Transfer Type box, or select them from the drop-down list.
  4. Select or enter the required items (see Items to Be Specified).

    To add or replace a transfer type, click Save. To delete a transfer type, click Delete.

  5. A dialog box displays, asking for confirmation. Click OK.

Items to Be Specified

Choosing the appropriate property page enables you to set the items described in the following sections.

File Options

The file options that can be used depend on the type of the connected host system and the host code page selected when the session was configured. Table 16 lists the mode values for the file transfer options. Table 17 lists the transfer options.

Table 16. Mode Values for File Transfer Options
Mode Host Code Page
SBCS Others

Table 17 lists the options for PC/3270.

Table 17. Transfer File Options
File Option Host System Mode Conversion Details
ASCII
VM/CMS
MVS/TSO
ICS
SBCS
Converts codes as follows when a file is sent:
  • Converts 1-byte workstation codes to EBCDIC codes
  • Converts RS (hex 1E) and US (hex 1F) to SO (hex 0E) and SI (hex 0F)

Converts codes as follows when a file is received:

  • Converts EBCDIC codes to 1-byte workstation codes
CRLF
VM CMS
MVS/TSO
CICS
SBCS
Converts codes as follows when a file is sent:
  • Does not remove CRLF (hex 0D0A) from the end of each line. The code is treated as a delimiter for each record.
  • Removes EOF (hex 1A) from the end of the file.
Converts codes as follows when a file is received:
  • Adds CRLF (hex 0D0A) to the end of each line.
  • Adds EOF (hex 1A) to the end of the file. Removes EOF from the existing file, and appends EOF to the end of the added file when APPEND is specified.
APPEND
VM/CMS
MVS/TSO
SBCS
Appends the sent file to the existing host file. Appends the received file to the existing workstation file.
SRC
OS/400
i5/OS
SBCS
This option is good only for Send. When SRC is checked, the target file is stored as a member of the physical source file. If the file already exists on the Host system, this option is ignored.

Record Format

Valid only for VM/CMS and MVS/TSO when APPEND is not specified for file transmission. You can select any of the following:

If you select the Default value, the record format is selected automatically by the host system.

Specifying Variable for VM file transfer enables host disk space to be used efficiently.

Logical Record Length (LRECL)

Valid only for VM/CMS and MVS/TSO when APPEND is not specified for file transmission.

Enter the logical record length to be used (host record byte count) in the LRECL text box. If Variable and Undefined Mode are specified as the record format, the logical record length is the maximum record length within a file. The maximum value is 32767.

The record length of a file sent from a workstation to the host system might exceed the logical record length specified here. If so, the host file transfer program divides the file by the logical record length.

To send a file containing long records to the host system, specify a sufficiently long logical record length.

Because the record length of a workstation file exceeds the logical record length, a message does not appear normally if each record is divided. To display a message, add the following specification to the [Transfer] item of the workstation profile:

DisplayTruncateMessage = Y

TSO Allocation Parameter (MVS/TSO)

Valid only for MVS/TSO when APPEND is not specified for file transmission. The following items can be specified:

[Allocation Amounts]

 Primary
Enter the number of tracks or cylinders allocated to this file transfer.
 Secondary
If the primary allocation is not sufficient for the entire file transfer, enter additional storage capacity allocated to the file transfer.

[Allocation Units]

 Tracks
Specify this parameter to allocate a host file by track. Ask your system manager whether to use tracks or cylinders as the unit.
 Cylinders
Specify this parameter to allocate a host file in units of cylinders.
 AVblocks
Specify this parameter to allocate a host file in units of blocks.

[Block size]

This item is used only to create a new data set. Enter the block size of a new host data set, in bytes, in the text box. If this item is omitted, the workstation assumes the value that appears in the Logical Record Length box. The maximum value is 32767. If AVblocks is selected, the block size is the block size of the new data set.

Additional Options

You can enter the required host command options in the Additional Options text box.

Setting General Transfer Options

To set advanced options:

  1. Click Edit -> Preferences -> Transfer from the session window.

    The setup dialog is displayed.

  2. Change the required settings on the property page labeled General.
  3. Click OK.

The following sections contain information about the items which can be defined for file transfer options.

Host Type

You can specify from the drop-down list box the type of host (MVS/TSO, VM, or CICS) to which your workstation is connected.

Host Command

You can specify host command to be called when file transfer starts. If nothing is entered in this text box, IND$FILE or its equivalent for other countries is used for 3270 SBCS sessions.

Default PC Directory

You can specify the default directory that appears in the Send File to Host or Receive File From Host window. To select the directory, click the Browse button.

Default Partitioned Data Set (MVS/TSO Only)

You can specify the MVS partitioned data set to be used as the default.

Default VM Disk (VM Only)

You can specify the VM disk to be used as the default.

PC Code Page

When a file is transferred, EBCDIC codes are converted to 1-byte workstation codes, and vice versa. A valid value is automatically selected from among the following values for SBCS sessions: 437, 737, 806, 813, 819, 833, 850, 852, 854, 857, 858, 860, 861, 862, 863, 864, 865, 866, 869, 874, 912, 915, 916, 920, 921, 922, 1008, 1089, 1124, 1125, 1127, 1129, 1131, 1133, 1153, 1155, 1156, 1157, 1158, 1160, 1164, 1250, 1251, 1252, 1253, 1254, 1255, 1256, 1257, and 1258; --according to the host code page specified when the workstation is configured. For an explanation of how to select host code pages, see the online help for the host code page.

Packet Size

The amount of memory (in bytes) used by the workstation for transmission and reception. If a large value is entered, a file is transferred more quickly, but the memory overhead is larger. The default value is 12288. In the case of Telnet3270, you can specify a packet size larger than 8000 bytes by adding the following line to the Telnet3270 stanza in your workstation profile:

SendBufferSize=nnnn

File-Transfer Timeout

You can define the time the workstation waits for a response from the host system (in seconds). If the host system does not respond, the transfer is canceled, and an error message appears. A number in the range 20-65535 (or 0) can be specified. The default is 60 seconds for ASCII sessions; for all others, it is 30 seconds. Specify an appropriate value such that the error message does not appear too early. If you specify 0, a timeout is not set.

If a packet or block size is relatively large for low-speed lines, such as COM port lines, it is recommended that 150 seconds or greater be specified.

Extension for List-Files

You can change the default extension (.SRL) of file-transfer list files.

Clear Session Before Transfer

You can specify whether a Clear command is sent to the host system before a file is transferred. Choose any of these option buttons:

Default
A Clear command is sent before a file is transferred (VM/CMS or CICS only).
Yes
A Clear command is sent for MVS also.
No
A Clear command is not sent for any host system.

Show Status Window

You can choose the method of displaying the file-transfer-progress status.

In Session
When file transfer starts, the status window opens. The name of the file being transferred and the transfer progress appear.
In icon
When file transfer starts, the status icon appears on the screen. If the icon is restored, the status window opens.

Setting Up the Translation Table

You can create or edit the translation table to be used for sending or receiving files.

Changing the Translation Table

To change the translation table:

  1. Click Edit -> Preferences -> Transfer from the session window.
  2. Click the Translation Table tab on the resulting window.

    The Translation-Table Setup property page opens.

  3. The table currently being used (default or the name of a user-defined table) is shown. Choose either Default or User-Defined.
  4. If you choose User-Defined, enter a translation-table name in the File Name text box, or select a name by clicking Browse.
  5. Click OK.

Customizing the Translation Table

You can create a user-specific translation table for transmission or reception, or you can edit an existing translation table.

To create or edit a translation table:

  1. On the Translation Tables property page, click Customize in the Upload or Download window.

    The Customize Translation window opens.

    If you chose Default or if you chose New from the File menu, the default values appear in the table.

    Translation source codes
    PC code-points when an upload translation table is edited. Host code-points when a download translation table is edited.
    Translation target codes
    Host code-points when an upload translation table is edited. PC code-points when a download translation table is edited.
  2. Double-click the code to be changed in the table, and change the value in the entry field that subsequently appears.
  3. Click Save or Save As from the File menu.
  4. If asked, enter a name in the Save Translation File As window and click OK.
  5. Click Exit from the File menu of the Customize Translation window.

Import/Export (3270 CICS Only)

Import/Export is an office system communication program and an application program executed under the IBM Customer Information Control System (CICS).

Clicking Import/Export loads a module into workstation memory. You can then start Import or Export from a menu on the host screen.

When you export a document from the host, the workstation receives two files: one is the file itself, and the other is the interchange document profile (IDP) file, which contains document header information.

When you Import a file to a host system, it must be accompanied by an IDP file of the same name. If the necessary IDP file does not exist, you can create it as described in .

To transmit files using Import/Export:

  1. Verify that the window of the host session is active and ready for file transfer.
  2. Click Import/Export from the Actions menu of the session window.

    The minimized Import/Export Status window opens.

  3. Click Import or Export from the host application menu.
  4. Specify the host and workstation file names of the file to be transferred. Run Import or Export.

    When Import or Export starts, the Import/Export Status window is maximized.

    After the file is transferred, the window is closed.

File Transfer Commands for PC/3270

You can send data files to and receive them from IBM host systems that are running:

CICS/MVS
Customer Information Control System running under MVS
CICS/VSE
CICS running under Virtual Storage Extended
MVS/TSO
Multiple Virtual Storage/Time Sharing Option
VM/CMS
Virtual Machine/Conversational Monitor System

For more information on using these commands, click Send File to Host from the Actions menu and File Transfer from Command prompt in the help panel.

File Transfer Methods

You can transfer files in the following ways with PC/3270:

Requirements and Restrictions

Install the file transfer program, IND$FILE, on your host system. Ask your system administrator for additional file transfer procedures and precautions. An alternate host command name can be used by defining a DOS environment variable IND_FILE in AUTOEXEC.BAT or in a particular DOS box. For example:

  SET IND_FILE = MYXFER

You should not use the following words as a VM file name or file type, as an MVS data set name, or as a CICS file name, because they are reserved for use as option commands.

  ASCII, APPEND, TIME, CLEAR, NOCLEAR, SILENT, QUIET, PROGRESS,
  BLANK, CRLF, BINARY, NOCRLF

If you want to send to or receive from a subdirectory other than \Z and I Emulator for Windows, you must specify the full path name.

Sending and Receiving Files from the DOS Command Prompt

The workstation is the point of reference for the SEND and RECEIVE commands: You send from the workstation to the host and receive from the host to the workstation.

To send or receive a file:

  1. Make sure you are logged on to your host.
  2. Make sure the Ready message of the host system is displayed, except if you are transferring files through the command option of the ISPF application.
    Note:
    In the latter case, you must specify the NOCLEAR option for the file transfer command.

    If your screen is blank, make sure that no applications are running and that your host session is not in a holding state.

    Note:
    If you receive any messages from host application programs while you are transferring files, the transfer might not succeed. To prevent messages from interfering, enter the appropriate host command to set messages off temporarily. When file transfer is finished, set messages on again.
  3. Switch to your DOS window session or DOS full-screen session.
  4. If you use a hard disk, make sure the SEND.EXE and RECEIVE.EXE files are in your current directory or in your path. If you want to send to or receive from a subdirectory other than \Z and I Emulator for Windows, you must specify the full path name.
  5. Type the appropriate SEND or RECEIVE command at the DOS command prompt.

    Details on the SEND and RECEIVE commands and their options are explained in the following sections.

Using the VM/CMS SEND Command

Use the following information when sending a file to VM/CMS:

Figure 1 shows the command and information that you must provide. Enter it as shown (including parentheses). You can use either uppercase or lowercase letters.

Notes:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 1. VM/CMS SEND Command Syntax REQTEXT
 A 
The workstation drive and path of the file to send.
 B 
The name of the workstation file to send.
 C 
Host session specifications for the file to be sent to the host.
h:
The short name of the session (which can be omitted if it is a)
fn
File name
ft
File type
fm
File mode
 D 
Optional changes made to the file during transfer. More than one option can be selected. Valid options are:

The parts of the VM/CMS SEND command are:

SEND
The command.
d:
The name of the diskette or hard disk drive on which the file is located.
path
The path to the subdirectory that the file is in.
filename.ext
The name of the file to be sent, including the extension.
h:
The short name of the host session to which you want to send the file. The default is a:.
fn ft fm
The name the file is to have on your VM/CMS disk. You must specify the file name (fn) and file type (ft). You can omit file mode (fm) if you want the file placed on your A-disk. You can create a new name or use a name that is already on your disk. If you use a new name, the file that you send is added to your disk. If you use the name of an existing file, the file that you send either replaces or is added to the old file. (Refer to the description of the APPEND option.)
(options
       These options can be specified:
APPEND
Specifies that the file being sent is to be added to the end of an existing VM/CMS file. Omit this option if you want the file to replace an existing file. You cannot specify the LRECL n or RECFM x option if you use the APPEND option.
ASCII
Performs the following:
  • Converts 1-byte workstation codes to EBCDIC codes.
CLEAR
Clears the workstation window at the beginning of the file transfer. CLEAR is the default.
CRLF
Specifies preserving of the carriage return and line feed codes. You need the ASCII and CRLF options for text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files, such as programs.
LRECL n
Specifies the file’s record length. Include a record length only if you want the file to have a record length on your VM/CMS disk other than 80. Replace n with the record length you want. If you omit this option, the record length is set to 80 for fixed-length records or to a maximum of 80 for variable-length records.
NOCLEAR
Suppresses the sending of a Clear command at the beginning of the file transfer.
PROGRESS
Shows a message indicating that the file transfer is in progress or has ended. Such messages do not show the current transferred bytes.
QUIET
Does not show any messages.
RECFM x
Specifies the file record format. Use this parameter to specify variable-length or fixed-length records in the file. Replace x with V for variable or F for fixed. By default, the file has fixed-length records unless you specify the CRLF option; then the file has variable-length records unless you specify otherwise.
TIME(n)
Specifies the length of time n, in units of 30 seconds, that the program waits for a response from the host before it sends an error message. Replace n with an integer value in the range from 0 through 2184. If you specify 0, timeout will not be set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, of large block sizes, or for slow communication lines (such as and COM port), 5 (150 seconds) is recommended. There should be no blank spaces is between TIME and (n).
Command Syntax for Sending Files to VM/CMS

The following examples show the command syntax you can use to send files to a VM/CMS host. The parameters of the SEND command can be combined into a single set of parentheses.

Using the VM/CMS RECEIVE Command

Use the following information when receiving a file from VM/CMS:

Figure 2 shows the command and information you must provide. Enter it as shown (including parentheses), except that you can use either uppercase or lowercase letters.

Notes:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 2. VM/CMS RECEIVE Command Syntax
REQTEXT
 A 
The workstation drive and path of the file to be received.
 B 
The name of the workstation file to be received.
 C 
Host session specifications for the file to be received from the host.
h:
The short name of the session (which can be omitted if it is a)
fn
File name
ft
File type
fm
File mode
 D 
Optional changes made to the file during transfer. More than one option can be selected. Valid options are:

The parts of the VM/CMS RECEIVE command are:

RECEIVE
The command.
d:
The name of the diskette or hard disk drive on which the file is to be received.
path
The path indicating the directory to which the file is to be stored.
filename.ext
The name of the workstation file, including the extension. Use a new name or one that already exists. If you use a new name, the file that you receive is added to your diskette or hard disk. If you use the name of an existing file, the file that you receive either replaces or supplements the existing file. (Refer to the APPEND option.)
h:
The short name of the host session from which you want to get the file. The default is a:.
fn ft fm
The name of the file you want to receive from your VM/CMS disk. The file name fn is required.
(options
       These options can be specified:
APPEND
Specifies that the file being received is to be added to the end of an existing file. Omit this part of the VM/CMS file that is received to replace an existing file.
ASCII
Performs the following:
  • Converts EBCDIC codes to 1-byte workstation codes.
BLANK
This option is valid with the CRLF option. Use it to retain BLANK (x'40') at the end of each line.
CRLF
Specifies the carriage return and line feed codes. You need ASCII and CRLF for text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files, such as programs.
CLEAR
Clears the workstation window at the beginning of the file transfer.
NOCLEAR
Suppresses the sending of a Clear command at the beginning of the file transfer.
PROGRESS
Shows a message indicating that the file transfer is in progress or has ended. Such messages do not show the current transferred bytes.
QUIET
Does not show any messages.
TIME(n)
Specifies the length of time, in units of 30 seconds, that the program waits for a response from the host before it sends an error message. The value n is an integer value in the range from 0 through 2184. If you specify 0, timeout is not set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, of large block sizes, or for slow communication lines (such as and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).
Command Syntax for Receiving Files from VM/CMS

The following examples show the command syntax you can use to receive files from a VM/CMS host. The parameters of the RECEIVE command can be combined into a single set of parentheses.

Using the MVS/TSO SEND Command

Use the following information when entering the SEND command to the MVS/TSO host:

Figure 3 shows the command and information you must provide. Enter text as shown (including parentheses), except that you can use either uppercase or lowercase letters.

Notes:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 3. MVS/TSO SEND Command Syntax
REQTEXT
 A 
The workstation drive and path of the file to send.
 B 
The name of the workstation file to send.
 C 
The short name of the host session and the data set name of the file to send.
 D 
The member name if the file is in a partitioned data set.
 E 
The password of the data set if it has one.
 F 
Optional changes made to the file during transfer. More than one option can be specified. Valid options are:

The parts of the MVS/TSO SEND command are:

SEND
The command.
d:
The name of the diskette or hard disk drive where the file is located.
path
The path indicating the directory where the file is located.
filename.ext
The name of the file to be sent. Include the extension if the file has one.
h:
The name of the MVS/TSO host session to which you want to send the file. You can omit this name if you have only one host. If you have more than one host, this is the short name of the MVS/TSO host session. The default short name is A.
data-set-name
The data set name that the file you send is to have on your MVS/TSO volume; this name is required. Enclose the data set name with the member name in single quotation marks if you are using a fully qualified data set name.

This option creates a new name or uses a data set name already on your TSO volume. If you use a new name, the file that you send is added to your MVS/TSO volume. If you use the name of an existing data set, the file you send either replaces or supplements the existing data set. Refer to the APPEND option.

(member-name)
The member name if the file is to be put into a partitioned data set. If you use member-name, you cannot use LRECL(n), BLKSIZE(n), RECFM(x), and SPACE(n,[n1]) unit.
Note:
If someone else is using the partitioned data set, you cannot send a file to your MVS/TSO host.
/password
The password of the data set, if the data set has a password.
options
These options can be specified:
APPEND
Specifies that the file being sent is added to the end of an existing MVS/TSO data set. Omit this option if you want the file to replace an existing MVS/TSO data set. You cannot use LRECL(n), RECFM(x), SPACE(n[,n1]) unit, or BLKSIZE(n) options if you use the APPEND option.
Note:
This option is not valid when sending data to a member of a partitioned data set.
ASCII
Performs the following:
  • Converts 1-byte workstation codes to EBCDIC codes.
BLKSIZE(n)
Specifies the size of the blocks of data in a new data set on your MVS/TSO volume. This part is optional. To set the block size for a new data set, replace n with the new size. If you omit this option, the block size is determined in the following manner:
  • If the record format is variable, the block size is 6233.
  • If the record format is fixed, the block size is the largest multiple of the record length that is less than 6233:
    BLKSIZE = LRECL * (6233/LRECL)
If you use the (member-name) or APPEND option, do not use this option.
CLEAR
Clears the workstation window at the beginning of the file transfer.
CRLF
Specifies the global use of carriage return and line feed codes. You need to specify ASCII and CRLF options for sending text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files.
LRECL(n)
Specifies the record length for a new data set on your MVS/TSO volume, where n is a whole number from 1 through 32760 representing the number of characters per record. If you want to set the record length for a new data set, replace n with the new length. If you omit this option, the record length is set to 80 for fixed-length records and to 255 for variable-length records. If you use the (member-name) or APPEND options, do not use this option.
NOCLEAR
Suppresses the sending of a Clear command at the beginning of the file transfer. This option is required for ISPF command mode.
PROGRESS
Shows a message indicating that the file transfer is in progress or has ended. Such messages do not show the current transferred bytes.
QUIET
Does not show any messages.
RECFM(x)
Specifies the record format for a new data set on your MVS/TSO volume, where x = V, F, or U. For variable-, fixed- or undefined-length records in the data set, replace the x with V, F, or U, respectively.

If you omit this option, the record format of the host data set is determined by the setting of the CRLF parameter: if you specify CRLF, the data set has variable-length records; if you do not specify CRLF, it has fixed-length records. If you use the (member-name) or APPEND options, do not use this option.

SPACE(n[,n1]) unit
Specifies an amount of space to be set aside for a new data set on your MVS/TSO volume. To set aside a certain number of blocks, tracks, or cylinders for the new data set:
  • Provide unit as the type of space you want (AVBLOCK, TRACKS, or CYLINDERS).
  • Give n as the amount of space that you want the data set to occupy (in the unit of measure you select).
  • If the data set needs more space than you ask for with n, give n,n1 where n1 is the size of additional space to be used only when necessary.
These values are similar to the values on the ALLOCATE command of MVS/TSO.

If you omit this option, you get space for one block. The length of the block is set by the BLKSIZE(n) or LRECL(n) options. If you use the (member-name) or APPEND options, do not use this option.

TIME(n)
Specifies the length of time, in units of 30 seconds, that the program waits for a response from the host before it sends an error message. The value n is an integer value in the range from 0 through 2184. If you specify 0, timeout is not set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, of large block sizes, or for slow communication lines (such as and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).
Command Syntax for Sending Files to MVS/TSO

The following examples show the command syntax you can use to send files from your workstation to an MVS/TSO host:

Using the MVS/TSO RECEIVE Command

Use the following information when receiving a file from MVS/TSO:

Figure 4 shows the command and information you must provide. Enter it as shown (including parentheses), except that you can use either uppercase or lowercase letters.

Notes:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 4. MVS/TSO RECEIVE Command Syntax
REQTEXT
 A 
The workstation drive and path to the directory where the file is to be stored.
 B 
The name of the workstation file to receive.
 C 
The short name of the host session, and the data set name of the file you are receiving.
 D 
The member name if the file is put in a partitioned data set.
 E 
The password of the data set, if any.
 F 
Optional changes made to the file during transfer. More than one option can be specified. Valid options are:

The parts of the MVS/TSO RECEIVE commands are:

RECEIVE
The command.
d:
The name of the diskette or hard disk drive where the file is to be located. Use A:, B:, C:, D: through Z:. This part is optional if the file is received on the current drive.
path
The subdirectory where you want the data set located. This part is optional.
filename.ext
The name the file is to have on your diskette or hard disk. Creates a new name or uses a name that is already on your diskette or hard disk.

If you use a new name, the data set that you receive is added to your diskette or hard disk. If you use the name of an existing file, the data set that you receive either replaces or supplements the existing file. (Refer to the APPEND option on page ***.)

h:
The short name of the MVS/TSO session where the data set is located. If you have only one host, this part is optional. Use this option if you have more than one host. The default short name is A.
data-set-name
The name of the data set or the partitioned data set that contains the member you want to send to your workstation session. You must use the qualified name. Enclose the data set name with the member name in single quotation marks if you are using a fully qualified data set name.
(member-name)
The member name of a partitioned data set to send to your workstation session. This part is optional. Use it only if the data set is a member of a partitioned data set.
/password
The password of the data set. Use it only if the data set has a password.

(options
       These options can be specified:
APPEND
Adds the data set to the end of an existing file. Omit this part if you want the MVS/TSO data set to replace an existing workstation file.
ASCII
Performs the following:
  • Converts EBCDIC codes to 1-byte workstation codes.
BLANK
This option is valid with the option CRLF; it retains BLANK (hex 40) at the end of each line.
CRLF
Specifies the use of carriage return and line feed codes. You need ASCII and CRLF for text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files.
PROGRESS
Shows a message indicating that the file transfer is in progress or has ended. Such messages do not show the current transferred bytes.
QUIET
Does not show any messages.
TIME(n)
Specifies the length of time, in units of 30 seconds, the program waits for a response from the host before it sends an error message. Replace n with an integer value in the range from 0 through 2184. If you specify 0, timeout is not set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, of large block sizes, or for slow communication lines (such as and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).
Command Syntax for Receiving Files from MVS/TSO

The following examples show the command syntax you can use to receive files from your MVS/TSO host to your workstation:

Using the CICS SEND Command

Please note the differences between the Z and I Emulator for Windows GUI and Command Line syntaxes. These two syntaxes are not interchangeable.

Using CICS SEND with the Z and I Emulator for Windows GUI

Use the following information when sending a file to CICS using the Z and I Emulator for Windows graphical user interface (GUI):

Figure 5 shows the command and information you must provide. Enter it as shown (including parentheses), except that you can use either uppercase or lowercase letters.

Notes:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 5. CICS SEND Z and I Emulator for Windows GUI Syntax
REQTEXT
 A 
The workstation drive and path of the file to send.
 B 
The name of the workstation file to send.
 C 
The short name of the host session, and the host file name of the file to send.
 D 
Optional changes made to the file during transfer. More than one option can be specified. Valid options are:
Note:
For SBCS sessions, the default options are ASCII and CRLF.
Using CICS SEND with the Z and I Emulator for Windows Command Line

Use the following information when sending a file to CICS using the Z and I Emulator for Windows command line:

Figure 6 shows the command and information you must provide. Enter it as shown (including parentheses), except that you can use either uppercase or lowercase letters.

Notes:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 6. CICS SEND Command Line Syntax
 A 
The workstation drive and path of the file to send.
 B 
The name of the workstation file to send.
 C 
The short name of the host session (h:), the host file name (fn), and the file type (ft).
 D 
Optional changes made to the file during transfer. More than one option can be specified. Valid options are:
Note:
For SBCS sessions, the default options are ASCII and CRLF.
CICS SEND Command Description and Options

The parts of the CICS SEND command are:

SEND
The command.
d:
The name of the diskette or hard disk drive where the file is located.
path
The path to the subdirectory that the file is in.
filename.ext
The name of the file to be sent, including the extension.
h:
The short name of the host session where you want to send the file. If you have only one host, this part is optional. The default is session A.
fn
The name the file is to have on your CICS disk. You must specify the file name. You can create a new name or use a name that is already on the disk.
ft
The type of file in CICS. For use only with command line syntax, see Using CICS SEND with the Z and I Emulator for Windows Command Line.
(options
       These options can be specified:
ASCII
Performs the following:
  • Converts 1-byte workstation codes to EBCDIC codes.

The default is ASCII CRLF. You need these control terms for text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files.

Notes:
  1. CRLF and NOCRLF are mutually exclusive options.
  2. BINARY and ASCII are mutually exclusive options.
  3. The assumed defaults, if the optional parameters are omitted, are CRLF ASCII.
BINARY
Specifies that the data in the file is binary data. The data can be encrypted, compiled programs, or other data. It is not translated by the host file transfer program but copied unaltered into a temporary storage queue.

This option is valid for SBCS sessions only.

CLEAR
Clears the workstation window at the beginning of the file transfer.
CRLF
Specifies carriage return and line feed codes in the text file.
NOCLEAR
Suppresses the sending of a Clear command at the beginning of file transfer. This option is required for ISPF command mode.
NOCRLF
Specifies that the PC file does not consist of logical records delimited by carriage return and line feed characters. No concatenation or splitting of records is performed by the CICS file transfer program.

The file is written into a temporary storage using one item on the queue to represent each inbound data buffer. The items on the CICS temporary storage queue can be of different lengths, but none can be more than 32767 characters.

This option is valid for SBCS sessions only.

PROGRESS
Shows a message indicating that the file transfer is in progress or has ended. Such messages do not show the current transferred bytes.
QUIET
Does not show any messages.
TIME(n)
Specifies the length of time, in units of 30 seconds, the program waits for a response from the host before it sends an error message. Replace n with an integer value in the range from 0 through 2184. If you specify 0, timeout is not set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, large block sizes, or for slow communication lines (such as and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).
Command Syntax for Sending Files to CICS

The following examples show the command syntax you can use to send files from your workstation to your CICS host.

Using the CICS RECEIVE Command

Please note the differences between the Z and I Emulator for Windows GUI and Command Line syntaxes. These two syntaxes are not interchangeable.

Using CICS RECEIVE with the Z and I Emulator for Windows GUI

Use the following information when receiving files from CICS using the Z and I Emulator for Windows GUI:

Figure 7 shows the command and information you must provide. Enter it as shown (including parentheses), except that you can use either uppercase or lowercase.

Notes:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 7. CICS RECEIVE Z and I Emulator for Windows GUI Syntax
REQTEXT
 A 
The workstation drive and path where the file is to be received.
 B 
The name of the workstation file.
 C 
The short name of the host session (h:) from which you are receiving the file, and the host file name (fn).
 D 
Optional changes made to the file during transfer. More than one option can be specified. Valid options are:
Note:
The default options for SBCS sessions are ASCII and CRLF.
Using CICS RECEIVE with the Z and I Emulator for Windows Command Line

Use the following information when receiving files from CICS using the Z and I Emulator for Windows command line:

Figure 8 shows the command and information you must provide. Enter it as shown (including parentheses), except that you can use either uppercase or lowercase.

Notes:
  1. blank space character means to insert a space. There must not be a space between h: and fn.
Figure 8. CICS RECEIVE Command Syntax
REQTEXT
 A 
The workstation drive and path where the file is to be received.
 B 
The name of the workstation file.
 C 
The short name of the host session (h:) from which you are receiving the file, the host file name (fn), and the file type (ft).
 D 
Optional changes made to the file during transfer. More than one option can be specified. Valid options are:
Note:
The default options for SBCS sessions are ASCII and CRLF.
CICS RECEIVE Description and Options

The parts of the CICS RECEIVE command are:

RECEIVE
The command.
d:
The name of the diskette or hard disk drive where the file is to be received.
path
The path to the subdirectory where the file is to be located.
filename.ext
The name of the workstation file, including the extension. You can create a new name or use a name that is already on your workstation diskette or hard disk. If you use a new name, the file that you receive is added to your diskette or hard disk. If you use the name of an existing file, the file that you receive either replaces or supplements the existing file. Refer to the APPEND option.
h:
The short name of the CICS session where the data set is located. If you have only one host, this part is optional. The default session is A.
fn
The name of the file you want to receive from your CICS host.
ft
The type of file in CICS. For use only with command line syntax, see Using CICS RECEIVE with the Z and I Emulator for Windows Command Line.

(options
       These options can be specified:
ASCII
Performs the following:
  • Converts EBCDIC codes to 1-byte workstation codes.

The default is ASCII CRLF. You need ASCII and CRLF control terms for text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files.

Notes:
  1. CRLF and NOCRLF are mutually exclusive options.
  2. BINARY and ASCII are mutually exclusive options.
  3. The assumed defaults, if the optional parameters are omitted, are CRLF ASCII.
BINARY
The data in the file is binary data. The data can be encrypted data, compiled programs, or other data. It is not translated by the host file transfer program but is copied without changes into the workstation file.

This option is valid for SBCS sessions only.

BLANK
This option is valid only when used with the CRLF option; it retains BLANK (hex 40) at the end of each line.
CLEAR
Clears the workstation window at the beginning of the file transfer.
CRLF
Specifies the use of the carriage return and line feed codes.
NOCLEAR
Suppresses the sending of a Clear command at the beginning of file transfer. This option is required for ISPF command mode.
NOCRLF
Specifies that the host computer file does not consist of logical records. The items in the temporary storage queue are sent in order and concatenated in your workstation into a single string of data.

This option is valid for SBCS sessions only.

PROGRESS
Shows a message indicating that the file transfer is in progress or has ended. Such messages do not show the current transferred bytes.
QUIET
Does not show any messages.
TIME(n)
Specifies the length of time, in units of 30 seconds, the program waits for a response from the host before it sends an error message. Replace n with an integer value in the range from 0 through 2184. If you specify 0, timeout is not set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, of large block sizes, or for slow communication lines (such as and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).
Command Syntax for Receiving Files from CICS

The following examples show the command syntax you can use to receive files from your CICS host to your workstation.

Configuring File-Transfer Code Translation

When you transfer a file between the host and the workstation using the ASCII option, the host-system file-transfer program performs translation from EBCDIC to ASCII or vice versa, according to the host and PC code pages specified during PC/3270 configuration. However, you might want to use different translation from that supplied. For the details, refer to Transferring Files.

Using Z and I Emulator for Windows 5250