Delete Problem (DLTPRB)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The user, typically a system operator or user responsible for handling system problems, uses the Delete Problem (DLTPRB) command to maintain the size of the problem log by deleting one or more entries. More information on controlling problem log size is in the Basic System Operation information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.

Top

Parameters

Keyword Description Choices Notes
PRBID Problem identifier Character value, *ALL Optional, Positional 1
STATUS Status type Single values: *ALL
Other values (up to 6 repetitions): *OPENED, *READY, *PREPARED, *SENT, *ANSWERED, *VERIFIED, *CLOSED
Optional
DAYS Days 0-999, 30 Optional
ORIGIN Origin Element list Optional
Element 1: Network identifier Communications name, *NETATR, *ALL
Element 2: Control point name Communications name, *NETATR, *ALL
Top

Problem identifier (PRBID)

Specifies the ID of the problems to be deleted. Problems with different origin systems may have the same ID. The Origin (ORIGIN) parameter may be used along with this parameter to select a single problem from a particular origin system.

*ALL
All problems that match the other selection criteria are deleted.
problem-ID
Specify the 10-character problem ID of the problem to be deleted. The Status type (STATUS) parameter and the Days (DAYS) parameter are ignored if a problem ID is specified.
Top

Status type (STATUS)

Specifies the status of problem log entries. There are seven types of status:

*OPENED
The problem is in Opened status. The problem has been identified and a problem record was created.
*READY
The problem is in Ready status. Problem analysis information has been added to the problem record.
*PREPARED
The problem is in Prepared status. The problem has been prepared for reporting.
*SENT
The problem is in Sent status. The problem has been sent to a service provider, but no answer has been returned.
*ANSWERED
The problem is in Answered status. An answer has been returned by the service provider or added by an operator on this system.
*VERIFIED
The problem is in Verified status. The problem was resolved and the system operator has verified that the problem is corrected.
*CLOSED
The problem was closed.

Note: This parameter is valid only if *ALL is specified on the Problem identifier (PRBID) parameter.

You can enter multiple values for this parameter. If you are on an entry display and you need additional entry fields to enter these multiple values, type a plus sign (+) in the entry field opposite the phrase "+ for more" and press the Enter key.

*ALL
All problems that match the other selection criteria will be deleted.
status-type
Specify one of the seven status types.
Top

Days (DAYS)

Specifies that problems older than this value are deleted. Valid values range from 0 through 999 days after the Opened or Closed date. Problems with any status other than Closed will be deleted the specified number of days after the Opened date. Problems with Closed status will be deleted after the specified number of days after the Closed date.

This parameter is valid only if *ALL is specified on the Problem identifier (PRBID) parameter.

30
The default number of days until problem deletion.
number-of-days
Specify the number of days. If this value is smaller than the system value QPRBHLDITV, the system value will be used instead.
Top

Origin (ORIGIN)

Specifies that problem log entries that originated at only the specified nodes are to be deleted.

The possible network ID values are:

*NETATR
Only entries that originated on systems with the same local network ID as the one defined in the network attributes for this system are deleted.
*ALL
All entries are deleted regardless of the network ID of their origin system.
network-ID
Specify a network ID.

The possible control point name values are:

*NETATR
Only entries that originated on systems with the same local control point name as the one defined in the network attributes for this system are deleted.
*ALL
All entries originating at systems with the specified network ID are deleted.
control-point-name
Specify a control point name.
Top

Examples

DLTPRB   STATUS(*OPENED *READY *SENT)  DAYS(15)

This command deletes all entries in the OPENED, READY, or SENT status that were added to the problem log prior to 15 days ago.

Top

Error messages

*ESCAPE Messages

CPF7AA6
Problem record &1 cannot be deleted.
CPF7AA7
Problem &1 not found or in use.
CPF7A9C
Cannot work with the problem log at this time.
CPF7A93
Problem &2 currently in use by job &1.
CPF9846
Error while processing file &1 in library &2.
Top