Technical reference

Mainframe system requirements

Depending upon which IBM host system you use, one of the following IBM host-supported file transfer programs must be installed at your host site. The Options tab on the File Transfer dialog box is used to configure the mainframe operating system and the file transfer program name.

MVS/TSO Mainframe Operating System

IBM 3270-PC File Transfer Program Release 1 (5665-311)

At the TSO command level, type: IND$FILE. If the program is not installed, you receive the message: [IKJ56500I] COMMAND IND$FILE NOT FOUND

VM/CMS Mainframe Operating System

IBM 3270-PC File Transfer Program Release 1 (5664-281)

The installation and support of the IBM host-supported file transfer programs is outside the scope of this documentation. A quick way to determine if the IBM file transfer product is installed on your host, is to do the following: In the CMS environment, type: IND$FILE. If the program is not installed, you will receive the message: UNKNOWN CP/CMS COMMAND

CICS Mainframe Operating System

Ask your systems administrator if the IBM IND$FILE host file transfer program is installed.

CMS send parameters

Send parameters are optional and are passed as parameters to the host IND$FILE program. The following parameters are valid for the VM/CMS send file transfer operation. When using the following parameters, an open parenthesis character "(" must precede the actual parameter string and a close parenthesis character “)” must follow the parameter string, as in the following example:

( ASCII RECFM F LRECL 125 )

ASCII

If the PC file consists of character data only, specify ASCII. This causes the translation of all graphic and control characters from ASCII to EBCDIC during the transfer so that it is usable on the host computer.

CRLF

Following the convention for ASCII text files, <CR> <LF> pairs are used to terminate records in the PC file, and a CTRL-Z (x'1A') marks the end of file. If the PC file consists of data other than text such as binary format data, do not specify either ASCII or CRLF.

APPEND

If the CMS file already exists and is not empty, APPEND specifies that the contents of the PC file are to be appended to the file.

RECFM x

Specifies the record format of the CMS file. Replace x with either F, V, or U. F specifies that the data set contains fixed length records. V specifies that the data set contains variable length records. U specifies that the data set contains undefined length records. For existing CMS files the default value is the record format of the CMS file.

LRECL n

Specifies the logical record length n for a CMS file consisting of fixed length records or the maximum logical record length for a CMS file consisting of variable length records. Values permitted are 1 to 32760. For new CMS files the default value is 80. This parameter is ignored if APPEND is specified. For CMS files consisting of variable length records, the actual logical record length (i.e., the value stored in the Data Set Control Block) following the file transfer is set to the minimum of the value of LRECL and the longest record in the CMS file.

CMS receive parameters

Receive parameters are optional and are passed as parameters to the host IND$FILE program. When using the following parameters, an open parenthesis character "(" must precede the actual parameter string. The close parenthesis character ")" must terminate the parameter string. The following parameters are valid for the VM/CMS receive file transfer operation:

APPEND

APPEND specifies that if the file exists, the CMS file contents are to be appended to it. Unless APPEND is specified, the PC file is replaced by the contents of the CMS file.

ASCII

If the CMS file consists of character data only, specify ASCII. This causes the translation of all graphic and control characters from ASCII to EBCDIC during the transfer.

CRLF

Following the convention for ASCII text files, <CR> <LF> pairs are used to terminate records in the PC file, and a CTRL-Z (x'1A') marks the end of file.

TSO send parameters

Send parameters are optional and are passed as parameters to the host IND$FILE program. The following parameters are valid for the MVS/TSO send file transfer operation:

ASCII

If the PC file consists of character data only, specify ASCII. This will cause the translation of all graphic and control characters from ASCII to EBCDIC during the transfer.

CRLF

Following the convention for ASCII text files, <CR> <LF> pairs are used to terminate records in the PC file, and a CTRL-Z (x'1A') marks the end of file. If the PC file consists of data other than text, such as binary format data, do not specify either ASCII or CRLF.

APPEND

If the data set already exists and is not empty, APPEND specifies that the contents of the PC file are to be appended to the data set. APPEND cannot be specified for members of a partitioned data set.

RECFM(x)

