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

TMF ARLIB2 Audit-Reading Procedures

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

5-83

ARPRINTMESSAGE

This procedure writes, to a specified file, the message text associated with the most

recent error condition for a particular cursor.

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 written.

file-number input

INT:value

is the filenumber of the file to which the message text is to be written.

max-line-length input, optional

INT:value

is the maximum number of characters to be printed as a single line of text. The

default value is 72.

Considerations

•

You can retrieve lines of the message text in a buffer by calling the

ARGETMESSAGELINE procedure.

CALL ARPRINTMESSAGE ( return-code ! o

, cursor-number ! i

, file-number ! i

,[ max-line-length ] ); ! i

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.