TMF Application Programmer's Guide (G06.26+)

TMF ARLIB2 Audit-Reading Procedures

HP NonStop TMF Application Programmer’s Guide—522419-005

5-63

ARGETMESSAGELINE

This procedure retrieves a line of text from the most recent error message for a

particular cursor. The call indicates which line of the message to retrieve (the first line

of text in each message is line number 1). If the indicated line does not exist, then

line-length is set to 0. This convention allows you to retrieve the complete text of

a message by making successive calls to ARGETMESSAGELINE starting with line-

to-retrieve set to 1 and incrementing it by 1 each time through the loop until you

detect a line-length of 0.

return-code output

INT .EXT:ref:1

is a returned value indicating the outcome of this procedure.

cursor-number input

INT:value

is the number of the open cursor for which the message text is to be retrieved.

line-to-retrieve input

INT:value

is the number of the text line to be retrieved from the message.

buffer output

INT .EXT

is a buffer in the application process in which the line of message text is stored by

ARGETMESSAGELINE. The buffer must be at least 72 bytes long. Note that the

buffer can be allocated from either the 64K data stack or an extended segment.

CALL ARGETMESSAGELINE ( return-code ! o

, cursor-number ! i

, line-to-retrieve ! i

, buffer ! o

, line-length ); ! o

Errors (<0) Table 5-3 (later in this section) describes the error codes.

Warnings (>0) Bit 13, when set, indicates that the cursor has no error

information recorded.