IBM Version 4 manual Receiver Variables-Examples, Entry

Receiver Variables—Examples

As discussed in “Receiver Variables” on page 2-23, receiver variable used by retrieve APIs to return information to a caller. This topic examples of repeating entry types and of the use of offsets to g the next in the receiver variable.

Repeating

Entry

Type with

Fixed-Length

Fields—Example

In

the

following

example, the EXTI0100 format is defined in the qusre

file,

which

is

included

by

the

qusrgfa2.h

header

file

in

the

QSYSI

This

format

is

of the repeating entry type

with all fixed-length

fi

portion

of

the format (Qus_EXTI0100_Entry_t) is repeated after the f

The

fixed

portion of the format (Qus_EXTI0100_t)

is

returned

only

onc

from

one entry

to the next, you add the offset exit point entry

position

of

the

receiver

variable to

get to the

first

entry. Add

entry

field to

the

current

position in

the

receiver

variable to

move

entries.

typedef

_Packed struct Qus_EXTIð1ðð_Entry {

char

Exit_Point_Name[2ð];

char

Format_Name[8];

int

Max_Exit_Programs;

int

Number_Exit_Programs;

char

Allow_Deregistration;

char

Allow_Change_Control;

char

Registered_Exit_Point;

char

Prep_Name_Add_Pgm[1ð];

char

Prep_Lib_Add_Pgm[1ð];

char

Prep_Format_Add[8];

char

Prep_Name_Rmv_Pgm[1ð];

char

Prep_Lib_Rmv_Pgm[1ð];

char

Prep_Format_Rmv[8];

char

Prep_Name_Rtv_Info[1ð];

char

Prep_Lib_Rtv_Info[1ð];

char

Prep_Format_Rtv[8];

char

Desc_Indicator;

char

Desc_Msg_File[1ð];

char

Desc_Msg_Library[1ð];

char

Desc_Msg_Id[7];

char

Text_Description[5ð];

/\char

Reserved[];\/

} Qus_EXTIð1ðð_Entry_t;

typedef

_Packed struct Qus_EXTIð1ðð {

int

Bytes_Returned;

int

Bytes_Available;

char

Continue_Handle[16];

int

Offset_Exit_Point_Entry;

int

Number_Points_Returned;

int

Length_Exit_Point_Entry;

/\char

Reserved[];\/

/\Qus_EXTIð1ðð_Entry_t Array[];\/ } Qus_EXTIð1ðð_t;

Chapter 4. Common Information across APIs—Advanced (ILE)4-7Example