HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

FCHECK

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 “File System Error Codes”.

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 CodeDescription
0Successful or end-of-file (EOF)
1Illegal DB register setting
2Illegal capability
3Required parameter missing
4Disk space allocation disabled on all domain disks
5DRT number >511
6Device has no spare blocks available
7Unformatted or uninitialized media on device
8Illegal parameter value
9Invalid file type specified in foption
10Invalid record size specification
11Invalid resultant block size
12Record number out of range
13Cannot open file multiaccess
16More than 255 opens of a file
15Exceeded maximum file opens for write access
17Magnetic tape runaway
18Device powered up
19Forms control was reset
20Invalid operation requested (for example, terminal type set to -24 which is an invalid entry)
21Data parity error
22Timeout (read timeout value set with FCONTROLitemnum=4)
23End-of-tape
24Device not ready; not online, modem dsr signal not "high", or line disconnected)
25No write ring on tape
26Transmission error
27I/O timeout; block mode read timer expired (timer set by system, not user changeable)
28Timing error; data arrived at controller faster than it could be serviced (data overrun)
29Start I/O (SIO) failure
30Unit failure
31End-of-line (EOL) special character terminator or additional end-of-record (AEOR) character (defined by FCONTROLitemnum=25)
32Software abort of I/O operation (for example, an ABORTIO command was entered)
33Data lost or no buffer available
34Unit not online
35Data set not ready
36Invalid disk address
37Invalid memory address
38Tape parity error
39Recovered tape error
40Operation inconsistent with access type
41Operation inconsistent with record type
42Operation inconsistent with device type (for example, attempted to set an invalid line speed through FCONTROLitemnum=11)
43Write exceeds record size
44Update at record zero
45Privileged file violation
46Out of disk space
47I/O error on a file label
48Invalid operation; multiple file access
49Unimplemented function
50Nonexistent account
51Nonexistent group
52Nonexistent permanent file
53Nonexistent temporary file
54Invalid file reference
55Device unavailable
56Invalid device specification
57Out of virtual memory
58No file passed
59Standard label violation
60Global RIN not available or insufficient system resources
61Out of group disk space
62Out of account disk space
63No nonshareable device capability
64Program not prepared with multiple RIN capability
66Plotter limit switch reached
68Insufficient system resources
69I/O error
70I/O error while printing header/trailer, or an FOPEN or FCLOSE failed
71Too many files open
72Invalid file number
73Bounds violation
74No room in stack for file entry
77Nowait I/O operation pending
78No nowait I/O pending for any file
79No nowait I/O pending for any special file
80Spoolfile size exceeds configuration
81No spool class defined in system
82Insufficient space in spool class for I/O request
83I/O error on spoolfile
84Device unavailable for spoolfile
85Operation inconsistent with spooling (for example, attempt to read hardware status)
86Spooling internal error
87Bad spoolfile block
88Nonexistent spoolfile
89Power failure
90Exclusive violation; file being accessed
91Exclusive violation; file accessed exclusively
92Lockword violation
93Security violation
94User not creator
95Read 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.)
96Disk I/O error
97No control-Y PIN
98Read timer overflow; read exceeded maximum capacity of read timer (655.35 seconds)
99BOT and backspace tape
100Duplicate permanent file name
101Duplicate temporary file name
102I/O error on directory
103Permanent directory overflow
104Temporary directory overflow
105Bad variable block structure
106Extent size exceeds maximum
107Insufficient space for user labels
108Invalid file label
109Invalid carriage control
110Attempt to save permanent file as temporary
111No save files (SF) capability
112No mountable volumes (UV) capability
113Volume set not mounted; mount problem
114Volume set not dismounted; dismount problem
115Attempted rename across volume sets rejected
116Invalid tape label FOPEN/HPFOPEN parameters
117Attempted write on an unexpired tape file
118Invalid header or trailer tape label
119I/O error positioning tape for tape labels
120Attempted write on an IBM standard tape label
121Tape label lockword violation
122Tape label table overflow
123End of tape volume set
124Attempt to append labeled tape
125Expiration date later than preceding file
126Character set number must be between 0 and 31
127Form number must be between 0 and 31
128Logical page number must be between 0 and 31
129Vertical format number must be between 0 and 31
130Number of copies must be between 1 and 32,767
131Number of overlays must be between 1 and 8
132Page length parameter must be between 12 (=3) and 68 (=17)
133Picture number must be between 0 and 31
134Extended capability parameter must be 0 (OFF) or 1 (ON)
137Defective track on foreign disk
138Track does not exist on foreign disk
139Deleted record on IBM diskette
148Inactive RIO record
149Missing item number or return variable
150Invalid itemnum
151Undefined file type
152Unrecognized option in FOPEN/HPFOPENdevice parameter
153Expecting semicolon (;) or carriage return in FOPEN/HPFOPENdevice parameter
154Environment file open error
155File not environment file; check file code or record size
156Header record incorrect
157Uncompiled environment file
158Error reading environment file
159Error closing environment file
160Error doing FDEVICECONTROL from environment file
161Too many parameters in device string overflow
162Expecting "=" after option in device parameter
163Incorrect ENV backreference in file equation
164Device parameter too large or missing carriage return
165Invalid density specification
166FFILEINFO failed while accessing remote spoolfile
167Spoolfile label error; cannot insert environment file name
168Item not supported on remote system
170Record 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
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
224File equations for a remote file constitute a loop
227RFA/RDBA could not find or create a remote session
239Communication interface error; trace malfunction
240(DS) Local communication line not opened by operator
241(DS) DS line in use exclusively or by another subsystem
242(DS) Internal DS software malfunction
243(DS) Remote computer not responding
246Communications interface error; remote computer disconnected
249Communications interface error; unable to enter remote session
255Communications interface error; connection lost
302Invalid item number for FDEVICECONTROL
303Invalid access for item number to FDEVICECONTROL
304Attempt to change terminal parity in 8-bit mode
305Invalid format in terminal configuration file
306Checksum error in terminal configuration file
307Passed value to FDEVICECONTROL less than minimum
308Passed value to FDEVICECONTROL greater than maximum
309Passed value to FDEVICECONTROL is unsupported
310Count to FDEVICECONTROL insufficient for return information
311Count to FDEVICECONTROL greater than available store information
312Passed 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)

Feedback to webmaster