CL Programming


Using the System Reply List

The system reply list allows you to specify that the system issue the reply to specified predefined inquiry messages so the display station user does not need to reply. Only inquiry messages can be automatically responded to.

The system reply list contains message identifiers, optional compare data, a reply value for each message, and a dump attribute. The system reply list applies only to predefined inquiry messages that are sent by a job that uses the system reply list. You specify that a job is to use the system reply list for inquiry messages on the INQMSGRPY(*SYSRPYL) parameter on the following commands:

When a predefined inquiry message is sent by a job that uses the system reply list, the system searches the reply list in ascending sequence number order for an entry that matches the message identifier and, optionally, the compare data of the reply message. If an entry is found, the reply specified is issued and the user is not required to enter a reply. If an entry is not found, the message is sent to the display station user for interactive jobs or system operator for batch jobs.

The system reply list is shipped with the system with the following initial entries defined:

Sequence Number Message Identifier Compare Value Reply Dump
10 CPA0700 *NONE D *YES
20 RPG0000 *NONE D *YES
30 CBE0000 *NONE D *YES
40 PLI0000 *NONE D *YES

These entries indicate that a reply of D is to be sent and a job dump is to be taken if the message CPA0700-CPA0799, RPG0000-RPG9999, CBE0000-CBE9999, or PLI0000-PLI9999 (which indicate a program failure) is sent by a job using the system reply list. For the system to use these entries, you must specify that the jobs are to use the system reply list.

To add other inquiry messages to the system reply list, use the Add Reply List Entry (ADDRPYLE) command. On this command you can specify the sequence number, the message identifier, optional compare data, compare data CCSID, reply action, and the dump attribute. The ADDRPYLE command function can be easily accessed by using the Work with System Reply List Entries (WRKRPYLE) command.

The following reply actions can be specified for the inquiry messages that are placed on the system reply list (the parameter value is given in parentheses):

The following commands add entries to the system reply list for messages RPG1241, RPG1200, CPA4002, CPA5316, and any other inquiry messages:

The system reply list now appears as follows:

Sequence Number Message Identifier Compare Value (b is a blank) Compare Start Position Reply Dump
10 CPA0700
1 D *YES
15 RPG1241
1 C *NO
18 RPG1200
1 *DFT *YES
20 RPG0000
1 D *YES
22 CPA4002 'QSYSPRT' 1 *RQD *NO
25 CPA4002
1 G *NO
27 CPA5316 'QSYSPRT' 21 I *NO
30 CBE0000
1 D *YES
40 PLI0000
1 D *YES
9999 *ANY
1 *DFT *NO

For a job that uses this system reply list, the following occurs when the messages that were added to the reply list are sent by the job:

When the compare value contains *CCHAR data, the message data that is from the sending function is converted to the CCSID of the message data that is stored in the system reply list before the compare is made. The system converts only data that is of type *CCHAR. IBM provides online information about the Add Message Description (ADDMSGD) command *CCHAR data. Refer to the CL section of the Programming category in the iSeries Information Center.

Caution:
The following restrictions apply when using *CCHAR data as compare data:

If you mix *CCHAR data or include the length of the *CCHAR data, unpredictable results may occur.

An entry remains on the system reply list until you use the Remove Reply List Entry (RMVRPYLE) command to remove it. You can use the Change Reply List Entry (CHGRPYLE) command to change the attributes of a reply list entry, and you can use the Work with System Reply List Entry (WRKRPYLE) command to display the reply entries currently in the reply list.

The job log receives a completion message indicating a successful change when the system reply list is updated using (ADDRPYLE), (CHGRPYLE), or (RMVRPYLE). The history log QHST also receives a completion message to record the change.


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