Previous Page Contents Page Next Page

Appendix A: File Transfer Messages

There are two types of errors that can occur during file transfer-those detected by the file transfer program and those detected by the AS/400. This section describes the error messages provided, and the cause of each.

A.1 File Transfer Program Errors and Warnings

The file transfer program completes the file transfer with an exit code of 0 (zero) if the operation was successful. A return code of FT_AS400_ERR indicates that an error message was received from the AS/400. Other return codes and their causes are listed below. There is one return code for each error category, and for each return code there are a number of different text messages that can appear on the screen. This section describes each error category, and provides more detailed information about each of the error messages that you might see.

A.1.1 FT_OK

This return code indicates that the file transfer has completed successfully.

Warning: conversion type from description file overrides command line

A data conversion was specified on the command line with the option which did not agree with the PCFT entry in the description file.

Field field_name in record record_name is too long

The file transfer program is warning you that a field will be truncated.

A.1.2 FT_AS400_ERR

This return code indicates that the AS/400 has returned an error. AS/400 error messages are described in the following section.

Unrecognized response type

The error received from the AS/400 is not recognized. It is not one of the messages described in the following section. Consult your system support staff.

A.1.3 FT_APPC_ERR

This return code indicates an internal protocol error that may be occurring as the result of a configuration error. Record the information provided on the screen and report the error to your System Administrator.

Unexpected APPC error - report to System Administrator. (Failing verb: verb_name Primary return code primary_rc Secondary return code secondary_rc)

This verb failed with the return code listed above. Report this error to your System Administrator.

APPC system error (errno return_code) Report to System Administrator

A verb failed with the return code listed above. Report this error to your System Administrator.

Invalid Primary LU Alias specified

Report this error to your System Administrator.

Cannot start File Transfer as SNA Software is not running

Report this error to your System Administrator. You will not be able to transfer files until your SNA software has been started.

Cannot continue File Transfer - SNA Software has terminated

Report this error to your System Administrator. You will not be able to transfer files until your SNA software has been restarted.

The default LU alias is not available for File Transfer

Report this error to your System Administrator.

Invalid LUs for File Transfer - (invalid mode)

Report this error to your System Administrator.

APPC parameter check on verb verb_name: secondary return code return_code

Report this error to your System Administrator.

Invalid security configured for the LU-PLU combination

Report this error to your System Administrator.

Allocation failure - No retry

Report this error to your System Administrator.

Allocation failure - Retry

Report this error to your System Administrator.

Allocation Error. Verb verb_name secondary return code return_code

Report this error to your System Administrator.

A.1.4 FT_MEMORY_ERR

This return code indicates that the file transfer program has encountered a memory problem. Try reducing the number of programs that you have running on your computer, or report the problem to your system support staff.

Memory allocation failure

The transfer program was unable to acquire the memory that it requires to complete the file transfer command. Ensure that you do not have other programs running on the computer which are not needed, as these may be using the available memory.

A.1.5 FT_ABORTED_ERR

This return code indicates that the file transfer operation was aborted. The possible reasons for this are listed below.

Transfer would have overwritten host data - abort

The specified file and member already exist on the AS/400, and so they would have been overwritten if the file transfer had completed. The file transfer program did not complete the file transfer operation because you specified in the command line or answered no to the prompt (indicating that you did not wish existing files or members to be overwritten). Specify a different destination file and member on the AS/400, and try again, or specify on the command line so that the existing file is overwritten.

Transfer would have truncated data - abort

Data in the local file was too large for the host record, and so the file transfer program would have had to truncate lines to be able to transfer the file successfully. The file transfer program did not complete the file transfer operation because you specified in the command line or answered no to the prompt (indicating that you did not wish lines to be truncated). Change the local file (for more information about how to do this, refer to your AS/400 documentation), or specify on the command line so that the existing file is overwritten.

A.1.6 FT_CMDLINE_ERR

This return code indicates that the file transfer program was unable to complete the file transfer because there was an error in the command that you specified. The structure of the commands and the different options that can be specified are documented in File Transfer Command Syntax.

Usage: sna400ft list | send | receive | transfer [options]

The sna400ft command was specified without any parameters. For more information about the different parameters that can be specified for the file transfer program, see File Transfer Command Syntax.

keyword keyword not recognized.

The listed keyword was not recognized by the file transfer program (a keyword must be one of send, receive, list or transfer). For more information about the valid keywords and their options, see File Transfer Command Syntax.

No Solaris filename was specified

You specified the send or receive keyword on the command line but did not supply a local file name. For more information about the parameters that must be supplied with the send and receive keywords, see File Transfer Command Syntax.

No AS/400 location was specified

You specified the send or receive keyword on the command line but did not supply a location on the AS/400. For more information about the parameters that must be supplied with the send and receive keywords, see File Transfer Command Syntax.

Missing parameter for option option

You specified an option without supplying any parameters for it. For more information about the parameters that must be supplied with each option, see File Transfer Command Syntax.

Unrecognized parameter for Option option

You specified an option with one or more parameters that the file transfer program was unable to recognize. For more information about valid parameters for each option, see File Transfer Command Syntax.

option is an illegal option for this keyword

The option that you specified is not a valid option for the keyword (send, receive, list or transfer) that you specified. For more information about valid options for each keyword, see File Transfer Command Syntax.

Both and options specified.

You specified both the and options on the command line. Specify only one of these options. For more information about general file transfer options, see File Transfer Command Syntax.