Specifies the record format of the data set. Replace x with either F, V, or U. F specifies that the data set contains fixed length records. V specifies that the data set contains variable length records. U specifies that the data set contains undefined length records. For existing data sets, the default value is the existing record format.

LRECL(n)

Specifies the logical record length (n) for a data set consisting of fixed length records or the maximum logical record length for a data set consisting of variable length records. Values permitted are 1 to 32760. For new data sets the default value is 80. This parameter is ignored if APPEND is specified. For data sets consisting of variable length records, the actual logical record length (i.e. the value stored in the Data Set Control Block) following the file transfer is set to the minimum of the value of LRECL and the longest record in the data set.

BLKSIZE(n)

Specifies the block size (n) for a new data set. For data sets containing fixed-length records, the block size must be a multiple of the record length. For data sets containing variable-length records, the block size must be greater than or equal to the record length plus four bytes. The block size must not exceed the track length of the device on which the data set resides. The block size must also not exceed 32,760 bytes. The default value is 3120. This parameter is ignored if the data set already exists.

SPACE(quantity[,increment])

Specifies the amount of disk space to be allocated for a new data set. If the SPACE parameter is used, you can use one of the three following options to specify the units used for quantity and increment:

•

SAVBLOCK(value)

•

TRACKS

•

CYLINDERS

TSO receive parameters

Receive parameters are optional and are passed as parameters to the host IND$FILE program. When using the following positional parameters, care should be taken to include the "(" open parenthesis character and ")" parentheses character in describing RECFM, LRECL, and BLKSIZE as denoted in the following example:

ASCII CRLF RECFM(F) LRECL(80) BLKSIZE(6160)

In the MVS/TSO, Receive Parameters include the following:

The following parameters are valid for the MVS/TSO receive file transfer operation:

ASCII

If the PC file consists of character data only, specify ASCII. This causes the translation of all graphic and control characters from EBCDIC to ASCII during the transfer.

CRLF

Following the convention for ASCII text files, <CR> <LF> pairs are used to terminate records in the PC file, and a CTRL-Z (x'1A') marks the end of file. If the PC file consists of data other than text, such as binary format data, do not specify either ASCII or CRLF.

APPEND

If the data set already exists and is not empty, APPEND specifies that the contents of the Mainframe file are to be appended to the data set. APPEND cannot be specified for members of a partitioned data set.

RECFM(x)

Specifies the record format of the data set. REplace x with either F, V, or U. F specifies that the data set contains fixed length records. V specifies that the data set contains variable length records. U specifies that the data set contains undefined length records. For existing data sets, the default value is the existing record format.

LRECL(n)

Specifies the logical record length (n) for a data set consisting of fixed length records or the maximum logical record length for a data set consisting of variable length records. Values permitted at 1 to 32760. For new data sets, the default value is 80. This parameter is ignored if APPEND is specified. For data sets consisting of variable-length records, the actual logical record length (i.e., the value stored in the Data Set Control Block) following the file transfer, is set to the minimum of the value of LRECL and the longest record in the data set.

BLKSIZE(n)

Specifies the block size (n) of the data set. For data sets containing fixed-length records, the block size must be a multiple of the record length. For data sets containing variable-length records, the block size must be greater than or equal to the record length plus four bytes. The block size must not exceed the track length of the device on which the data set resides. The block size must also not exceed 32,760 bytes. The default value is 3120.

CICS send parameters

Send parameters are optional and are passed as parameters to the host IND$FILE program. The following parameters are valid for the CICS send file transfer operation:

ASCII

If the PC file consists of character data only, specify ASCII. This causes the translation of all graphic and control characters from ASCII to EBCDIC during the transfer so that it is usable on the host computer.

BINARY

If the PC file consists of binary data, specify BINARY.

CRLF

Following the convention for ASCII text files, <CR> <LF> pairs are used to terminate records in the PC file, and a CTRL-Z (x'1A') marks the end of file. CRLF is a default option.

NOCRLF

Do not use <CR> <LF> pairs to terminate records in the CICS file.

CICS receive parameters

Receive parameters are optional and are passed as parameters to the host IND$FILE program. The following parameters are valid for the CICS receive file transfer operation:

