Working with a Problem

Problem analysis is the process of finding the cause of a problem a why the system is not working. Often this process identifies equipmen communications functions as the source of the problem. The Work with P (QPDWRKPB) API allows you to perform problem analysis on local machine- detected problems in the problem log. The Work with Problem (QPDWRKPB) prepares the problem in the problem log for reporting; it does not problem automatically.

Problem Log Entry APIs

The following set of problem management APIs are for designing problem cations.

Ÿ

Add Problem Log Entry (QsxAddProblemLogEntry)

Ÿ

Change Problem Log Entry (QsxChangeProblemLogEntry)

Ÿ

Create Problem Log Entry (QsxCreateProblemLogEntry)

Ÿ

Delete Problem Log Entry (QsxDeleteProblemLogEntry)

Ÿ

End Problem Log Services (QsxEndProblemLogServices)

Ÿ

Retrieve Problem Log Entry (QsxRetrieveProblemLogEntry)

ŸStart Problem Log Services (QsxStartProblemLogServices)

Error Reporting APIs

The following set of problem management APIs log software problems.

ŸLog Software Error (QPDLOGER) reports a software problem and collect

needed for its resolution.

Ÿ Report

Software

Error

(QpdReportSoftwareError) logs problems in the

log and

sends it

to

a service provider.

Program and CL Command APIs

You can use these APIs to do the following:

ŸCreate programs

Ÿ

List program or service program information

 

 

 

 

 

Ÿ

Retrieve program or service program information

 

 

 

 

Ÿ

Activate

service

programs

 

 

 

 

 

 

 

 

Ÿ

Manipulate

entries

in

the

associated space of a program

 

 

Ÿ

Handle compiler preprocessor-related tasks

 

 

 

 

 

Ÿ

Resolve

a

pointer

to

an

export

 

 

 

 

 

 

Ÿ

Scan a string of characters for a pattern

 

 

 

 

Ÿ

Execute

a

CL command

or

run

a command

from

within

an

HLL or

CL

prog

You

can

use

the

Create Program

(QPRCRTPG)

API

to write

your

own

asse

or compiler. When the assembler or compiler has created the machine

template,

this API

is used

to

create the

program

from

it.

 

 

Registration Facility

APIs

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

The registration

facility

is

a

service

that

provides

storage

and

retrieval

for OS/400 and non-OS/400

exit

points

and

exit

exitprogramspoint. isAn

a

spe-

 

cific point in a system

function

or

program

where

control may be

pas

more

specified

exit

programsexit .programAn

 

is

a

program

to

which

control

is

passed

from

an

exit

pointregistration. This facility

repository

allows

multiple

 

programs

to

associate

with

a given

system

function

or application

func

 

 

 

 

 

 

 

 

 

Chapter

8.

Use

of

OS/400

8APIs-19

 

Page 195
Image 195
IBM Version 4 manual Program and CL Command APIs, Working with a Problem, Problem Log Entry APIs, Error Reporting APIs