Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-77
DEVICEINFO2 Procedure
(Superseded by FILE_GETINFOBYNAME_
options input
INT:value
is a word indicating the options desired:
<0:12>
should be zero.
<13> if 1, indicates that this call is initiating a nowait inquiry and the information
will be returned in a system message. Do not set both
options.<13>
and
options.<14> to 1. See “Considerations” for more information.
<14> if 1, indicates that the sending of device-type inquiry messages to a
subtype 30 process should not be allowed to take longer than indicated by
the timeout value in
tag-or-timeout. If the time is exceeded, error 40 is
returned.
<15> if 1, indicates that device-type inquiry messages are not to be sent to
subtype 30 processes.
If omitted, zero is used.
tag-or-timeout input
INT(32):value
is a parameter with two functions depending on the
options you specify:
•
If options.<13> = 1, it is a value you define that helps identify one of several
DEVICEINFO2 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” for more information.
•
If options.<14> = 1, it is the maximum amount of time, in 0.01-second units,
to wait. The value -1D indicates an indefinite wait. If this parameter is omitted,
-1D is used.
Considerations
•
When DEVICEINFO2 is called with a file name that designates a subtype 30
process, it sends a device-type inquiry system message to the process to
determine the device type and subtype (unless disabled by the
options
parameter). The format of this completion message is described in the
Guardian
Procedure Errors and Messages Manual.
A deadlock occurs if a subtype 30 process calls DEVICEINFO on its own process
name.