Work with Problem (WRKPRB)
Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
The Work with Problems (WRKPRB) command shows problem log entries for problems that were detected by the system or detected by the user.
Problems can be 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 |
BRANCH | Branch number | Character value, *ALL | Optional |
COUNTRY | Country or region 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.
Single values
- *ALL
- All types of status of problem log entries are shown.
Other values (up to 6 repetitions)
- 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
Single values
- *ALL
- All problem log entries are shown.
Other values (up to 3 repetitions)
- 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.
Element 1: Start time and date
Element 1: Start time
- *AVAIL
- The logged data that is available for the specified starting date is shown.
- 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.
Element 2: Start date
- *BEGIN
- The logged data from the beginning of the log is shown.
Note: If *BEGIN is specified, any time value other than *AVAIL for the start 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.
- date
- Specify the starting date for which logged data is shown. The date must be entered in the job date format.
Element 2: End time and date
Element 1: End time
- *AVAIL
- The logged data that is available for the specified ending date is shown.
- time
- Specify the ending time for the specified ending date for which logged data is shown. See the time description for element 1 in this parameter description for details on how the time must be specified.
Element 2: End date
- *END
- The last day on which data was logged is the last day for which the logged data is shown.
Note: If *END is specified, any time value other than *AVAIL for the 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.
- 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.
Element 1: Device type
- *ALL
- All entries are shown, regardless of what hardware is identified as failing.
Note: 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.
Element 2: Model number
- *ALL
- All entries that identify failing hardware of the specified type are shown.
Note: If *ALL is specified, any value other than *ALL for serial number is ignored.
- model
- Specify the 3-character model number for the hardware.
Element 3: Serial number
- *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 any alphabetic or numeric character.
- nnnnn
- nnnnnnn
- nn-nnnnn
- nn-nnnnnnn
- nnnnnnnnnnnn
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.
- name
- Specify the resource name.
Top |
Product (LICPGM)
Specifies that problem log entries that identify the specified failing software are shown.
Element 1: Program identifier
- *ALL
- All entries are shown regardless of what software is identified as failing.
Note: If *ALL is specified, any value other than *ALL for release and modification is ignored.
- character-value
- Specify the identification number of the licensed program.
Element 2: Release
- *ALL
- All entries that identify failing software from the specified licensed program are shown.
Note: If *ALL is specified, any value other than *ALL for modification is ignored.
- character-value
- Specify the two digit release level of the licensed program including leading zeroes. The release level must be a number 00 through 35.
Element 3: Modification level
- *ALL
- All entries that identify failing software from the specified licensed program and release are shown.
- character-value
- Specify the two digit modification number of the licensed program including leading zeroes. The modification number must be a number 00 through 09 or 0A through 0Z.
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-identifier
- Specify the complete function ID. If blank characters are included, the character string must be enclosed in apostrophes (').
Valid 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
- BASIC compiler
- BGU
- Business Graphics Utility
- BSC
- Binary synchronous communications
- CBL
- COBOL compiler
- CGU
- Character generator utility
- CL
- Control language
- CSM
- Communications and Systems Management
- C400
- C compiler
- DDM
- Distributed data management
- DFU
- Data file utility
- DHCF
- Distributed host command facility
- DICT
- Language dictionaries
- DSNX
- Distributed system node executive
- ECS
- Electronic customer support
- FINANCE
- Finance Communications
- FTN
- FORTRAN compiler
- 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
- IBM i
- PAS
- Pascal compiler
- PASSTHRU
- Pass-through
- PC400
- Client Access for Windows
- PDM
- Programming development manager
- PL1
- PL/I compiler
- POSCOM
- Point-of-Sale Communications Utility
- QRY
- Query
- RETAIL
- Retail Communications
- REXX
- REXX interpreter
- RJE
- Remote job entry
- RLU
- Report layout utility
- RPFT
- Performance Tools
- RPG
- RPG compiler
- 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 i
- SNADS
- SNA distribution services
- SNUF
- SNA upline facility
- SORT
- Sort utility
- SQL
- SQL
- SUU
- System upgrade utility
- TCPIP
- TCP/IP Connectivity Utilities
- TRLAN
- Token ring network
- TXT38
- System/38-compatible Text Management
- VMC
- i5/OS 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-name
- Specify a generic program name. A generic name is a character string containing one or more characters followed by an asterisk (*).
- 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-name
- Specify a generic message identifier (ID). A generic ID is a character string containing one or more characters followed by an asterisk (*).
- name
- Specify the message identifier.
Top |
Origin (ORIGIN)
Specifies that only problem log entries that originated at the specified systems are shown.
Element 1: Network identifier
- *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.
- communications-name
- Specify a network ID. Only entries that originated on systems with this local network ID are shown.
Element 2: Control point name
- *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.
- communications-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.
- character-value
- Specify the service assigned number.
Top |
Branch number (BRANCH)
Specifies whether only problem log entries that have the specified branch number are shown. This number was assigned when the problem was reported to IBM service support.
- *ALL
- All entries are shown regardless of the branch number, if any.
- character-value
- Specify the three-digit branch number for the problem log entry. All three digits must be specified.
Top |
Country or region number (COUNTRY)
Specifies whether only problem log entries that have the specified country or region number are shown. This number was assigned when the problem was reported to IBM service support.
- *ALL
- All entries are shown regardless of the country or region number, if any.
- character-value
- Specify the three-digit country or region number for the problem log entry. All three digits must be specified.
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.
- character-value
- Specify the 10-character problem filter group assigned to the entry.
Note: 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 |