TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-271
#OPENINFO Built-In Function
SYNCDEPTH
returns the sync depth with which the file or device was opened.
file-name or device-name
identifies the file or device for which information is desired. Each call to
#OPENINFO returns information about a single opening of the file or device.
tag
is a number identifying the particular opening for which information is wanted. A
zero value obtains information about the first opening; #OPENINFO includes in its
result the tag value to be used to get information about the next opening in
sequence.
Result
#OPENINFO returns a file-system code indicating the outcome of the operation:
Other file errors may be returned. See the Guardian Procedure Errors and Messages
Manual for the meanings of such messages.
If the result is 0, it is followed by a space, then the tag to be passed in the next call to
#OPENINFO, then another space, and finally a space-separated list of the information
requested by the options you supplied, in the order requested.
Considerations
•
Openings are not reported in any defined order. In particular, when #OPENINFO is
retrieving information about all openings of a disk volume, the openings for any
one file are not grouped together in the sequence of calls.
•
Because the BACKUP option may return nothing, you should specify it as the last
option to prevent confusion in reading the information list.
0 Success
1 No (more) openings