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 a compare value is specified without a start position, the compare value is compared to the message data beginning in position 1 of the substitution data in the message.
Sequence number 22 tests for a printer device name of QSYSPRT. For an example of testing one substitution variable with a different start position, see sequence number 27.
When a compare value and a start position are specified, the compare value
is compared with the message data beginning with the start position. In
this case, position 21 is the beginning of the third substitution
variable. For message CPA5316, the first four substitution variables
are as follows:
&1 | ODP file name | *CHAR | 10 |
&2 | ODP library name | *CHAR | 10 |
&3 | ODP device name | *CHAR | 10 |
&4 | Line number for first line | *BIN | 2 |
Therefore, sequence number 27 tests for an ODP device name of QSYSPRT before sending a reply.
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.
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.