FCHECK

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.

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.

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

15

Exceeded maximum file opens for write access

16

More than 255 opens of a file

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)

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

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

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

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

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

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

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

313

Incompatible version of the file

350

KSAM lock table full

351

Too many record locks in one process

352

Record was locked already

353

File must be unlocked before issuing this intrinsic

354

Data integrity violation

355

File is locked by another process

356

Lock request rejected due to potential deadlock

357

Data may be invalid because file is locked by others

391

Name cannot be expressed using the specified syntax

392

Rename for the given file type is not supported

393

UID-GID database could not be found

394

User information not found in uid database

395

Group information not found in gid database

396

User lacks read acd (racd) access

397

A component in the pathname is not a directory

398

User lacks traverse directory (td) access

399

File attributes are not expressible as foptions

400

Name syntax specified is invalid

401

Unknown system file specified

402

Invalid character found in mpe syntax name

403

Wild card characters found in file name

404

Backreferenced file is not allowed

405

System files are not allowed

406

Remote environment specification is not allowed

407

Invalid usage of a character class

408

Missing file name component

409

File name did not start with an alphabetic characte

410

Specified file name is too long

411

Lockword in backreferenced file name is not allowed

412

Lockword in wildcarded file name is illegal

413

Lockword is missing

414

Lockword did not start with an alphabetic character

415

Specified lockword is too long

416

Group name is missing

417

Group name did not start with an alphabetic character

418

Specified group name is too long

419

Account name is missing

420

Account name did not start with alphabetic character

421

Specified account name is too long

422

Remote environment specification is invalid

423

NS3000 is not present on the system

424

Remote environment specification is missing

425

Remote environment specification is too long

426

HFS name component is too long

427

HFS pathname is too long

428

HFS pathname exceeded the number of levels supported

429

HFS pathname began with hyphen (-) character

430

HFS pathname began with two slashes (//)

431

Lower case characters are not allowed

432

Wild carded name may match an incorrect syntax

433

Specified name is not identifiable in any syntax

434

Lockword specification is not allowed

435

Illegal attempt to escape into hfs syntax from an mpe-only syntax name

436

Illegal character found in hfs pathname

451

The specified file code is invalid in this context

452

File privilege level is invalid in this context

453

The specified file is write protected

454

The specified record type is invalid

455

The file type specified is invalid

456

File type specified is only supported in MPE namespace

457

Component of path does not exist

458

Trying to read/write to a pipe or FIFO and O_NONBLOCK is set

459

Trying to write to a pipe but it was not opened for read

460

Specified file domain not supported in the given namespace

461

User lacks create directory (CD) access

462

User lacks delete directory (DD) access

463

Write access disabled on device media

464

Too many symbolic links encountered in the pathname

465

Unable to create FLOD data structure

466

Unable to delete FLOD data structure

467

Unable to issue another lock request, limit reached

468

Internal HPFLOCK error

469

File was opened with dynamic locking, use FLOCK

470

Lock held by another process, request denied

471

No FLOD exists, incompatible file type

472

No such lock exists

473

Whence parameter out of bounds

474

Length parameter out of bounds

475

Start parameter out of bounds

476

Internal HPFLOCK error

477

Lock extends beyond the file limit

478

Internal HPFLOCK error, flod marked invalid

479

No GUFD exists, incompatible file type

480

No GDPD exists, incompatible file type

481

Command parameter out of bounds

482

Lock parameter out of bounds

483

PIN parameter out of bounds

484

Interrupt occured while waiting for lock

485

Size parameter out of bounds

486

Invalid file type

487

Lock type and file access incompatible

488

Conflicting read format

489

Tthe file type is not a symbolic link file

490

Tried to reply to waiters and none were found

491

Trying to deallocate a PLFD that is locked by another thread

492

Trying to deallocate a PLFD that isn't locked by your thread

493

An invalid operation for threads

494

A read or write operation was interrupted by a signal

495

Exec call failed because a file could not be closed

496

Open was interrupted by a signal and wasn't completed

Operation Notes

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

Manuals

Accessing Files Programmer's Guide
Using KSAM XL
Asynchronous Serial Communications Programmer's Reference Manual