|
|
|
|
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
|
|
|
|
|