RMVRPYLE (Remove Reply List Entry)

RMVRPYLE Command syntax diagram

 

Purpose

The Remove Reply List Entry (RMVRPYLE) command removes an entry from the system reply list. The reply list is used as a source for automatic responses to predefined inquiry messages.

The reply list is only used when an inquiry message is sent by a job that has the inquiry message reply attribute of the system reply list specified (INQMSGRPY(*SYSRPLY) is specified). INQMSGRPY(*SYSRPLY) can be changed with the CHGJOB command.

New entries may be added to the reply list with the Add Reply List Entry (ADDRPYLE) command; entries can be changed with the Change Reply List Entry (CHGRPYLE) command. The entire list of entries can be shown with the Work with System Reply List Entries (WRKRPYLE) display. From the display that is presented the user can add, change, and remove individual entries.

Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR user profile has private authority to use the command.

 

Required Parameters

SEQNBR
Specifies the sequence number of the reply list entry being removed from the system reply list.

*ALL: Specifies that all reply list entries are removed from the system reply list. Whenever *ALL has been specified, and the reply list object had previously been marked as damaged, the reply list is deleted and recreated. No reply list entries will be present after re-creation. They must be reentered or a reinstall operation must be done.

Note: Specifying the sequence number 0 has the same behavior as specifying the special value *ALL.

sequence-number: Specify the sequence number of the file. Valid values range from 1 through 9999.

Examples for RMVRPYLE

Example 1: Removing All Entries

RMVRPYLE   SEQNBR(*ALL)

This command removes all entries from the system reply list.

Example 2: Removing One Entry

RMVRPYLE   SEQNBR(0001)

This command removes from the system reply list the entry that has sequence number 0001.

Error messages for RMVRPYLE

*ESCAPE Messages

CPF2435
System reply list not found.
CPF2556
Sequence number &1 not defined in system reply list.
CPF2557
System reply list damaged.
CPF2558
System reply list currently in use.