NFT messages may be distinguished from NFT/3000 messages in the following way:
bit 2 of the DSCOPY result parameter or of the NFTERR JCW indicates
the appropriate error set (on=NFT/3000; off=generic). The
DSCOPYMSG intrinsic is able to determine the correct error set.
In the descriptions of the following error messages and warnings, many
references are made to qualifying error-message strings. These strings are
returned with the Network File Transfer (NFT) errors described below to further
qualify errors that occur.
Level: 2
CAUSE: Error in logging on to the source computer, or
no logon string supplied where required.
ACTION: Check the logon string or provide a logon string
and try again.
MESSAGE: UNABLE TO LOGON TO TARGET NODE.
Level: 3
CAUSE: Error in logging on to the target computer, or
no logon string where required.
ACTION: Check the logon string or provide a logon string
and try again.
MESSAGE: UNABLE TO ACCESS SOURCE FILE/DEVICE.
Level: 4
CAUSE: An unexpected file system error occurred in opening
or accessing the source file.
ACTION: Verify that the source file is accessible. Also,
refer to the qualifying file system error string.
MESSAGE: UNABLE TO CONNECT TO SOURCE NODE.
Level: 5
CAUSE: A connection could not be established to the computer where
the source file resides. Either the source-computer name is incorrect, the
source computer is not connected to the network, or there are insufficient
resources.
ACTION: Verify that the source-computer name is correct, that the
source computer is connected to the network, and that there are sufficient
resources to establish a connection. Also, refer to the qualifying error
string. Check the log file for PM errors.
MESSAGE: UNABLE TO CONNECT TO TARGET NODE.
Level: 6
CAUSE: A connection could not be established to the computer where
the target file resides. Either the target-computer name is incorrect, or
the target computer is not connected to the network, or there are
insufficient resources.
ACTION: Verify that the target-computer name is correct, that the
target computer is connected to the network, and that there are sufficient
resources to establish a connection. Also, refer to the qualifying error
string. Check the log file for PM errors.
MESSAGE: INSUFFICIENT RESOURCES ARE AVAILABLE ON SOURCE NODE.
Level: 7
CAUSE: Insufficient resources at the source computer
to carry out the file transfer.
ACTION: Verify that there are sufficient resources on
the source computer and try again. Verify that DST tables are available.
Check that the configured maximum number of DST table entries is
large enough.
MESSAGE: INSUFFICIENT RESOURCES ARE AVAILABLE ON TARGET NODE.
Level: 8
CAUSE: Insufficient resources at the target computer
to carry out the file transfer.
ACTION: Verify that there are sufficient resources on
the target computer and try again. Verify that DST tables are available.
Check that the configured maximum number of DST table entries is
large enough.
MESSAGE: SOURCE FILE WAS NOT FOUND.
Level: 9
CAUSE: Source file specified does not exist.
ACTION: Verify that the source file name is
correct.
MESSAGE: TARGET FILE WAS NOT FOUND.
Level: 10
CAUSE: The target file does not exist and APPend was specified.
ACTION: Verify that the target file name is
correct.
MESSAGE: TRANSFER STOPPED PER USER REQUEST.
Level: 11
CAUSE: Acknowledges the user's Abort or Cancel request.
ACTION: None. This is an informational message
only.
MESSAGE: COUNTER OFFER.
Level: 13
CAUSE: An internal error has occurred during negotiations
between the source and target computers.
ACTION: See Appendix A "Submitting a CR"
of this manual.
MESSAGE: REQUESTED DATA TYPE WAS REFUSED.
Level: 14
CAUSE: Consumer mainframe refused the data type offered
by the producer mainframe.
ACTION: Consult Using NS 3000/iX Network Services for the
use of the ASC (ASCII) and BIN (binary)
option.
MESSAGE: REQUESTED RECORD WAS REFUSED.
Level: 15
CAUSE: Consumer mainframe refused the record type offered
by the producer mainframe.
ACTION: Consult Using NS 3000/iX Network Services for the
use of the FIX (fixed) and VAR (variable)
options.
MESSAGE: REQUESTED FILE TYPE WAS REFUSED.
Level: 16
CAUSE: Consumer mainframe refused the file type offered
by the producer mainframe.
ACTION: Consult Using NS 3000/iX Network Services for the
use of the DIR (direct) and SEQ (sequential)
options.
MESSAGE: REQUESTED RECORD SIZE WAS REFUSED.
Level: 17
CAUSE: Consumer mainframe refused the file size offered
by the producer mainframe.
ACTION: Consult Using NS 3000/iX Network Services for
the RSIZE option.
MESSAGE: REQUESTED FILE SIZE WAS REFUSED.
Level: 18
CAUSE: Consumer mainframe refused the file size offered
by the producer mainframe.
ACTION: Consult Using NS 3000/iX Network Services for
the FSIZE option.
MESSAGE: CONFLICTING ATTRIBUTES OR OPTIONS.
Level: 19
CAUSE: If an overwrite operation is attempted and the files
involved do not have compatible attributes, this error will result. Also,
if a file equation has been issued to change the characteristics of the
target file to be incompatible with those of the source file, this error is
returned.
ACTION: Try the REP (replace) option or remove the
offending file equation.
MESSAGE: TARGET RECORD SIZE IS INVALID.
Level: 20
CAUSE: Requested RSIZE is too large.
ACTION: Specify a smaller record size.
MESSAGE: TARGET FILE SIZE IS INVALID.
Level: 21
CAUSE: Requested FSIZE is too large.
ACTION: Specify a smaller record size.
MESSAGE: DUPLICATE TARGET FILE.
Level: 22
CAUSE: The target file exists and neither REPLACE nor
OVERWRITE was specified.
ACTION: Verify that the target file name is correct, and
specify REPLACE or OVERWRITE.
MESSAGE: NEED PASSWORD TO ACCESS SOURCE FILE.
Level: 23
CAUSE: Source file could not be accessed without proper password.
ACTION: Specify the password and the source-file name
and try again.
MESSAGE: NEED PASSWORD TO ACCESS TARGET FILE.
Level: 24
CAUSE: Target file could not be accessed without proper password.
ACTION: Specify the password and the target-file name
and try again.
MESSAGE: OUT OF DISK SPACE.
Level: 25
CAUSE: The target computer has run out of disk space.
The target file will not fit.
ACTION: Purge unused files on the target computer and
try again.
MESSAGE: CONNECTION TO SOURCE NODE HAS GONE DOWN.
Level: 26
CAUSE: An error was detected on the connection to the computer
where the source files reside. If the file-producer program is still active
on the source computer, it will attempt to carry out the remainder of the
user-file copy command (perhaps causing several file transfers to
occur if wildcards were given). If the file producer is no longer active,
the remaining files were not transferred.
ACTION: Determine which, if any, of the files were not transferred.
Transfer these files by specifying the proper command and trying
again.
MESSAGE: CONNECTION TO TARGET NODE HAS GONE DOWN.
Level: 27
CAUSE: An error was detected on the connection to the computer
where the target files are to be created. If this error occurs while the
file producer is in the middle of copying several files, the current file
may not have been copied successfully and an attempt will not be made to
copy the remainder of the files.
ACTION: Specify a command to copy the remainder of the
files, and try again.
MESSAGE: UNABLE TO PURGE TARGET FILE.
Level: 28
CAUSE: The existing target file could not be purged.
ACTION: Refer to the qualifying file system error string
to determine what to do.
MESSAGE: INVALID TARGET FILE.
Level: 29
CAUSE: Check the target file name syntax and try again.
ACTION: Refer to the qualifying file system error string
to determine what to do.
MESSAGE: UNABLE TO PURGE SOURCE FILE.
Level: 30
CAUSE: The source file could not be purged after successfully
copying the file (the MOVE option was given).
ACTION: Refer to the qualifying file system error string
to determine what to do.
MESSAGE: READ FROM SOURCE FILE FAILED.
Level: 31
CAUSE: An unexpected file system error occurred while
reading from the source file.
ACTION: Refer to the qualifying file system error string
to determine what to do.
MESSAGE: WRITE TO TARGET FILE FAILED.
Level: 32
CAUSE: An unexpected file system error occurred while
writing data to the target file.
ACTION: Refer to the qualifying file system error string
to determine what to do.
MESSAGE: UNABLE TO CREATE OR OPEN TARGET FILE.
Level: 33
CAUSE: An unexpected file system error occurred in creating
or opening the target file.
ACTION: Refer to the qualifying file system error string
to determine what to do.
MESSAGE: INVALID OR UNSUPPORTED SOURCE DEVICE.
Level: 34
CAUSE: A request was made to send a file to a non-disk
device. Such transfers are not supported.
ACTION: Copy the non-disk device file to a disk file using a
system utility program, and then use DSCOPY to copy that file to
the target computer.
MESSAGE: INVALID OR UNSUPPORTED TARGET DEVICE.
Level: 35
CAUSE: A request was made to send a file to a non-disk
device. Such transfers are not supported.
ACTION: Copy the file to disk on the target computer using
DSCOPY and then to the non-disk device using a system
utility program.
MESSAGE: UNABLE TO CLOSE TARGET FILE.
Level: 36
CAUSE: An unexpected file system error occurred in closing
the target file.
ACTION: Refer to the qualifying file system error string
to determine what to do
MESSAGE: INCORRECT SOURCE FILE PASSWORD.
Level: 38
CAUSE: The given source file password was incorrect.
ACTION: Specify the correct source file password and try
again.
MESSAGE: INCORRECT TARGET FILE PASSWORD.
Level: 39
CAUSE: The given target file password was incorrect.
ACTION: Specify the correct target file password and try
again.
MESSAGE: INVALID CHARACTERS IN TARGET FILE WERE REMOVED.
Level: 41
CAUSE: Some non-MPE systems allow characters in file names that
are not allowed on MPE systems. These characters are removed from a file
name when that file is transferred to an MPE system.
ACTION: None.
MESSAGE: TARGET FILE NAME HAS BEEN TRUNCATED.
Level: 42
CAUSE: Some non-MPE systems allow file names to be longer than 8
characters. These names are truncated to 8 characters when transferred to
an MPE system.
ACTION: None.
MESSAGE: SOURCE AND TARGET FILE ATTRIBUTES DIFFER.
Level: 43
CAUSE: If interchange mode is used, source file attributes
may differ from target file attributes.
ACTION: None.
MESSAGE: RECORDS(S) WERE TRUNCATED TO FIT MAXIMUM TARGET FILE RECORD SIZE.
Level: 44
CAUSE: When the target file's record size is smaller than the
source file's record size, the source file's records are truncated to fit
the target file's record size.
ACTION: None.
MESSAGE: COMPRESSION WILL NOT BE DONE FOR THE CURRENT TRANSFER.
Level: 45
CAUSE: The source and/or the target computer does not support data
compression (the COMPRESS option); or the transfer is local. File
transfer will continue without data compression.
ACTION: None.
MESSAGE: UNABLE TO TURN ON TRACING.
Level: 46
CAUSE: Indicates that an internal error has occurred.
File transfer will continue without tracing.
ACTION: See Appendix A "Submitting a CR"
of this manual.
MESSAGE: INVALID USE OF STRIP OPTION.
Level: 47
CAUSE: The STRIP option cannot be used with files that
have variable-length records.
ACTION: Do not use the STRIP option with files having
variable-length records.
MESSAGE: UNABLE TO ACCESS TARGET FILE/DEVICE
Level: 48
CAUSE: An unexpected file system error occurred in accessing
the target file. This may mean that a file equation specified access
options which conflict with those desired by NFT.
ACTION: Verify that the target file is accessible, reset
previously given file equations, and specify attributes which do
not conflict with those desired by NFT. Also, refer to the qualifying
file system error string.
MESSAGE: INVALID SOURCE FILE ID.
Level: 49
CAUSE: The source file name is invalid on the source computer.
ACTION: Check the source file name syntax and try
again.
MESSAGE: APPEND NOT SUPPORTED.
Level: 51
CAUSE: Target mainframe does not support the APP
(append) option.
ACTION: None.
MESSAGE: OVERWRITE NOT SUPPORTED.
Level: 52
CAUSE: Target mainframe does not support the OVER
(overwrite) option.
ACTION: None.
MESSAGE: ERROR IN GENERATING LIST OF FILES MATCHING REQUEST.
Level: 54
CAUSE: An error occurred while a generic source file
specification was being processed.
ACTION: Verify that the generic source file specification
does match up with existing files.
MESSAGE: INCOMING CONNECTION HAS GONE
DOWN.
Level: 57
CAUSE: An incoming connection to an NFT server program
has gone down for an unknown reason.
ACTION: This error will appear only in a log file. See
Appendix A "Submitting a CR"
MESSAGE: MOVE NOT SUPPORTED.
Level: 58
CAUSE: Source mainframe does not support the MOVE option.
The transfer will take place, but the source file will not be purged.
ACTION: None.
MESSAGE: UNABLE TO OPEN CHECKPOINT/RESTART FILE.
Level: 59
CAUSE: NFT cannot open the file containing the information needed
to restart a checkpointed transfer. This may be caused by the following
factors:
If CHECKPT is specified: 99 restart files already exist
in the group and account of one of the roles (initiator, producer, or
consumer).
If RESTART is specified: the file does not exist, or is
being accessed exclusively, or the user is logged on to a different
group or account to restart than when checkpointing.
ACTION: Be sure there are fewer than 99 restart files in any of
the necessary groups and accounts. Determine whether the file exists, and
if so, make sure that the file is not being accessed. Also check to make
sure that you are logged on as the same user, group, and account number as
when checkpointing.
MESSAGE: UNABLE TO RETRIEVE RESTART INFORMATION.
Level: 60
CAUSE: NFT fails to obtain valid information from the
checkpointing/restart file and cannot restart the transfer. An
FREAD error may have been received from the restart file, or the
restart file may be in an inconsistent state and contains incomplete or
invalid data.
ACTION: None.
MESSAGE: UNABLE TO STORE CHECKPOINT INFORMATION.
Level: 61
CAUSE: NFT failed to store valid information to the
checkpoint/restart file. This error is returned only if the data transfer
portion of the NFT transaction has begun and an FWRITE error to
the checkpoint/restart file has occurred.
ACTION: Attempt to restart the transfer. If this fails
consistently, there may be a problem with the file system. See
Appendix A "Submitting a CR" of this
manual.
MESSAGE: UNABLE TO RESTART TRANSFER.
Level: 62
CAUSE: NFT attempted to restart a generic transfer and was unable
to open the generic listf file, i.e., the file which contains the
list of files to be transferred. This would occur if the file is opened
exclusively or has been purged.
ACTION: Make sure that the generic listf file
(GENSETn) exists in the producer's group and account and is not
accessed exclusively.
MESSAGE: SOURCE AND TARGET CHECKPOINTS DO NOT MATCH.
Level: 63
CAUSE: A restart has been attempted and the producer and consumer
checkpoints do not match. The checkpoint restart file has been corrupted,
or a serious internal NFT error has occurred.
ACTION: Restart the transfer from scratch. If the problem persists,
see Appendix A "Submitting a CR" of this
manual.
MESSAGE: UNABLE TO INITIATE CHECKPOINTING.
Level: 64
CAUSE: This warning is issued for any one of the following reasons:
A checkpoint/restart file cannot be opened or created.
The restart ID file cannot be opened or created.
The information cannot be written to the checkpoint/restart file,
the generic listf file, or the restart ID file.
Checkpointing is being attempted on a circular file, a message
file, or a variable length record file in interchange mode.
Checkpointing is being attempted to a node which does not support
checkpointing.
ACTION: After the warning is issued, the file transfer will
continue with no checkpointing taking place. You may wish to abort the
transfer.
MESSAGE: CHECKPOINTING WILL NOT BE DONE FOR LOCAL TRANSFERS.
Level: 65
CAUSE: Checkpointing has been specified for a transfer
for which the producer and consumer environments are equivalent,
i.e., their group, account, and node name are the same.
ACTION: Transfer will continue with no checkpointing. You
may wish to abort the transfer.
MESSAGE: FOUND END OF FILE MARK IN TARGET FILE, TRANSFER STOPPED.
Level: 66
CAUSE: Use of the FSIZE option has resulted in a target
file too small to hold the source file. After the target file is full, the
transfer is stopped.
ACTION: None.
MESSAGE: TARGET FILE BLOCK SIZE BEING CHANGED DUE TO FILE SYSTEM DIFFERENCES.
Level: 67
CAUSE: The block size for the Native Mode KSAM file has
changed because of the file system differences.
ACTION: None.