DLTPRB (Delete Problem)

DLTPRB Command syntax diagram

 

Purpose

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 Operations topic in the Information Center.

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.

 

Optional Parameters

PRBID

Specifies the problem identifier of the problem being deleted from the problem log. Problems with different system origins can have the same identifier. This parameter can be used with the ORIGIN parameter to select a single problem for deletion from a particular system origin.

*ALL: All problems are deleted.

problem-identifier: Specify the 10 character problem identifier of the problem being deleted. If a problem identifier is specified, the STATUS and DAYS parameters are ignored.

STATUS

Specifies the status of the problem log entries. The seven status types are as follows:

*OPENED

The problem is in OPENED status. The problem has been identified and a problem record has been 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 was returned by the service provider or added by an operator on this system.

*VERIFIED

The problem is in VERIFIED status. The problem has been resolved and the system operator has verified that the problem has been corrected.

*CLOSED

The problem is closed.

Note:

This parameter is valid only when PRBID(*ALL) is specified.

*ALL: All problems that match the user-defined values on this command and any current status types are deleted.

status-type: Specify one of the seven status types. Up to six status types can be specified.

DAYS

Specifies that all problems older than the value specified on this parameter are deleted. Problems with a status type other than CLOSED are deleted the specified number of days after the OPENED date. Problems with a CLOSED status type are deleted after the number of days following the CLOSED date.

This parameter is valid only when PRBID(*ALL) is specified.

30: The problem is deleted after 30 days.

number-of-days: Specify the number of days that can elapse before a problem is deleted. Valid values range from 0 through 999 days. If this value is smaller than the system value, QPRBHLDITV, the system value is used.

ORIGIN

Specifies whether only problem log entries originating on the specified nodes are deleted.

Element 1: Network Identifier

*NETATR: Only entries originating on systems with the same network identifier as the one defined in the network attributes are deleted.

*ALL: All entries are deleted regardless of the user's system origin network identifier.

network-identifier: Specify a network identifier. Only entries originating on systems with the specified network identifier are deleted.

Element 2: Control Point Name

*NETATR: Only entries originating on systems with the same control point name as the one defined in the network attributes are deleted.

*ALL: All entries originating on systems with the network identifier are deleted.

control-point-name: Specify a control point name. Only entries originating on systems with the specified control point name are deleted.

Example for DLTPRB

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.

Error messages for DLTPRB

*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.