APPEND

APPEND specifies that if the PC file exists, the CICS file contents are to be appended to it. Unless APPEND is specified, the PC file is replaced by the contents of the CICS file.

ASCII

If the CICS file consists of character data only, specify ASCII. This causes the translation of all graphic and control characters from ASCII to EBCDIC during the transfer.

BINARY

If the PC file consists of binary data, specify BINARY.

CRLF

Following the convention for ASCII text files, <CR> <LF> pairs are used to terminate records in the PC file, and a CTRL-Z (x'1A') marks the end of file.

NOCRLF

Do not use <CR> <LF> pairs to terminate records in the PC file.

File Transfer - Host Error Messages

TRANS00 - Error in file transfer: file transfer canceled

An error occurred in the file transfer, which can be an error in the data being transferred, or an unidentified system error.

TRANS03 - File transfer complete

The file transfer operation has been successfully completed.

TRANS04 - File transfer complete with records segmented

The file transfer operation has been completed, and any record greater than the logical record length (LRECL) of the file being appended has been divided and becomes multiple records.

TRANS05 - Personal computer filespec incorrect: file transfer canceled

An error exists in the PC's file name.

TRANS06 - Command incomplete: file transfer canceled

You did not enter the required parameters after a SEND or RECEIVE command.

TRANS13 - Error writing file to host: file transfer canceled

The host program has detected an error in the file data during a RECEIVE operation.

TRANS14 - Error reading file from host: file transfer canceled

The host program has detected an error in the file data during a RECEIVE operation.

TRANS15 - Required host storage unavailable: file transfer canceled

You need 30 KB of main storage (not disk space) on the host for the file transfer, in addition to the host requirement.

TRANS16 - Incorrect request code: file transfer canceled

An invalid SEND or RECEIVE parameter was sent to the host.

TRANS17 - Missing or incorrect TSO data set name: file transfer canceled

You did not specify the TSO data set name, or the specified TSO data set name is not a sequential or partitioned data set.

TRANS17 - Invalid file name: file transfer canceled

The command that started the file transfer specified a file name that is not a valid file name for the host. Correct CICS file names must be 1 to 8 characters, composed of letters and numbers.

TRANS17 - Missing or incorrect CMS data set name: file transfer canceled

You did not specify the CMS data set name, or the specified CMS data set name is incorrect.

TRANS18 - Incorrect option specified: file transfer canceled

You specified an option that is invalid.

TRANS19 - Error while reading or writing to host disk: file transfer canceled

There is not enough space available for data on the host.

TRANS28 - Invalid option xxxxxxxx: file transfer canceled

You selected an option that is either not recognized, is specified as a positional keyword, or has an associated value that is incorrect.

TRANS29 - Invalid option xxxxxxxx with RECEIVE: file transfer canceled

You selected an option that is not valid with RECEIVE, but can be used with SEND.

TRANS30 - Invalid option xxxxxxxx with APPEND: file transfer canceled

You selected an option that is not valid with APPEND, but otherwise may be used.

TRANS31 - Invalid option xxxxxxxx without SPACE: file transfer canceled

You selected an option that can only be used if SPACE is also specified.

TRANS32 - Invalid option xxxxxxxx with PDS: file transfer canceled

You selected an option that is invalid with a host-partitioned data set.

TRANS33 - Only one of TRACKS, CYLINDERS, AVBLOCK allowed: file transfer canceled

SPACE can be specified in units of TRACKS, CYLINDERS, or AVBLOCK, and only one option can be used.

TRANS34 - CMS file not found: file transfer canceled

You did not specify an existing CMS file for RECEIVE.

TRANS35 - CMS disk is read-only: file transfer canceled

You specified a CMS file mode for the SEND key that does not allow write access.

TRANS36 - CMS disk is not accessed: file transfer canceled

You specified a CMS file mode that is not in the CMS search order.

TRANS37 - CMS disk is full: file transfer canceled

The CMS disk is full, or the maximum number of files on the minidisk (3400) has been reached, or the maximum number of data blocks per file (16060) has been reached.

TRANS99 - Host program error code xxxxxxxxxx: file transfer canceled

This is a host program error.