z/OS Network File System Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Special reason codes (xx is 00-0F)

z/OS Network File System Guide and Reference
SC23-6883-00

Reason codes whose xx part is in the range 00 through 0F have special meanings. Table 1 contains the rest of the reason code information that is presented in client messages, including the return codes retc.

Table 1. Special NFS reason codes
xx Error type yyyy Description
01 Parsing error   See Table 2 and Table 3.
02 TCP/IP common error 0001 clntudp_create( ) failed
02 TCP/IP common error 0002 Server NFS port is not 2049
02 TCP/IP common error 0003 authunix_create( ) failed
02 TCP/IP common error 0004 clnt_control( ) timeout failed
02 TCP/IP common error 0005 clnt_control( ) total timeout failed
02 TCP/IP common error 0006 clnttcp_create( ) failed
02 TCP/IP common error 0007 clntudp_bufcreate( ) failed
02 RPCSEC_GSS error 0008 RPCSEC_GSS request failed.

Probable cause: This failure can happen because of the following reasons:

  1. The Kerberos Dynamic Load Library could not be loaded by the NFS client.
  2. The kerberos context could not be created by the NFS client.
  3. The GSS credentials for the NFS client's Kerberos Principal could not be obtained.

Action: Check your kerberos configurations, fix any configuration issues identified, restart the NFS client and retry the operation. Contact the system programmer if the problem persists.

02 TCP/IP common error lnum clnt_call( ) timeout (retc=0467h, ETIMEDOUT)

Action: Increase the value of the timeo client attribute on the mount command.

02 TCP/IP common error lnum clnt_call( ) EINTR (retc=0078h, EINTR)
03 RPC error 0003 RPC_CANTSEND: failure in sending RPC call
03 RPC error 0004 RPC_CANTRECV: failure in receiving RPC result
03 RPC error 0005 RPC_CANTSEND: RPC call timed out
04 TCP/IP error yyyy Authentication error - authunix_create( ) failed
05 NFS protocol error 0001 EPERM Not owner (operation not permitted)

Probable cause: An attempt was made to perform an operation limited to processes with appropriate privileges or to the owner of a file or other resource.

Action: Ensure that uid and gid are correct.

05 NFS protocol error 0002 ENOENT No such file or directory

Probable cause: A component of a specified path name does not exist, or the path name is an empty string.

Action: Ensure that the file/directory exists.

05 NFS protocol error 0005 EIO I/O error

Probable cause: Some physical input or output error occurred.

Action: No action required.

05 NFS protocol error 0006 ENXIO No such device or address

Probable cause: Input or output on a special file refers to a device that does not exist, or makes a request beyond the capabilities of the device. It may also occur when, for example, a tape drive is not on-line.

Action: Ensure that the mount address is correct.

05 NFS protocol error 000D EACCES Permission denied

Probable cause: An attempt was made to access a file in a way forbidden by its file access permissions.

Action: Verify that the correct access authority is being requested.

05 NFS protocol error 0011 EEXIST File/dir exists

Probable cause: An existing file/dir was mentioned in an inappropriate context; for example, as a new link name in the link function.

Action: Try to use another file/dir name.

05 NFS protocol error 0012 EXDEV Cross-device link

Probable cause: A hard link to a file on another file system was attempted.

Action: Ensure that the link is correct.

05 NFS protocol error 0013 ENODEV No such device

Probable cause: An attempt was made to apply an inappropriate function to a device; for example, trying to read a write-only device such as printer.

Action: Ensure that the command parameters are correct.

05 NFS protocol error 0014 ENOTDIR Not a directory

Probable cause: A component of the specified path name exists, but it is not a directory, when a directory was expected.

Action: Ensure that the specified path name is correct.

05 NFS protocol error 0015 EISDIR Is a directory

Probable cause: An attempt was made to open a directory with write mode specified.

Action: Ensure that the access mode is correct.

05 NFS protocol error 0016 EINVAL Incorrect arguments

