After the initial call to the preprocessor, subsequent calls return with one of the following:
The value in resp-main is used to signify what is being returned; additional information might be placed in resp-more and/or buffer. The values of resp-main are:
| Value | Description |
|---|---|
| 0 | The source file has been completely processed and there is no further input. buffer and resp-more are ignored. |
| 1 | buffercontains a new line that was added by the preprocessor and which was not in the original source code. resp-more optionally contains the position of the verb in the original source line that is being replaced. The line added by the preprocessor must not be a comment. |
| 2 | buffer contains a line in the original source code which is to be ignored by the Compiler. resp-more is ignored. |
| 3 | buffer contains a line in the original source code which contains the start of a COPY statement that is about to be expanded by the preprocessor. resp-more contains the position of the statement on the line. |
| 4 | buffer contains a line in the original source code which contains the continuation of a COPY statement. resp-more is ignored. |
| 5 | buffer contains a warning message inserted by the preprocessor. This must have the format of a comment line (that is, the value "*" in the indicator area of the source line). resp-more is ignored. |
| 6 | An unrecoverable error has occurred; this forces the Compiler to abort and enter the COBOL Editor. In such a case, a message of up to 70 characters might be written to buffer and this is displayed on the bottom line of the Editor. resp-more is ignored. |
| 7 | An error has occurred; this forces the Compiler to increment its internal error count. All error classes might be specified by using resp-more. The contents of buffer are ignored. |
| 8 | This value is generated by the CP Preprocessor. |
| 9 | This value is used when the CP Preprocessor is in use. |
| 10 | Identical to 11, below. |
| 11 | buffer contains a new line added by the preprocessor which contains the start of a COPY statement that is about to be expanded by the preprocessor. It is used when the COPY statement is not unique on a line or the original text was not a COBOL COPY statement. resp-more contains the position of the COPY statement on the line. |
| 12 | buffer contains a new line added by the preprocessor which contains the continuation of a COPY statement. resp-more is ignored. |
| 13 | Causes the Compiler to return information about its directive settings. The required directive might optionally be placed in buffer; resp-more is ignored. |
| Not base level:14 | This value is similar to 10 and 11 above, except that it indicates that the original source contained -INC or ++INCLUDE. |
| Not base level:17 | An error has been detected. buffer contains a message that the Checker outputs. |
| Not base level:18 |
Buffer contains a data name to be marked as modified by the immediately preceding preprocessed line. The data name may be qualified and resp-more contains the column information for the reference. IDE tooling will now reflect the reference in the same way as data names on lines not modified by the preprocessor. Multiple references may be specified by returning a resp-main value of 18 multiple times. |
| 32 | buffer contains a line from the original source code which has not been modified by the preprocessor. |
| 33 - 64 | These values are generated by the CP preprocessor. |
| 128 | The end of a copybook has been reached. buffer must be empty. |