Work with Problem (WRKPRB)

Work with Problem (WRKPRB)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No Parameters
Examples
Error messages

The Work with Problem (WRKPRB) command works with the Work with Problems display. You can use this command to work with problems that were detected by the system or detected by the user.
Problems are deleted from the log by using the Delete Problem (DLTPRB) command.
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
SEV Severity Single values: *ALL
Other values (up to 3 repetitions): 1, 2, 3, 4 Optional
PERIOD Period Element list Optional
Element 1: Start time and date Element list
Element 1: Start time Time, *AVAIL
Element 2: Start date Date, *BEGIN, *CURRENT
Element 2: End time and date Element list
Element 1: End time Time, *AVAIL
Element 2: End date Date, *END, *CURRENT
HARDWARE Hardware Element list Optional
Element 1: Device type Character value, *ALL
Element 2: Model number Character value, *ALL
Element 3: Serial number Character value, *ALL
RESOURCE Resource name Name, *ALL Optional
LICPGM Product Element list Optional
Element 1: Program identifier Character value, *ALL
Element 2: Release Character value, *ALL
Element 3: Modification level Character value, *ALL
FUNCTION Function Character value, *ALL Optional
PGM Program Generic name, name, *ALL Optional
MSGID Message identifier Generic name, name, *ALL Optional
ORIGIN Origin Element list Optional
Element 1: Network identifier Communications name, *ALL, *NETATR
Element 2: Control point name Communications name, *ALL, *NETATR
SRVID Service number Character value, *ALL Optional
ASNUSER User assigned Simple name, *ALL Optional
GROUP Group assigned Character value, *ALL Optional
PRBTYPE Problem type *ALL, 1, 2, 3, 4, 5, 6 Optional
PRBCGY Problem category *ALL, *REPORT, *CRITICAL, *LOGONLY Optional

Top

Problem identifier (PRBID)

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

*ALL

All problem identifiers are selected.

problem-identifier

Specify the 10-character problem identifier of the problem being selected.

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.

*ALL

All types of status of problem log entries are shown.

status-type

Specify the type of status to be shown.

Top

Severity (SEV)

Specifies the severity level of the problem. Severity levels are assigned by the user when the problem is prepared for reporting. The four severity levels are:

1

High

2

Medium

3

Low

4

None

*ALL

All problem log entries are shown.

severity

Specify the level of severity of problem log entries to be shown.

Top

Period (PERIOD)

Specifies the period of time for which problem log entries are shown. This is the time when the problem entry was placed in the log.
The possible starting time values are:

*AVAIL

The logged data that is available for the specified starting date is shown.

start-time

Specify the starting time for the specified starting date indicating the logged data to display.
The time is specified in 24-hour format and can be specified with or without a time separator:

Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Hours, minutes, and seconds must each be exactly 2 digits (use leading zeros if necessary).
With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

The possible starting date values are:

*BEGIN

The logged data from the beginning of the log is shown.

If *BEGIN is specified, any time value other than *AVAIL for starting time is ignored.

*CURRENT

The logged data for the current day from the specified starting time through the ending time (if it is specified) is shown.

start-date

Specify the starting date for which logged data is shown. The date must be entered in the job date format.

The possible ending time values are:

*AVAIL

The logged data that is available for the specified ending date is shown.

end-time

Specify the ending time for the specified ending date for which logged data is shown. See the start-time description in this parameter description for details on how the time must be specified.

The possible ending date values are:

*END

The last day on which data was logged is the last day for which the logged data is shown.

If *END is specified, any time value other than *AVAIL for end-time is ignored.

*CURRENT

The logged data for the current day from the specified starting time through the ending time (if it is specified) is shown.

end-date

Specify the ending date for which logged data is to be shown. The date must be specified in the job date format.

Top

Hardware (HARDWARE)

Specifies that only problem log entries that identify the specified failing hardware are shown.
The possible machine type values are:

*ALL

All entries are shown, regardless of what hardware is identified as failing.

If *ALL is specified, any value other than *ALL for model and serial number is ignored.

type

Specify the 4-character type code for the hardware.

The possible model number values are:

*ALL

All entries that identify failing hardware of the specified type are shown.

If *ALL is specified, any value other than *ALL for serial number is ignored.

model

Specify the 3-character model number for the hardware.

The possible serial number values are:

*ALL

All entries that identify failing hardware of the specified type and model are shown.

serial

Specify the serial number of the hardware in one of the following formats, where n is a decimal character ranging from 0 through 9.

nnnnn
nnnnnnn
nn-nnnnn
nn-nnnnnnn

Top

Resource name (RESOURCE)

Specifies that only problem log entries that identify the specified failing resource name are shown.

*ALL

All entries are shown, regardless of which resource name, if any, is identified by the problem.

resource-name

Specify the resource name.

Top

Product (LICPGM)

Specifies that problem log entries that identify the specified failing software are shown.
The possible program ID values are:

*ALL

