TMF Application Programmer's Guide (H06.06+, J06.03+)

TMF ARLIB2 Audit-Reading Procedures

HP NonStop TMF Application Programmer’s Guide—540139-009

5-35

ARCLOSE

This procedure closes an open cursor. Closing a cursor ends its association with a

particular audit trail and makes that cursor available for reassignment by a subsequent

call to the AROPEN procedure.

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 identifying the particular open cursor to be closed.

sub-system output, optional

INT .EXT:ref:1

is a returned value valid only when return-code equals ARE-INTERNAL-ERROR

(-1000), in which case this value reports the subsystem that returned the error.

Table 5-4 describes the subsystem codes.

ar-error output, optional

INT .EXT:ref:1

is a returned value valid only when return-code equals ARE-INTERNAL-ERROR

(-1000), in which case the value indicates the specific error. Table 5-5 describes

the error codes.

Considerations

The optional parameters sub-system and ar-error must be passed in pairs. You

must pass either both the parameters or none.

CALL ARCLOSE ( return-code ! o

, cursor-number ! i

, [sub-system] ! o

, [ar-error] ); ! o

Errors (<0) Table 5-3 describes the error codes.

Warnings (>0) None.