Replying to Run-Time Inquiry Messages

When you run a program with ILE RPG procedures, run-time inquiry messages may be generated. They occur when the default error handler is invoked for a function check in a cycle-main procedure. See Exception Handling within a Cycle-Main Procedure. The inquiry messages require a response before the program continues running.

Note:
Inquiry messages are never issued for subprocedures (including those designated as linear-main procedures), since the default error handling for a function check in a subprocedure causes the subprocedure to be cancelled, causing the exception to percolate to the caller of the subprocedure. See Exception Handling within Subprocedures.

If the caller of the subprocedure is an RPG procedure, the call will fail with status 00202, independent of the status code associated with the actual exception. If the failed call causes an RPG cycle-main procedure to invoke its default handler, inquiry message RNQ0202 will be issued.

You can add the inquiry messages to a system reply list to provide automatic replies to the messages. The replies for these messages may be specified individually or generally. This method of replying to inquiry messages is especially suitable for batch programs, which would otherwise require an operator to issue replies.

You can add the following ILE RPG inquiry messages to the system reply list:

Table 35. ILE RPG Inquiry Messages
RNQ0100 RNQ0101 RNQ0102 RNQ0103 RNQ0104 RNQ0112 RNQ0113 RNQ0114 RNQ0115 RNQ0120 RNQ0121 RNQ0122 RNQ0123 RNQ0202 RNQ0211 RNQ0221 RNQ0222 RNQ0231 RNQ0232 RNQ0299 RNQ0301 RNQ0302 RNQ0303 RNQ0304 RNQ0305 RNQ0306 RNQ0333 RNQ0401 RNQ0402 RNQ0411 RNQ0412 RNQ0413 RNQ0414 RNQ0415 RNQ0421 RNQ0425 RNQ0426 RNQ0431 RNQ0432 RNQ0450 RNQ0501 RNQ0502 RNQ0802 RNQ0803 RNQ0804 RNQ0805 RNQ0907 RNQ1011 RNQ1021 RNQ1022 RNQ1023 RNQ1024 RNQ1031 RNQ1041 RNQ1042 RNQ1051 RNQ1071 RNQ1201 RNQ1211 RNQ1215 RNQ1216 RNQ1217 RNQ1218 RNQ1221 RNQ1222 RNQ1231 RNQ1235 RNQ1241 RNQ1251 RNQ1255 RNQ1261 RNQ1271 RNQ1281 RNQ1282 RNQ1284 RNQ1285 RNQ1286 RNQ1287 RNQ1299 RNQ1331 RNQ9998 RNQ9999
Note:
ILE RPG inquiry messages have a message id prefix of RNQ.

To add inquiry messages to a system reply list using the Add Reply List Entry command enter:

ADDRPYLE sequence-no message-id

where sequence-no is a number from 1-9999, which reflects where in the list the entry is being added, and message-id is the message number you want to add. Repeat this command for each message you want to add.

Use the Change Job (CHGJOB) command (or other CL job command) to indicate that your job uses the reply list for inquiry messages. To do this, you should specify *SYSRPYL for the Inquiry Message Reply (INQMSGRPY) attribute.

The reply list is only used when an inquiry message is sent by a job that has the Inquiry Message Reply (INQMSGRPY) attribute specified as INQMSGRPY(*SYSRPYL). The INQMSGRPY parameter occurs on the following CL commands:

You can also use the Work with Reply List Entry (WRKRPYLE) command to change or remove entries in the system reply list. For details of the ADDRPYLE and WRKRPYLE commands, see the CL and APIs section of the Programming category in the i5/OS Information Center at this Web site - http://www.ibm.com/systems/i/infocenter/.



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