HP 3000 Manuals

FCHECK [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

FCHECK 

NM and CM callable.

Returns specific details about error conditions that occurred when a file
system intrinsic returns a condition code indicating an I/O error.
FCHECK applies to files on any device.

Syntax 
_____________________________________________________________
|                                                           |
|             I16V    I16     I16     I32     I16           |
|     FCHECK(filenum,fserrorcode,translog,blocknum,numrecs);|
_____________________________________________________________

            

Parameters 

filenum               16-bit signed integer by value (optional) 

                      Passes the file number of the file for which error
                      information is to be returned.  If filenum is set
                      to zero or if it is not specified, error
                      information is returned about the last failed FOPEN
                      call.

fserrorcode           16-bit signed integer by reference (optional) 

                      Returns a file system error code indicating the
                      type of error that occurred.  Refer to Table 4-2
                      .

translog              16-bit signed integer by reference (optional) 

                      Returns the number of half words read or written if
                      an I/O error occurred.  (This value is recorded in
                      the transmission log.)

blocknum              32-bit signed integer by reference (optional) 

                      Returns the physical record count for a
                      nonspoolfile or the logical record count for a
                      spoolfile:

                         *   For fixed-length and undefined-length record
                             files, the physical count is the number of
                             physical records transferred to or from the
                             file since FOPEN.

                         *   For variable-length record files, the
                             physical count is the last rewind,
                             rewind/unload, space forward or backward to
                             tape mark.

numrecs               16-bit signed integer by reference (optional) 

                      Returns the number of logical records in the bad
                      block (blocking factor).

                      (ASC only) This parameter is not meaningful for
                      asynchronous devices.

          Table 4-2.  File System Error Codes 
--------------------------------------------------------------------------------------------
|              |                                                                           |
|  Error Code  |                                Description                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      0       | Successful or end-of-file (EOF)                                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      1       | Illegal DB register setting                                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      2       | Illegal capability                                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      3       | Required parameter missing                                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      4       | Disk space allocation disabled on all domain disks                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      5       | DRT number >511                                                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      6       | Device has no spare blocks available                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      7       | Unformatted or uninitialized media on device                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      8       | Illegal parameter value                                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      9       | Invalid file type specified in foption                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      10      | Invalid record size specification                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      11      | Invalid resultant block size                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      12      | Record number out of range                                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      13      | Cannot open file multiaccess                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      16      | More than 255 opens of a file                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      15      | Exceeded maximum file opens for write access                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      17      | Magnetic tape runaway                                                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      18      | Device powered up                                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      19      | Forms control was reset                                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      20      | Invalid operation requested (for example, terminal type set to -24 which  |
|              | is an invalid entry)                                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      21      | Data parity error                                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      22      | Timeout (read timeout value set with FCONTROL itemnum=4)                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      23      | End-of-tape                                                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      24      | Device not ready; not online, modem dsr signal not "high", or line        |
|              | disconnected)                                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      25      | No write ring on tape                                                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      26      | Transmission error                                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      27      | I/O timeout; block mode read timer expired (timer set by system, not user |
|              | changeable)                                                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      28      | Timing error; data arrived at controller faster than it could be serviced |
|              | (data overrun)                                                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------

          Table 4-2.  File System Error Codes (cont.) 

--------------------------------------------------------------------------------------------
|              |                                                                           |
|  Error Code  |                                Description                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      29      | Start I/O (SIO) failure                                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      30      | Unit failure                                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      31      | End-of-line (EOL) special character terminator or additional              |
|              | end-of-record (AEOR) character (defined by FCONTROL itemnum=25)           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      32      | Software abort of I/O operation (for example, an ABORTIO command was      |
|              | entered)                                                                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      33      | Data lost or no buffer available                                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      34      | Unit not online                                                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      35      | Data set not ready                                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      36      | Invalid disk address                                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      37      | Invalid memory address                                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      38      | Tape parity error                                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      39      | Recovered tape error                                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      40      | Operation inconsistent with access type                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      41      | Operation inconsistent with record type                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      42      | Operation inconsistent with device type (for example, attempted to set an |
|              | invalid line speed through FCONTROL itemnum=11)                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      43      | Write exceeds record size                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      44      | Update at record zero                                                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      45      | Privileged file violation                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      46      | Out of disk space                                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      47      | I/O error on a file label                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      48      | Invalid operation; multiple file access                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      49      | Unimplemented function                                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      50      | Nonexistent account                                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      51      | Nonexistent group                                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      52      | Nonexistent permanent file                                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      53      | Nonexistent temporary file                                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      54      | Invalid file reference                                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------

          Table 4-2.  File System Error Codes (cont.) 

