ILE COBOL Programmer's Guide


Interactive Messages

In an interactive environment, messages are displayed on the workstation display. They can appear on the current display as a result of the running of the program or in response to your keyed input to prompts, menus, command entry displays, or WebSphere Development Studio tools. The messages can also appear on request, as a result of a display command or an option on a menu.

The messages for the ILE COBOL licensed program begin with an LNC or LNR prefix.

The LNC messages are issued by the ILE COBOL syntax checker when the Source Entry Utility (SEU) is used to enter your ILE COBOL source code. For example, you see the following display after incorrectly entering the program name in the PROGRAM-ID paragraph.

Figure 153. Example of a ILE COBOL Syntax Checker Message

+--------------------------------------------------------------------------------+
| Columns . . . :    1  71            Edit           XMPLIB/QCBLLESRC            |
| SEU==> _________________________________________________________     TESTPR    |
| FMT CB ......-A+++B+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
|        *************** Beginning of data ************************************* |
| 0000.10        IDENTIFICATION DIVISION.                                        |
| 0000.20        PROGRAM-ID. #TESTPR.                                            |
| 0000.70        ENVIRONMENT DIVISION.                                           |
| 0000.90        SOURCE-COMPUTER. IBM-ISERIES.                                   |
|        ****************** End of data **************************************** |
| F3=Exit   F4=Prompt   F5=Refresh   F9=Retrieve   F10=Cursor                    |
| F16=Repeat find       F17=Repeat change          F24=More keys                 |
|# not in COBOL character set. Line rejected.                                    |
+--------------------------------------------------------------------------------+

The LNC messages are also issued during program compilation. See Compilation Messages for a description.

LNR messages provide you with additional information about system operation during run time. For example, you might see the following display if you have a runtime error:

Figure 154. Run-Time Error Message

+--------------------------------------------------------------------------------+
|                    Display Program Messages                                    |
|Job 008529/TESTLIB/QPADEV0003 started on 94/04/08 at 15:32:58 in subsystem Q    |
|Message 'MCH1202' in program object 'SAMPDUMP' in library 'TESTLIB' (C D F G    |
|                                                                                |
|                                                                                |
|Type reply, press Enter.                                                        |
|  Reply . . .   ________________________________________________________________|
|______________________________________________________________________________  |
|                                                                                |
|F3=Exit   F12=Cancel                                                            |
|                                                                                |
+--------------------------------------------------------------------------------+

If you move the cursor to the line on which message number MCH1202 is indicated and press either the HELP key or F1, the LNR message information is displayed as shown:

Figure 155. Runtime Error Message--Second-Level Text

+--------------------------------------------------------------------------------+
|                          Additional Message Information                        |
| Message ID . . . . . . :   LNR7200       Severity . . . . . . . :   50         |
| Message type . . . . . :   Inquiry                                             |
| Date sent  . . . . . . :   96/11/08      Time sent  . . . . . . :   15:33:31   |
| Message . . . . :   Message 'MCH1202' in program object 'SAMPDUMP' in library  |
|   'TESTLIB' (C D F G).                                                         |
| Cause . . . . . :   Message 'MCH1202' was detected in COBOL statement 42 of    |
|   COBOL program 'SAMPDUMP' in program object 'SAMPDUMP' in library 'TESTLIB'.  |
| Recovery  . . . :   Enter a G to continue the program at the next MI           |
|   instruction, or a C if no dump is wanted, a D if a dump of the COBOL         |
|   identifiers is wanted, or an F to dump both the COBOL identifiers and the    |
|   file information. The message text for 'MCH1202' follows: 'Decimal data      |
|   error.'                                                                      |
| Possible choices for replying to message . . . . . . . . . . . . . . . :       |
|   C -- No formatted dump is given                                              |
|   D -- A dump of the COBOL identifiers is given                                |
|                                                                        More... |
| Press Enter to continue.                                                       |
| F3=Exit   F6=Print   F10=Display messages in job log                           |
| F11=Display message details   F12=Cancel   F21=Select assistance level         |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|                         Additional Message Information                         |
| Message ID . . . . . . :   LNR7200       Severity . . . . . . . :   50         |
| Message type . . . . . :   Inquiry                                             |
|   F -- A dump of the COBOL identifiers and file information                    |
|   G -- To continue the program at the next MI instruction.                     |
|                                                                                |
|                                                                         Bottom |
| Press Enter to continue.                                                       |
|                                                                                |
| F3=Exit   F6=Print   F10=Display messages in job log                           |
| F11=Display message details   F12=Cancel   F21=Select assistance level         |
|                                                                                |
+--------------------------------------------------------------------------------+

Responding to Messages explains how to display second-level message text and how to reply to messages.

LNM messages 0001 to 0050 are used as headings for information printed during a ILE COBOL formatted dump.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]