Guardian Procedure Calls Reference Manual

options
input
INT:value
specifies the options desired. The bits, when set to 1, indicate:
reserved (specify 0).<0:12>
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 (page 409).
<13>
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.
<14>
specifies that device type inquiry messages are not to be sent to subtype 30 processes.<15>
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.
• 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:
Reserved and undefined.<0:14>
File is an OSS file.<15>
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Considerations
• Specifying a subtype 30 process
When FILE_GETINFOBYNAME_ is called with a file name that designates a subtype 30
process, the procedure sends a device type inquiry system message to the process to determine
the device type and subtype (unless disabled by options.<15>). The message sent by
FILE_GETINFOBYNAME_ is either in D-series-format (message -106) or C-series-format (message
-40) depending on the options used when the subtype 30 process opened $RECEIVE. The
formats of these completion messages are described in the Guardian Procedure Errors and
Messages Manual.
The subtype 30 process replies with the requested information in system message -106 or -40,
corresponding to the message used in the inquiry. The returned device type value should be
one of those listed in Appendix A: Device Types and Subtypes. If the message response is
FILE_GETINFOBYNAME_ Procedure 409