Probable cause: Some invalid argument was supplied, source had an invalid superblock or, a remount was attempted, while source was not already mounted on target.

Action: Ensure that the arguments are correct. If remount is used, determine that the mount command was made.

05 NFS protocol error 001B EFBIG File too large

Probable cause: The size of a file would exceed the maximum file size of implementation or offset maximum established in the corresponding file description.

Action: Operate with files that satisfy maximum file size requirement and use offsets that satisfy maximum offset requirement.

05 NFS protocol error 001C ENOSPC No space left on device

Probable cause: During the write function on a regular file or when extending a directory, there is no free space left on the device.

Action: Use another directory or device for store file or clear hash/garbage (be sure that these data are useless).

05 NFS protocol error 001E EROFS Read-only file system

Probable cause: An attempt was made to modify a file or directory on a file system that is read only.

Action: Ensure that you have sufficient privileges.

05 NFS protocol error 001F EMLINK Too many links

Probable cause: An attempt was made to have the link count of a single file exceed (LINK_MAX).

Action: –

05 NFS protocol error 003F ENAMETOOLONG File name is too long

Probable cause: The length of a pathname exceeds (PATH_MAX), or a pathname component is longer than (NAME_MAX) and (_POSIX_NO_TRUNC) was in effect for that file.

Action: Use names that correspond with filename requirements.

05 NFS protocol error 0042 ENOTEMPTY Directory is not empty

Probable cause: A directory with entries other than dot and dot-dot was supplied when an empty directory was expected.

Action: Ensure that the directory is empty.

05 NFS protocol error 0045 EDQUOT Disk quota exceeded

Probable cause: The user’s quota of disk blocks or user’s quota of inodes was exhausted.

Action: Ensure that free space is available on the disk.

05 NFS protocol error 0046 ESTALE File handle is stale

Probable cause: An attempt was made to access an open file (on an NFS file system) which is now unavailable as referenced by the file descriptor. This may indicate the file was deleted on the NFS server or some other catastrophic event occurred.

Action: Ensure that file was not deleted on the NFS server.

05 NFS protocol error 0047 EREMOTE Too many levels of remote

Probable cause: Server made attempt to handle an NFS request by generating a request to another NFS server, which is not allowed.

Action: No action required.

05 NFS protocol error 2711 EBADF (NFSERR_BADHANDLE) Bad file descriptor

Probable cause: A file descriptor argument is out of range, refers to no open file, or a read (write) request is made to a file that is only open for writing (reading).

Action: Ensure that the descriptor is right.

05 NFS protocol error 2712 EBADF (NFSERR_NOT_SYNC) Not sync

Probable cause: Update synchronization mismatch was detected during a SETATTR operation.

Action: –

05 NFS protocol error 2713 EFAULT (NFSERR_BAD_COOKIE) Bad cookie

Probable cause: READDIR cookie is stale.

Action: Retry the read dir operation.

05 NFS protocol error 2714 ENOSYS (NFSERR_NOTSUPP) Operation not supported

Probable cause: An attempt was made to use a function or operation that is not available in this implementation.

Action: Ensure that the operation is available and the command is right.

05 NFS protocol error 2715 ENOBUFS (NFSERR_TOOSMALL) Buffer too small

Probable cause: Insufficient buffer resources were available in the system to perform the socket operation.

Action: Increase the size of the socket buffers.

05 NFS protocol error 2716 EIO (NFSERR_SERVERFAULT) Server fault

Probable cause: An error occurred on the server which does not map to any of the legal NFS version 4 protocol error values.

Action: –

05 NFS protocol error 2717 ENXIO (NFSERR_BADTYPE) Bad type

Probable cause: The named file is a character-special or block-special file and the associated device does not exist.

Action: Ensure that the mount address is correct.

