Display Problems (DSPPRB)

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.

Parameters

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.

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.

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.

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.

Element 1: Start time and date

Element 1: Start time

*AVAIL

Problem entries created on the specified starting date are shown.

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.

Element 2: End time and date

Element 1: End time

*AVAIL

Problem log entries created on the specified ending date are shown.

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.

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

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

File to receive output (OUTFILE)

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

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

Qualifier 1: File to receive output

name

Specify the name of the file to which the output of the command is directed.

Qualifier 2: Library

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

name

Specify the name of the library where the file is located.

Output member options (OUTMBR)

Specifies the name of the database file member that receives the output of the command.

Element 1: Member to receive output

*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 for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.

name

Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Element 2: Replace or add records

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

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.

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.

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.