--------------------------------------------------------------------------------------------
|              |                                                                           |
|  Error Code  |                                Description                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      55      | Device unavailable                                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      56      | Invalid device specification                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      57      | Out of virtual memory                                                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      58      | No file passed                                                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      59      | Standard label violation                                                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      60      | Global RIN not available or insufficient system resources                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      61      | Out of group disk space                                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      62      | Out of account disk space                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      63      | No nonshareable device capability                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      64      | Program not prepared with multiple RIN capability                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      66      | Plotter limit switch reached                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      68      | Insufficient system resources                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      69      | I/O error                                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      70      | I/O error while printing header/trailer, or an FOPEN or FCLOSE failed     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      71      | Too many files open                                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      72      | Invalid file number                                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      73      | Bounds violation                                                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      74      | No room in stack for file entry                                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      77      | Nowait I/O operation pending                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      78      | No nowait I/O pending for any file                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      79      | No nowait I/O pending for any special file                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      80      | Spoolfile size exceeds configuration                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      81      | No spool class defined in system                                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      82      | Insufficient space in spool class for I/O request                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      83      | I/O error on spoolfile                                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      84      | Device unavailable for spoolfile                                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      85      | Operation inconsistent with spooling (for example, attempt to read        |
|              | hardware status)                                                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      86      | Spooling internal error                                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      87      | Bad spoolfile block                                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------

          Table 4-2.  File System Error Codes (cont.) 

--------------------------------------------------------------------------------------------
|              |                                                                           |
|  Error Code  |                                Description                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      88      | Nonexistent spoolfile                                                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      89      | Power failure                                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      90      | Exclusive violation; file being accessed                                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      91      | Exclusive violation; file accessed exclusively                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      92      | Lockword violation                                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      93      | Security violation                                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      94      | User not creator                                                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      95      | Read not completed; the terminal user pressed BREAK (The user must enter  |
|              | the RESUME command to continue.  The file system sees the restart, the    |
|              | application does not.)                                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      96      | Disk I/O error                                                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      97      | No control-Y PIN                                                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      98      | Read timer overflow; read exceeded maximum capacity of read timer (655.35 |
|              | seconds)                                                                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|      99      | BOT and backspace tape                                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     100      | Duplicate permanent file name                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     101      | Duplicate temporary file name                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     102      | I/O error on directory                                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     103      | Permanent directory overflow                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     104      | Temporary directory overflow                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     105      | Bad variable block structure                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     106      | Extent size exceeds maximum                                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     107      | Insufficient space for user labels                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     108      | Invalid file label                                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     109      | Invalid carriage control                                                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     110      | Attempt to save permanent file as temporary                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     111      | No save files (SF) capability                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     112      | No mountable volumes (UV) capability                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     113      | Volume set not mounted; mount problem                                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     114      | Volume set not dismounted; dismount problem                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     115      | Attempted rename across volume sets rejected                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------

          Table 4-2.  File System Error Codes (cont.) 

--------------------------------------------------------------------------------------------
|              |                                                                           |
|  Error Code  |                                Description                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     116      | Invalid tape label FOPEN/HPFOPEN parameters                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     117      | Attempted write on an unexpired tape file                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     118      | Invalid header or trailer tape label                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     119      | I/O error positioning tape for tape labels                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     120      | Attempted write on an IBM standard tape label                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     121      | Tape label lockword violation                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     122      | Tape label table overflow                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     123      | End of tape volume set                                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     124      | Attempt to append labeled tape                                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     125      | Expiration date later than preceding file                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     126      | Character set number must be between 0 and 31                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     127      | Form number must be between 0 and 31                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     128      | Logical page number must be between 0 and 31                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     129      | Vertical format number must be between 0 and 31                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     130      | Number of copies must be between 1 and 32,767                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     131      | Number of overlays must be between 1 and 8                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     132      | Page length parameter must be between 12 (=3) and 68 (=17)                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     133      | Picture number must be between 0 and 31                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     134      | Extended capability parameter must be 0 (OFF) or 1 (ON)                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     137      | Defective track on foreign disk                                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     138      | Track does not exist on foreign disk                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     139      | Deleted record on IBM diskette                                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     148      | Inactive RIO record                                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     149      | Missing item number or return variable                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     150      | Invalid itemnum                                                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     151      | Undefined file type                                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     152      | Unrecognized option in FOPEN/HPFOPEN device parameter                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     153      | Expecting semicolon (;) or carriage return in FOPEN/HPFOPEN device        |
|              | parameter                                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     154      | Environment file open error                                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     155      | File not environment file; check file code or record size                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------

          Table 4-2.  File System Error Codes (cont.) 

