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

TMF ARLIB2 Audit-Reading Procedures

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

5-87

ARSTART

This procedure initializes the audit-reading programmatic interface. You must call

ARSTART before you begin issuing calls to any other audit-reading procedure.

return-code output

INT .EXT:ref:1

is a returned value indicating the outcome of this procedure.

number-of-cursors input, optional

INT:value

is an integer in the range 1 through 30 indicating the maximum number of cursors

that you can have open simultaneously. The amount of extended virtual memory

allocated for each cursor is approximately 100 KB. The default value is one.

operator-term input, optional

INT .EXT:ref:12

is an array containing the name (in internal form) of a terminal to which messages

to the operator are to be printed.

If operator-term is omitted, then the home terminal is used.

extended-seg-size input, optional

INT:value

specifies the maximum size (in megabytes) of the main extended segment. This

memory space will be shared by all memory allocated except that related to audit

for SQL/MX objects, including the memory reserved for use by cursors

(approximately 100 KB each), as well as caching of labels for SQL/MP objects

(approximately 32 KB each) and caching of label information for Enscribed objects

(approximately 50 bytes each). The minimum is 2, the maximum is 128, and the

default is 5.

CALL ARSTART ( return-code ! o

, [ number-of-cursors ] ! i

, [ operator-term ] ! i

, [ extended-seg-size ] ! i

, [ sqlmx-ext-seg-size ] ! i

, ar-version ); ! i

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

Warnings (>0) None.