IBM Version 4 manual API-Example, Processing, Job Description Information, Parameters

Ÿ Falls into a DO loop to process all of the .2ð/available list entries

Within this loop, LSTSPL retrieves each.21/,listextractsentry the number of field returned.22/, and enters an inner DO loop to process all of the availa fields.23/.

Within

this

inner

loop, the program extracts the.24/ fieldandprocessesinformation

the

field

data

based on.25/the. key field

When

all

fields

for

a

given

list

entry

have

been

processed,

LSTSPL

ge

print line.26/ and proceeds

to

the

next.27/. list entry

When all the list entries have been processed,.28/. LSTSPL ends

Processing

Lists That

Contain

Data Structures

Some

APIs

support

a

list

where

each

entry

in the

list

is

itself

a

good

example

is

the Retrieve System Status (QWCRSSTS) API. It

supports

tiple formats for different types of

information. The SSTS0300

format

co

where each entry in the list has the information

about

a

particular

addition

to

the

two critical fields (the offset

to

where the

list

number of entries in the list

field),

the

format

also

supports

a

fie

length

of

each

entry. In the

initial

library

list,

each

entry

was

1

a storage

pool,

a field (length of pool information entry) describes

should

be

used

instead of a fixed-length increment. This

allows

for

g

more

information being

available

in

another

release

for

each

list

entr

For

example,

if

another

field

is

added

to

describe

some

additional

a storage pool, it is probably added after the paging option field

information

entry

allows your code to be upwardly compatible while it

locations (relative to the start

of

a

list

entry)

of

the

current

f

Retrieve

Job Description

Information

API—Example

The

following

API

has been included as reference

information. This

API

many examples throughout this chapter

and

should not be

used

to

cod

grams. Refer toSystemthe API Reference, SC41-5801, for the most recent

version

of

this

API.

Parameters

Required Parameter Group:

1	Receiver		variable	Output		Char(*)
2	Length	of	receiver variable		Input	Binary(4)
3	Format	name		Input	Char(8)
4	Qualified		job description name		Input	Char(20)
5	Error	code		I/O	Char(*)

The Retrieve Job Description Information (QWDRJOBD) API retrieves in from a job description object and places it into a single variable program. The amount of information returned depends on the size of th

Chapter 3. Common Information across APIs—Basic (OPM) 3-Example29