User`s manual

.DIAGFCN

5-86

The caller must provide a pointer to a structure when calling this

function. The structure Þrst contains an ÕintÕ (4 bytes) giving the size

of an available buffer to be used for output from this function. This

ÕintÕ is immediately followed by the address (4 bytes) of the start of

the buffer.

If this function is called with the ÕsizeÕ set to Õsizeof(int)Õ (4), then

this function will return a single integer (4 bytes) in the buffer,

containing the size of buffer needed to contain the list and the size.

To get the list, the function needs to be called with a buffer ÕsizeÕ at

least as large as is reported in the Þrst call. Anything smaller will

result in a non-zero return status, and the list will not be generated.

The caller should place the structure pointer in processor register

R03. An integer result will be returned, in place of the pointer

passed in to this function. A zero (0) result indicates success, non-

zero indicates failure.

Entry Conditions

R03 contains the diagfcn struct address.

Exit Conditions Different From Entry

An integer status to the higher level is returned in R03.

int ÕsizeÕ

void *bufptr -------------------------> int count

(char buf)