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 operations topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/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.
Element 1: Network identifier
- *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.
- communications-name
- Specify the network identifier of the system on which the problem originated.
Element 2: Control point name
- *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.
- communications-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 |