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.
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.