No transfer request was specified

You specified the transfer keyword without either including a transfer request in the command line or supplying information in the TR file. For more information about using the transfer keyword, see File Transfer Command Syntax.

A reffile was specified without a description file

You specified the option without specifying a description file. For more information about how to specify a description file, see File Transfer Command Syntax.

No reffile was specified.

You used the send keyword without specifying a reference file. Specify a reference file using the option if you are using the send keyword. For more information about the option, see File Transfer Command Syntax.

Bad partner LU name

The partner LU name or alias that you specified contained a character that was not valid. For more information about specifying the partner LU, see File Transfer Command Syntax.

A.1.7 FT_FIELD_FORMAT_ERR

This return code indicates that there is a problem with a particular field. The error messages listed below provide more information. For more information, refer to your AS/400 documentation.

Syntax error: field field_name in record record_name

The data in the specified field and record in the local data file is not valid for the encoding defined by the description file. For more information, refer to your AS/400 documentation.

Cannot find field field_name in the local description file

The field format specified for the given field does not exist in the local description file or does not match the information given in the description file. For more information, refer to your AS/400 documentation.

Data block length and length word do not agree

The file transfer program has detected an error in the data received from the AS/400. For more information, refer to your AS/400 documentation.

Error decoding data in field field_name record record_number

The file transfer program was unable to decode the field data that it received from the AS/400. For more information, refer to your AS/400 documentation.

Unrecognized field type in field descriptor field_number

The file transfer program could not recognize the field type in the field descriptor. For more information, refer to your AS/400 documentation.

Too many fields in description file

There are more than 256 PCFL entries in the description file. For more information, refer to your AS/400 documentation.

Incorrect data received in end-of-record markers

The file transfer program was not able to recognize the data that it received in the end-of-file (EOF) markers. For more information, refer to your AS/400 documentation.

Incorrect data received in header

The file transfer program was not able to recognize the data that it received in the header. For more information, refer to your AS/400 documentation.

Host file is not a source file - give a description file

An attempt to transfer data to or from a data file on the host was made, but no description file was specified. A description file must be specified if the file on the AS/400 is a data file (it is not required if the file on the AS/400 is a source file).

A.1.8 FT_FILE_FORMAT_ERR

This return code indicates that the file transfer program has detected an error in the format of a file. For more information, refer to your AS/400 documentation.

Substitution symbol symbol in transfer request file is invalid

The symbol was not of the form %d where d is an integer. For more information about transfer request files, refer to your AS/400 documentation.

Incorrect PCFT line in description file

The file transfer program has found that the PCFT line in the description file is not present or has syntax that is not valid. For more information about description files, refer to your AS/400 documentation.

PCFL file error, line line_number

The file transfer program encountered an error in the PCFL file, on the line specified. For more information about errors in PCFL files, check the specified line and refer to your AS/400 documentation.

PCFL field error, line line_number

The file transfer program encountered an error in a field in the PCFL file, on the line specified. For more information about errors in PCFL fields, check the specified line and refer to your AS/400 documentation.

A.1.9 FT_LANGUAGE_ERR

This return codes indicates that the file transfer program has been unable to perform the required data conversion. For more information, refer to your AS/400 documentation.

Error: cannot open conversion files

The file transfer program was not able to initialize the language database because it could not open the conversion files. Ensure that the file transfer command specified the correct local and host codepages.

Error: failed to open conversion tables

The file transfer program was not able to open the conversion tables for the local and host codepages that you specified. Ensure that the file transfer command specified the correct local and host codepages.

A.1.10 FT_LOCAL_FILE_ERR

This return code indicates that the file transfer program has encountered an error with the local file.

Cannot open transfer request file

The file transfer program is unable to find the transfer request file that you specified on the local machine.

Cannot access local data file

The file transfer program was unable to access the local data file. There may have been a problem opening it, reading from it, writing to it, or closing it. Ensure that the local file has the correct file permissions set up for it.

Cannot access description file

The file transfer program was unable to access the description file. There may have been a problem opening it, reading from it, writing to it, or closing it. Ensure that the description file has the correct file permissions set up for it.

Error writing field field_name to description file

The file transfer program failed to write a field descriptor to the local description file. Ensure that the description file has the correct file permissions set up for it.

PCFT description file error

The file transfer program was unable to read the local description file. Refer to your AS/400 documentation and ensure that this file has been set up correctly.

Transfer would have overwritten local file filename - abort

The local file existed already, and you specified on the command line or replied no to the prompt (indicating that you did not wish existing files to be overwritten).

Error writing to local file file_name

The file transfer program was unable to write to the specified local file. Check that the specified file exists, and that you have write permission for that file.

A.1.11 FT_OS_ERR

This return code indicates that the file transfer program has encountered an error with the operating system.

Failed to create timeout signal

You specified a timeout with your file transfer command by specifying the option with a number of seconds, but the file transfer program was unable to set an alarm to signal the end of the timeout period. Try the command again, without specifying any timeout parameter, or consult your system support staff.

A.1.12 FT_TIMEOUT

This return code indicates that the file transfer command timed out.

Transfer command timed out

You specified a timeout with your file transfer command by specifying the option with a number of seconds but the transfer did not complete before the specified number of seconds. This may indicate that there are network problems, which are delaying the command, or that the AS/400 is unable to process the command for some reason. Try again, either with an increased timeout value, or without specifying any timeout option.

Previous Page Contents Page Top of Page Next page