--------------------------------------------------------------------------------------------
|              |                                                                           |
|  Error Code  |                                Description                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     156      | Header record incorrect                                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     157      | Uncompiled environment file                                               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     158      | Error reading environment file                                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     159      | Error closing environment file                                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     160      | Error doing FDEVICECONTROL from environment file                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     161      | Too many parameters in device string overflow                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     162      | Expecting "=" after option in device parameter                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     163      | Incorrect ENV backreference in file equation                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     164      | Device parameter too large or missing carriage return                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     165      | Invalid density specification                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     166      | FFILEINFO failed while accessing remote spoolfile                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     167      | Spoolfile label error; cannot insert environment file name                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     168      | Item not supported on remote system                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     170      | Record marked deleted; pointer positioned to a record marked for deletion |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     171      | (KSAM) Duplicate key value not allowed                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     172      | (KSAM) Key not found; invalid key value                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     173      | (KSAM) tcount parameter larger than record size                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     174      | (KSAM) Cannot get extra data segment                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     175      | (KSAM) Internal KSAM error                                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     176      | (KSAM) Illegal extra data segment                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     177      | (KSAM) Too many extra data segments for this process                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     178      | (KSAM) Not enough virtual memory for extra data segment                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     179      | (KSAM) File must be locked before issuing this intrinsic                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     180      | (KSAM) KSAM file must be rebuilt; KSAM version does not handle a file     |
|              | built by previous version                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     181      | (KSAM) Invalid key starting position                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     182      | (KSAM) File empty                                                         |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     183      | (KSAM) Record does not contain all keys                                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     184      | (KSAM) Invalid record number                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------

          Table 4-2.  File System Error Codes (cont.) 

--------------------------------------------------------------------------------------------
|              |                                                                           |
|  Error Code  |                                Description                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     185      | (KSAM) Sequence error in primary key                                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     186      | (KSAM) Invalid key length                                                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     187      | (KSAM) Invalid key specification                                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     188      | (KSAM) Invalid device specification                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     189      | (KSAM) Invalid record format                                              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     190      | (KSAM) Invalid key blocking factor value                                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     191      | (KSAM) Record does not contain search key for deletion; specified key     |
|              | value points to record not containing that value                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     192      | (KSAM) System failure occurred while KSAM file was opened                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     193      | (KSAM) $STDIN/$STDLIST cannot be redirected to KSAM files                 |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     194      | (KSAM) KSAM files not allowed for global AFTs                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     196      | (KSAM) Language not supported                                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     197      | (KSAM) native language internal error                                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     198      | (KSAM) Invalid version number in KSAM file                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     201      | (DS) Unable to access DSLINE table                                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     204      | (DS) Unable to allocate an extra data segment for DS/DSN 3000             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     205      | (DS) Unable to expand the DS/DSN 3000 extra data segment                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     214      | (DS) Requested DS line has not been opened with a DSLINE command          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     216      | (DS) Message rejected by remote computer                                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     217      | (DS) Insufficient amount of user stack available                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     221      | (DS) Internal DS error; invalid message format                            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     224      | File equations for a remote file constitute a loop                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     227      | RFA/RDBA could not find or create a remote session                        |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     239      | Communication interface error; trace malfunction                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     240      | (DS) Local communication line not opened by operator                      |
|              |                                                                           |
--------------------------------------------------------------------------------------------

          Table 4-2.  File System Error Codes (cont.) 

--------------------------------------------------------------------------------------------
|              |                                                                           |
|  Error Code  |                                Description                                |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     241      | (DS) DS line in use exclusively or by another subsystem                   |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     242      | (DS) Internal DS software malfunction                                     |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     243      | (DS) Remote computer not responding                                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     246      | Communications interface error; remote computer disconnected              |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     249      | Communications interface error; unable to enter remote session            |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     255      | Communications interface error; connection lost                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     302      | Invalid item number for FDEVICECONTROL                                    |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     303      | Invalid access for item number to FDEVICECONTROL                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     304      | Attempt to change terminal parity in 8-bit mode                           |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     305      | Invalid format in terminal configuration file                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     306      | Checksum error in terminal configuration file                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     307      | Passed value to FDEVICECONTROL less than minimum                          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     308      | Passed value to FDEVICECONTROL greater than maximum                       |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     309      | Passed value to FDEVICECONTROL is unsupported                             |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     310      | Count to FDEVICECONTROL insufficient for return information               |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     311      | Count to FDEVICECONTROL greater than available store information          |
|              |                                                                           |
--------------------------------------------------------------------------------------------
|              |                                                                           |
|     312      | Passed special character has previously defined function                  |
|              |                                                                           |
--------------------------------------------------------------------------------------------

Operation Notes 

FCHECK is used to determine the error conditions of the last failed FOPEN
intrinsic call (even if a file number was not returned) by setting the
filenum parameter to zero.  In this case, only fserrorcode returns valid
information.

Do not use FCHECK to determine error conditions of a last failed HPFOPEN
call; error conditions are returned in the HPFOPEN status parameter.

Condition Codes 

CCE (2)               Request granted.

CCG (0)               Not returned.

CCL (1)               Request denied.  The file number passed by filenum 
                      is invalid, or a bounds violation occurred while
                      processing this request (fserrorcode=73).

Related Information 

Intrinsics            None

Commands              None

Manuals               Accessing Files Programmer's Guide (32650-90017),
                      Using KSAM XL (32650-90168), and MPE XL 
                      Asynchronous Serial Communications Programmer's 
                      Reference Manual  (32022-90012)



MPE/iX 5.0 Documentation