All entries are shown regardless of what software is identified as failing.

If *ALL is specified, any value other than *ALL for release and modification is ignored.

program-ID

Specify the identification number of the licensed program.

The possible release values are:

*ALL

All entries that identify failing software from the specified licensed program are shown.

If *ALL is specified, any value other than *ALL for modification is ignored.

release-level

Specify the release level of the licensed program.

The possible modification values are:

*ALL

All entries that identify failing software from the specified licensed program and release are shown.

modification

Specify the modification number of the release.

Top

Function (FUNCTION)

Specifies that only problem log entries that identify the specified function are to be shown. The function is present only in user-detected problem log entries and represents a major functional area or product.

*ALL

All entries are shown regardless of what function ID, if any, is identified.

generic*-function-identifier

Specify a generic function ID. A generic ID is a character string containing one or more of the initial characters of the function ID followed by an asterisk (*). If blank characters are included, the character string must be enclosed in apostrophes (').

function-id

Specify the complete function ID. If blank characters are included, the character string must be enclosed in apostrophes (').
The possible values for function ID are:

ID

Description

ALRT

Alerts

APF

Advanced printer function

APPC

Advanced program-to-program communications

APPN

Advanced Peer-to-Peer Networking function

APS

Advanced DBCS Printer Support program

ASYNC

Asynchronous communications

BAS

AS/400 BASIC

BGU

AS/400 Business Graphics Utility

BSC

Binary synchronous communications

CBL

AS/400 COBOL and COBOL for iSeries

CGU

Character generator utility

CL

Control language

CRYPT

Cryptographic Support/400

CSM

Communications and Systems Management

C400

C/400

DDM

Distributed data management

DFU

Data file utility

DHCF

Distributed host command facility

DICT

Language Dictionaries/400

DSNX

Distributed system node executive

ECS

Electronic customer support

FINANCE

Finance Communications

FTN

FORTRAN/400

FTS

File transfer support

GDDM

Graphical Data Display Manager

ICF

Intersystem Communication Facility

IDU

Interactive data definition utility (IDDU)

INTRA

Intrasystem Communication

IPDS

Intelligent Printer Data Stream

ITF

Interactive terminal facility

LPDA

Link Problem Determination and Analysis

MIA

MI Assembler

MIGR

Migration

OBJD

Object distribution

OCL

S/36 operator control language

OFC

OfficeVision

OSP

i5/OS

PAS

AS/400 Pascal

PASSTHRU

Pass-through

PC400

Client Access/400

PDM

Programming development manager

PL1

AS/400 PL/I

POSCOM

Point-of-Sale Communications Utility/400

QRY

Query/400

RETAIL

Retail Communications

REXX

REXX/400

RJE

Remote job entry

RLU

Report layout utility

RPFT

Performance Tools/400

RPG

RPG for iSeries

RSCS

Remote spooling communications subsystem

RWS

Remote work station

SDA

Screen design aid

SDLC

Synchronous Data Link Control

SEU

Source entry utility

SMU

IBM System Manager for i5/OS

SNADS

SNA distribution services

SNUF

SNA upline facility

SORT

AS/400 sort

SQL

SQL/400

SUU

System upgrade utility

TCPIP

TCP/IP Connectivity Utilities/400

TRLAN

Token ring network

TXT38

System/38 compatible Text Management

VMC

Vertical Licensed Internal Code

VNET

RSCS/PROFS

WRD

Word processing

X21

X.21 public data network

X25

X.25 packet-switching data network

3270EM

3270 device emulation

802.3

Ethernet

Top

Program (PGM)

Specifies whether only problem log entries that identify a specified failing program are shown. For machine detected problems, the failing program, if any, is identified by the most likely possible cause.

*ALL

All entries are shown regardless of whether a program is identified.

generic*-program-name

Specify a generic program name. A generic name is a character string containing one or more characters followed by an asterisk (*).

program-name

Specify the program name.

Top

Message identifier (MSGID)

Specifies whether only problem log entries that identify a specified message are shown.

*ALL

All entries are shown regardless of which message ID is associated with the problem.

generic*-msg-id

Specify a generic message identifier (ID). A generic ID is a character string containing one or more characters followed by an asterisk (*).

message-identifier

Specify the message identifier.

Top

Origin (ORIGIN)

Specifies that only problem log entries that originated at the specified systems are shown.
The possible network ID values are:

*ALL

All entries are shown regardless of the network ID of the origin system.

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

network-ID

Specify a network ID. Only entries that originated on systems with this local network ID are shown.

The possible control point name values are:

*ALL

All entries originating at systems with the specified network ID are shown.

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

control-point-name

Specify a control point name.

Top

Service number (SRVID)

Specifies whether only problem log entries that have the specified service assigned number are shown. This number was assigned when the problem was reported to IBM service support.

*ALL

All entries are shown regardless of the service assigned number, if any.

service-assigned-number

Specify the service assigned number.

Top

User assigned (ASNUSER)

User assigned (ASNUSER)

Specifies whether only problem log entries assigned to this user are shown.

*ALL

All problem log entries are shown.

user-name

Specify the user ID assigned to the problems to be shown.

Top

Group assigned (GROUP)

Specifies the group in the filter to which the problem is assigned.

*ALL

All program log entries are displayed, regardless of the group assigned to them.

group-name

Specify the 10-character problem filter group assigned to the entry.

The values are blank if problem log filtering is not used.

Top

Problem type (PRBTYPE)

Specifies which type of problems to work with.

*ALL

All problem log entries are shown, regardless of the problem type.

1

Only machine-detected problems are shown.

2

Only user-detected problems are shown.

3

Only PTF order problems are shown.

4

Only application-detected problems are shown.

5

Only Client machine-detected problems are shown.

6

Only Client user-detected problems are shown.

Top

Problem category (PRBCGY)

Specifies which category of problems to display.

*ALL

All problems are shown.

*REPORT

Problems that are logged and reported to the service provider are shown.

*CRITICAL

Problems that are critical are shown.

*LOGONLY

Problems that are logged, but not reported to the service provider, are shown.

Top

Examples

Example 1: Displaying Entries with Status of OPENED or READY
 WRKPRB   STATUS(*OPENED *READY) HDW(9347)
This command displays the Work with Problems panel, showing only those problem entries with a status of OPENED or READY which identify a failing device with type 9347.
Example 2: Displaying Current Day Problem Entries
 WRKPRB   PERIOD((*AVAIL *CURRENT))
This command displays the Work with Problems panel, showing all problem entries that are created in the log on the current day.
Example 3: Displaying List of Hardware Problems
 WRKPRB   SEV(1 2)  HARDWARE(9347 001 '10-7523489')
This command shows a list containing problems with the hardware specified by the user. The user has specified that the command track medium to high levels of severity.
Example 4: Displaying Problems That Have Been Opened
 WRKPRB   STATUS(*OPENED)
         PERIOD((*AVAIL  *CURRENT) (120000  *CURRENT))
         LICPGM(5722SS1  03  00)  PGM(QNOPGM)
This command shows a list containing problems that have been opened during the period starting at midnight and ending at noon on the current day, and have not yet been analyzed. This command also identifies the specified licensed program identifier and program name as the probable cause of the failure.
Example 5: Displaying a List of Machine-Detected Problems
 WRKPRB   RESOURCE(TAP01)  MSGID(CPF6788)
This command shows a list containing machine detected problems that were opened due to the message, CPF6788, having been sent to the system operator message queue and for which a problem analysis was done. The problem analysis was done to determine the resource name of the device suspected of failure, which in this case is device, TAP01. The list of problems includes user-detected problems. To get the user-detected problems, the user specified the resource name and message identifier by using the Analyze Problem (ANZPRB) command.
Example 6: Displaying a List of Reported Problems
 WRKPRB   SRVID(12345)
This command shows a list containing problems that have been reported to an IBM service identifier.

Top

Error messages

*ESCAPE Messages

CPF7A9C

Cannot work with the problem log at this time.

CPF7D41

Error occurred while logging order assistance request.

CPF7D42

Error occurred while performing database operation.

CPF9845

Error occurred while opening file &1.

CPF9871

Error occurred while processing.

Top

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
SEV	Severity	Single values: *ALL Other values (up to 3 repetitions): 1, 2, 3, 4	Optional
PERIOD	Period	Element list	Optional
	Element 1: Start time and date	Element list
	Element 1: Start time	Time, *AVAIL
	Element 2: Start date	Date, BEGIN, CURRENT
	Element 2: End time and date	Element list
	Element 1: End time	Time, *AVAIL
	Element 2: End date	Date, END, CURRENT
HARDWARE	Hardware	Element list	Optional
	Element 1: Device type	Character value, *ALL
	Element 2: Model number	Character value, *ALL
	Element 3: Serial number	Character value, *ALL
RESOURCE	Resource name	Name, *ALL	Optional
LICPGM	Product	Element list	Optional
	Element 1: Program identifier	Character value, *ALL
	Element 2: Release	Character value, *ALL
	Element 3: Modification level	Character value, *ALL
FUNCTION	Function	Character value, *ALL	Optional
PGM	Program	Generic name, name, *ALL	Optional
MSGID	Message identifier	Generic name, name, *ALL	Optional
ORIGIN	Origin	Element list	Optional
	Element 1: Network identifier	Communications name, ALL, NETATR
	Element 2: Control point name	Communications name, ALL, NETATR
SRVID	Service number	Character value, *ALL	Optional
ASNUSER	User assigned	Simple name, *ALL	Optional
GROUP	Group assigned	Character value, *ALL	Optional
PRBTYPE	Problem type	*ALL, 1, 2, 3, 4, 5, 6	Optional
PRBCGY	Problem category	ALL, REPORT, CRITICAL, LOGONLY	Optional