Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-63
FILE_GETINFOBYNAME_ Procedure
disk files physical-recordlen is the maximum possible transfer length.
Transfer length is equal to the configured buffer size for the device
(either 2048 or 4096 bytes). (For an Enscribe disk file, the logical
record length can be obtained by a call to
FILE_GETINFOLIST[BYNAME]_.)
processes and $RECEIVE file
A length of 132 is returned in
physical-recordlen. This is the
system convention for interprocess files.
options input
INT:value
specifies the options desired. The bits, when set to 1, indicate the following:
<0:12> Reserved (specify 0)
<13> specifies that this call is only initiating a nowait inquiry and the
information will be returned in a system message. Do not set both
options.<13> and options.<14>. See “Considerations.”
<14> specifies that the sending of a device type inquiry message to a
subtype 30 process should not be allowed to take longer than indicated
by
tag-or-timeout. If the time is exceeded, error 40 is returned.
<15> specifies that device type inquiry messages are not to be sent to
subtype 30 processes.
If omitted, 0 is used.
tag-or-timeout input
INT(32):value
is a parameter with two functions depending on the value of
options that is
specified:
•
When options.<13> is 1, it is a value you supply to help identify one of
several FILE_GETINFOBYNAME_ operations. The system stores this value
until the operation completes, then returns it to the program in words 1 and 2 of
a system message. See “Considerations” below.
•
When options.<14> is 1, it is the maximum amount of time to wait,
expressed in 0.01-second units. The value -1D means wait forever. If the
parameter is omitted, -1D is used.
flags output
INT .EXT:ref:1
returns additional information about the file. The bits, when set to 1, indicate the
following: