Display Problems (DSPPRB)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Display Problem (DSPPRB) command allows you to display or print service information related to performing hardware or software maintenance. The service information, contained in the problem log entries, are shown on the DSPPRB display, printed with the job's output, or stored in a database file.

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
OUTPUT Output *, *PRINT, *OUTFILE Optional
OUTFILE File to receive output Qualified object name Optional
Qualifier 1: File to receive output Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OUTMBR Output member options Element list Optional
Element 1: Member to receive output Name, *FIRST
Element 2: Replace or add records *REPLACE, *ADD
TYPE Type of information *BASIC, *CAUSE, *FIX, *USRTXT, *SPTDTA Optional
Top

Problem identifier (PRBID)

Specifies the ID of the problems to be selected. Problems with different origin systems may have the same identifier. Specifying the Origin (ORIGIN) parameter along with this parameter will assure that only one problem is selected.

*ALL
All problems that match the other selection criteria are selected.
problem-ID
Specify the 10-character problem ID of the problem to be 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 the problem data is selected. The dates and times indicate when the problem log entry was created.

The possible starting time values are:

*AVAIL
Problem entries created on the specified starting date are shown.
start-time
Specify the creation time (for the specified date) of the first data record to include.

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
Problems available at the beginning of the log are shown. If *BEGIN is specified, time values other than *AVAIL for start-time are ignored.
*CURRENT
The problem log entries created for the current day between the specified start-time and end-time (if specified) are displayed.
start-date
Specify the date after which the problem log entries can be shown. The date must be specified in the job date format.

The possible ending time values are:

*AVAIL
Problem log entries created on the specified ending date are shown.
end-time
Specify the time after which problem log entries created are not 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 a problem log entry was created is the last day for which problems are shown. If *END is specified, then any time value other than *AVAIL for end-time is ignored.
*CURRENT
The current date is used for the date of the last problem opened to show.
end-date
Specify the date after which problem log entries cannot be shown. See the start-date description in this parameter for details on how the date must be specified.
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.

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.

The possible model number values are:

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

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.

Note: 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.

Note: 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)

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 problem log entries are shown, 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.

Top

Problem type (PRBTYPE)

Specifies which type of problems to display.

*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

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*
The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
*PRINT
The output is printed with the job's spooled output.
*OUTFILE
The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.
Top

File to receive output (OUTFILE)

Specifies the name and library of the database file where the output of the command is directed. If the output file does not exist, this command creates a database file in the specified library. If a file is created, the text says OUTFILE for DSPPRB, and the authority for users other than those who have specific authority, group authority, or authority from an authorization list is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

The possible library values are:

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.
library-name
Specify the name of the library where the file is located.
Top

Output member options (OUTMBR)

Specifies the name of the database file member to which the output of the command is directed and whether the output to that member replaces or is added to existing records.

The possible methods for adding new records are:

*FIRST
The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified on the File to receive output (OUTFILE) parameter.
member-name
Specify the name of the file member that receives the output. If a member name is specified and the member does not exist, the system creates it.

The optional values are:

*REPLACE
The system clears the existing member and adds the new records.
*ADD
The system adds the new records to the end of the existing records.

Note: The OUTFILE and OUTMBR keywords are conditioned on OUTPUT(*OUTFILE).

If OUTPUT(*OUTFILE) is specified, a database file name is required.

Top

Type of information (TYPE)

Specifies the type of problem information that is placed in the output file. Only one type of data can be placed in each file. This parameter is valid only when a value is also specified on the File to receive output (OUTFILE) parameter.

*BASIC
Basic problem data including problem type, and status; device type, model, and serial number; product ID; contact information; and tracking data is placed in the output file.
*CAUSE
Possible problem causes are placed in the output file.
*FIX
Program temporary fixes (PTFs) are placed in the output file.
*USRTXT
User-supplied text (note records) is placed in the output files.
*SPTDTA
Supporting data identifiers are placed in the output file.
Top

Examples

Example 1: Displaying Today's Problem Log Entries 

DSPPRB   PERIOD((*AVAIL *CURRENT) (*AVAIL *CURRENT))

This command shows all problem log entries that were created today.

Example 2: Creating an Output File 

DSPPRB   OUTPUT(*OUTFILE)  OUTFILE(*CURLIB/NEWFILE)

This command creates a member in the physical file NEWFILE in the current library which contains a record for each problem log entry in the problem log.

Example 3: Displaying a List of Hardware Problems 

DSPPRB   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 a List of Problems That Have Been Opened 

DSPPRB   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 

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

DSPPRB   SRVID(12345)

This command shows a list containing problems that have been reported to an IBM service support center and have 12345 as the service identifier.

Top

Error messages

*ESCAPE Messages

CPF7A9C
Cannot work with the problem log at this time.
CPF9845
Error occurred while opening file &1.
CPF9847
Error occurred while closing file &1 in library &2.
Top