WRKPRB (Work with Problems)

WRKPRB Command syntax diagram

 

Purpose

The Work with Problems (WRKPRB) command allows you 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.

 

Optional Parameters

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.

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.

*ALL: Problem log entries with any status are shown.

status-type: Specify up to six of the seven status types.

SEV

Specifies the severity level of the problem log entries being shown on the display. The severity level is 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: Problem log entries with any severity level are shown.

severity-level: Specify up to three of the four severity levels.

PERIOD

Specifies the time when the problem entry was placed in the log. The period of time is specified by the starting time and date and the ending time and date.

Element 1: Starting Time

*AVAIL: The logged data that is available for the specified starting date is displayed.

start-time: Specify the time at which the data is logged. The time is specified in 24-hour format with or without a time separator as follows:

• With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue 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 fails.
• Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 through 23. Valid values for mm and ss range from 00 through 59.

Element 2: Starting Date

*BEGIN: The logged data from the beginning of the log is displayed.

Note:

If PERIOD(*BEGIN) is specified, then any time value other than *AVAIL for start-time is ignored.

*CURRENT: The logged data for the current day, and the time that has elapsed between the specified starting time and ending time for the day, is displayed.

start-date: Specify the date shown. The date must be entered in the format specified by the system values QDATFMT and, if separators are used, QDATSEP.

Element 3: Ending Time

*AVAIL: The logged data that is available for the specified ending date is displayed.

end-time: Specify the time at which logging of the data ends. See the description of start-time for details about how time can be specified.

Element 4: Ending Date

*END: The last day on which data was logged is shown. If PERIOD(*END) is specified, a time value other than *AVAIL for end-time is ignored.

*CURRENT: The logged data for the current day, and the time that has elapsed between the specified starting time and ending time for the day, is displayed.

end-date: Specify the last date on which the data is logged. The date must be entered in the format specified by the system values QDATFMT and, if separators are used, QDATSEP.

HARDWARE

Specifies that only problem log entries identifying the failing device are shown.

Note:

If HARDWARE(*ALL) is specified, *ALL must be specified for machine type, model, and serial number.

Element 1: Machine Type

*ALL: Entries are shown regardless of which device, if any, is identified as failing.

type-code: Specify the 4-character type code of the device.

Element 2: Model Number

*ALL: All entries identifying the specified type of failing device are shown.

model-number: Specify the 3-character model number of the device.

Element 3: Serial Number

*ALL: All entries identifying the specified type and model of the failing device are shown.

serial-number: Specify the serial number of the device in one of the following formats where n is a decimal digit ranging from 0 through 9.

• nnnnn
• nnnnnnn
• nn-nnnnn
• nn-nnnnnnn

RESOURCE

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

*ALL: Entries are shown regardless of which resource name, if any, is identified by the problem.

resource-name: Specify the resource name.

LICPGM

Specifies that only problem log entries identifying the failing licensed program are shown.

Note:

If LICPGM(*ALL) is specified, then *ALL must be specified for licensed program, release level, and modification number.

Element 1: Licensed Program

*ALL: All licensed programs are shown regardless of whether any are identified as failing.

program-identification-number: Specify the identification number of the licensed program.

Element 2: Release Level of the Licensed Program

*ALL: All entries identifying failing licensed programs are shown.

release-level: Specify the release level of the licensed program.

Element 3: Modification Number of the Release

*ALL: All entries identifying a failing licensed program of the specified licensed program and release are shown.

modification-number: Specify the modification number of the release.

FUNCTION

Specifies that only problem log entries identifying the function identifier are shown. This identifier is present only in user detected problem log entries.

*ALL: Entries are shown regardless of which function identifier, if any, is identified.

generic*-function-identifier: Specify the generic name of the function identifier. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. See generic names for additional information.

function-identifier: Specify the complete function identifier. If blank characters are included, the character string must be enclosed in apostrophes.

PGM

Specifies that only problem log entries identifying the failing program are shown. For machine-detected problems, the failing program is identified by the possible cause with the highest probability of failure.

*ALL: Entries are shown regardless of which program, if any, is identified.

generic*-program-name: Specify the generic name of the program.

program-name: Specify the name of the program.

MSGID

Specifies that only problem log entries identifying the message identifier are shown. This is the problem message identifier shown in the problem details display. For user detected problems, the message identifier is entered by the user.

*ALL: Entries are shown regardless of which message identifier is associated with a problem.

generic*-message-identifier: Specify the generic name of the message identifier.

message-identifier: Specify the message identifier.

ORIGIN

Specifies that only problem log entries originating at the specified nodes are shown.

Element 1: Network Identifier

*ALL: Entries are shown regardless of the network identifier of the origin system of each entry.

*NETATR: Only entries that originated on systems with the same local network identifier as the one defined in the network attributes for this system are shown.

network-identifier: Specify a network identifier. Only entries originating on systems with this local network identifier are shown.

Element 2: Control Point Name

*ALL: All entries originating on systems using the network identifier are shown.

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

control-point-name: Specify the name of the control point. Only entries originating on systems with this control point name are shown.

SRVID

Specifies that only problem log entries using the service-assigned number are shown. This number is assigned when the problem is reported to IBM service support.

*ALL: Entries are shown regardless of which service number, if any, is assigned to the problem.

service-identifier-number: Specify the service identifier number.

ASNUSER

Specifies which problem log entries are displayed.

*ALL: All program log entries are displayed, regardless of the user assigned to them.

user-name: Specify the user name assigned to the problem log entries to be displayed.

GROUP

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

*ALL: All problem log entries are displayed, regardless of the group assigned to them.

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

Note:

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

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 PC machine-detected problems are shown.

6: Only PC user-detected problems are shown.

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.

Examples for WRKPRB

Example 1: Displaying Entries with Status of OPENED or READY

WRKPRB  STATUS(*OPENED *READY) HDW(9347)

This command shows the Work with Problems display listing of 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 shows the Work with Problems display listing 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(5716SS1  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.

Error messages for WRKPRB

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