Chapter 11: Convert3 and File Conversion Program Error Messages

This chapter describes the error messages returned by Convert3 when generating the conversion program and the errors returned by the conversion program itself.

11.1 Convert3 Error Messages

Convert3 returns a result code to the calling program once it has finished a run. This code is in the form of a 3-byte number in ASCII format. If the first byte of this number is a 0, it denotes that Convert3 has terminated its run successfully and has reported no errors. Any other number appearing as the first byte in the result code indicates that Convert3 has detected an error.

If an error is reported, the first byte of the result code indicates the type of that error as shown in the table below.

1st Byte In Result Code	Result Value in Remaining Bytes	Error Type
1	`nn`	Print file error
2	`nn`	Created file error
3	`nn`	Source file error
4	`yy`	File entries (SELECT...ASSIGN) error
5		Record description (FD) error
6		Parameter description error
7	`nn`	Dynamic stream error

Table 11-1. Error Message Identification

nn = relevant RTS error numbe; see your Error Messages for details.

yy = one of the following:

01	Multiple assign clauses found in file control entry
02	Multiple reserve clauses found in file control entry
03	Multiple organization clauses found in file control entry
04	Multiple access clauses found in file control entry
05	Multiple record clauses found in file control entry
07	Multiple file status clauses found in file control entry
08	Key word expected in file control entry but word found was "xxx" (where xxx is the actual word found)
10	External file name missing in assign statement
11	Data name defined in assign clause is a reserved word
12	Quote expected at end of external file-name
20	Nonnumeric entry in reserve clause
30	Organization type not found in organization clause
32	Inconsistent file control entry
40	Access mode not specified in access clause
41	Relative key is a reserved word in record clause
50	Record name is a reserved word in record clause
60	The word record expected in alternate key clause number
61	Data-name-3 is a reserved word in alternate record number
62	The word duplicated expected in alternate record number
71	Data-name-4 is a reserved word in file status clause
90	Continuation found in file control section

If you receive an error code which starts with the number 5 or 6, then it is not followed by a number to identify a specific error. Instead, these errors are of a general nature and merely indicate that an error has occurred in the record description, or the parameter description. If you receive one of these errors you can detect its specific cause by looking through the parameter list in the list file. If you did not specify a list file, this parameter list is sent to the screen.

11.2 File Conversion Program Error Messages

When you try to run the file conversion program, you could receive one of the following un-numbered error messages, all of which are self-explanatory:

i/p filename invalid

o/p filename invalid

The i/p and o/p data files have the same name

Error on opening i/p file

Error on opening o/p file

Error on reading i/p file

Error on writing o/p file

"record type" record-type "at record-number" is invalid

Attempt to read beyond end of i/p file

where:

`i/p file name`	= input file name
`o/p file name`	= output file name

If you should receive any of the above errors, the file conversion program terminates immediately.

Using the File Conversion Program

Introduction to Conversion Series 5