05 NFS protocol error 2718 EAGAIN (NFSERR_JUKEBOX/NFSERR_DELAY Jukebox

Probable cause: The server initiated the request, but was not able to complete it in a timely fashion.

Action: No action required. (This is a temporary condition and later calls to the same routine may complete normally.)

05 NFS protocol error 2719 EIO (NFSERR_SAME) nverify says attrs same

Probable cause: This error is returned by the NVERIFY operation to signify that the attributes compared were the same as provided in the client request.

Action: No action required.

05 NFS protocol error 271A ENOLCK (NFSERR_DENIED) Lock unavailable

Probable cause: A system-imposed limit on the number of simultaneous file locks was reached.

Action: Wait and retry the operation.

05 NFS protocol error 271B EIO (NFSERR_EXPIRED) Lock lease expired

Probable cause: A lease has expired that is being used in the current operation.

Action: Retry the operation.

05 NFS protocol error 271C EIO (NFSERR_LOCKED) I/O failed due to lock

Probable cause: A read/write operation was attempted on a locked file.

Action: Wait and retry the operation.

05 NFS protocol error 271D EIO (NFSERR_GRACE) In grace period

Probable cause: This server is in its recovery or grace period which should match the lease period of the server.

Action: Wait and retry the operation.

05 NFS protocol error 271E EIO (NFSERR_FHEXPIRED) File handle expired

Probable cause: The file handle provided is volatile and has expired at the server.

Action: Try to remount.

05 NFS protocol error 271F EIO (NFSERR_SHARE_DENIED) Share reserve denied

Probable cause: An attempt to OPEN a file with a share reservation has failed because of a share conflict.

Action: Solve a share conflict.

05 NFS protocol error 2720 EACCES (NFSERR_WRONGSEC) Wrong security flavor

Probable cause: An open with write mode has been attempted to a write protected tape.

Action: Ensure that the user has sufficient privileges.

05 NFS protocol error 2721 EIO (NFSERR_CLID_INUSE) Clientid in use

Probable cause: The SETCLIENTID operation has found that a client id is already in use by another client.

Action: Try to remount.

05 NFS protocol error 2722 EAGAIN (NFSERR_RESOURCE) Resource exhaustion

Probable cause: Requested resource, such as a lock or a process, is temporarily unavailable.

Action: Retry the operation. (This is a temporary condition and later calls to the same routine may complete normally.)

05 NFS protocol error 2723 EREMCHG (NFSERR_MOVED) Filesystem moved

Probable cause: The file system that contains the current file handle object is not present at the server. It may have been relocated, migrated to another server or may have never been present. The client may obtain the new file system location by obtaining the "fs_locations" attribute for the current file handle.

Action: No action required.

05 NFS protocol error 2724 EMVSERR (NFSERR_NOFILEHANDLE) No file handle

Probable cause: The logical current file handle value (or, in the case of RESTOREFH, the saved file handle value) has not been set properly. This may be a result of a malformed COMPOUND operation (that is, no PUTFH or PUTROOTFH before an operation that requires the current file handle be set).

Action: Try to remount.

05 NFS protocol error 2725 EIO (NFSERR_MINOR_VERS_MISMATCH) Minor version is not supported

Probable cause: The server has received a request that specifies an unsupported minor version. The server must return a COMPOUND4res with a zero length operations result array.

Action: No action required.

05 NFS protocol error 2726 EIO (NFSERR_STALE_CLIENTID) Server has rebooted

Probable cause: A clientid not recognized by the server was used in a locking or SETCLIENTID_CONFIRM request.

Action: Try to remount.

05 NFS protocol error 2727 EIO (NFSERR_STALE_STATEID) Server has rebooted

Probable cause: A stateid generated by an earlier server instance was used.

Action: Try to remount.

05 NFS protocol error 2728 EIO (NFSERR_OLD_STATEID) State is out of sync

Probable cause: A stateid that designates the locking state for a lockowner-file at an earlier time was used.

Action: Try to remount.

05 NFS protocol error 2729 EIO (NFSERR_BAD_STATEID) Incorrect stateid

Probable cause: A stateid generated by the current server instance, but which does not designate any locking state (either current or superseded) for current lockowner-file pair, was used.

Action: Try to remount.

05 NFS protocol error 272A EIO (NFSERR_BAD_SEQID) Request is out of sequence

Probable cause: The sequence number in a locking request is neither the next expected number or the last number processed.

Action: No action required.

05 NFS protocol error 272B EIO (NFSERR_NOT_SAME) verify - attrs not same

Probable cause: This error is returned by the VERIFY operation to signify that the attributes compared were not the same as provided in the client’s request.

Action: No action required.

05 NFS protocol error 272C EIO (NFSERR_LOCK_RANGE) Lock range not supported

Probable cause: A lock request is operating on a sub-range of a current lock for the lock owner and the server does not support this type of request.

Action: No action required.

05 NFS protocol error 272D EIO (NFSERR_SYMLINK) Should be file/directory

Probable cause: The current file handle provided for a LOOKUP is not a directory but a symbolic link. Also used if the final component of the OPEN path is a symbolic link.

Action: Ensure that the path name is correct.

05 NFS protocol error 272E EMVSERR (NFSERR_RESTOREFH) No saved file handle

Probable cause: The RESTOREFH operation does not have a saved file handle (identified by SAVEFH) to operate upon.

Action: No action required.

05 NFS protocol error 272F EREMCHG (NFSERR_LEASE_MOVED) Lease moved

Probable cause: A lease being renewed is associated with a file system that has been migrated to a new server.

Action: No action required.

05 NFS protocol error 2730 EIO (NFSERR_ATTRNOTSUPP) Recommended attr not supported

Probable cause: An attribute specified is not supported by the server. Does not apply to the GETATTR operation.

Action: No action required.

05 NFS protocol error 2731 EIO (NFSERR_NO_GRACE) Reclaim outside of grace

Probable cause: A reclaim of client state was attempted in circumstances in which the server cannot guarantee that conflicting state has not been provided to another client. This can occur because the reclaim has been done outside of the grace period of the server, after the client has done a RECLAIM_COMPLETE operation, or because previous operations have created a situation in which the server is not able to determine that a reclaim-interfering edge condition does not exist.

Action: No action required.

05 NFS protocol error 2732 EIO (NFSERR_RECLAIM_BAD) Reclaim error at server

Probable cause: The reclaim provided by the client does not match any of the server’s state consistency checks and is bad.

Action: No action required.

05 NFS protocol error 2733 EIO (NFSERR_RECLAIM_CONFLICT) Conflict on reclaim

Probable cause: The reclaim provided by the client has encountered a conflict and cannot be provided. Potentially indicates a misbehaving client.

Action: No action required.

05 NFS protocol error 2734 EMVSERR (NFSERR_BADXDR) XDR decode failure

Probable cause: The server encountered an XDR decoding error while processing an operation.

Action: No action required.

05 NFS protocol error 2735 EIO (NFSERR_LOCKS_HELD) Locks held at close

Probable cause: A CLOSE was attempted and file locks would exist after the CLOSE.

Action: No action required.

05 NFS protocol error 2736 EIO (NFSERR_OPENMODE) Conflict in OPEN & I/O

Probable cause: The client attempted a READ, WRITE, LOCK or SETATTR operation not sanctioned by the stateid passed (for example, writing to a file opened only for read).

Action: Ensure that the user has sufficient privileges.

05 NFS protocol error 2737 EIO (NFSERR_BADOWNER) Owner translation bad

Probable cause: An owner, owner_group, or ACL attribute value can not be translated to local representation.

Action: No action required.

05 NFS protocol error 2738 EIO (NFSERR_BADCHAR) Utf-8 char not supported

Probable cause: A UTF-8 string contains a character which is not supported by the server in the context in which it being used.

Action: Use correct character encoding symbols.

05 NFS protocol error 2739 EIO (NFSERR_BADNAME) Name not supported

Probable cause: A name string in a request consists of valid UTF-8 characters supported by the server but the name is not supported by the server as a valid name for current operation.

Action: Change the name on supported by the server.

05 NFS protocol error 273A ERANGE (NFSERR_BAD_RANGE) Lock range not supported

Probable cause: The result of the function is too large (overflow) or too small (underflow) to be represented in the available space.

Action: No action required.

05 NFS protocol error 273B EIO (NFSERR_LOCK_NOTSUPP) No atomic up/downgrade

Probable cause: –

Action: No action required.

05 NFS protocol error 273C EIO (NFSERR_OP_ILLEGAL) Undefined operation

Probable cause: An illegal operation value has been specified in the argop field of a COMPOUND or CB_COMPOUND procedure.

Action: Ensure that the operation is correct.

05 NFS protocol error 273D EDEADLK (NFSERR_DEADLOCK) File locking deadlock

Probable cause: An attempt was made to lock a system resource that would have resulted in a deadlock situation.

Action: No action required.

05 NFS protocol error 273E EIO (NFSERR_FILE_OPEN) Open file blocks operation

Probable cause: The operation cannot be successfully processed because a file involved in the operation is currently open.

Action: Ensure that the appropriate file is not opened. Then retry the operation.

05 NFS protocol error 273F EIO (NFSERR_ADMIN_REVOKED) Lockowner state revoked

Probable cause: Due to administrator intervention, the lock owner’s record locks, share reservations, and delegations have been revoked by the server.

Action: No action required. Consult with the server’s administrator.

05 NFS protocol error 2740 EIO (NFSERR_CB_PATH_DOWN) Callback path down

Probable cause:

Action: –

0C System abend without SDWA 0sss sss - System abend code
0D User abend without SDWA 0uuu uuu - User abend code
0E System abend 0sss sss - System abend code
0F NFS abend 0uuu uuu - User abend code

You can use Table 2 for initial translation of the reason code reasoncd information presented in client messages related to parsing errors.

Table 2. Parsing error (when reason code is 6E01xxxx)
Last 4 hex digits of reason code Description
7xxx Unknown keyword
11yy Host name
12yy Path name
13yy Keyword acdirmax
14yy Keyword acdirmin
15yy Keyword acregmax
16yy Keyword acregmin
17yy Keyword cln_ccsid
18yy Keyword srv_ccsid
19yy Keyword hard
1Ayy Keyword soft
1Byy Keyword retrans
1Cyy Keyword timeo
1Dyy Keyword wsize
1Eyy Keyword rsize
1Fyy Keyword retry
21yy Keyword biod
22yy Keyword bufhigh
23yy Keyword delaywrite
24yy Keyword readahead
25yy Keyword attrcaching
26yy Keyword datacaching
27yy Keyword dynamicsizeadj
28yy Keyword delim
29yy Keyword xlat
2Ayy Keyword vers
2Byy Keyword proto
2Cyy Keyword disablella
2Dyy Keyword tcpsok
2Eyy Keyword tag
2Fyy Keyword convserv
30yy Keyword secure
31yy Keyword rpcbind
32yy Keyword accesschk
33yy Keyword public
34yy Keyword stringprep
Notes:
xxx
The beginning hexadecimal position of the mount parameter of the bad keyword or syntax error (for example, an extra parenthesis). Position starts at 1 from the beginning of the hostname.
yy
See Table 3 for more details.

You can use Table 3 for any additional translation of the reason code information presented in client messages related to parsing errors.

Table 3. Parsing error (when reason code is from 6E0111yy to 6E0133yy
Last 2 hex digits of reason code Description
01 Null host name or null path name
02 Blank detected
03 Incorrect member name in the path name
04 Missing double quotation mark
05 No member name found
06 Missing left parenthesis
07 Incorrect number
08 Number is larger than 2 GB
09 Incorrect multiplier; must be K, M, or G
0A Missing right parenthesis
0B The specified number is not within the allowable range
0C Incorrect keyword parameter value
0D Mutually exclusive keyword/option
0E Keyword is not allowed in the mount option
0F Keyword is not allowed in the installation parameter

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014