Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-9
GETDEVNAME Procedure
(Superseded by DEVICE_GETINFOBYLDEV_
devname output
INT:ref:4
returns the device name or volume name of the designated device, if it exists, or
the next higher (numerically) logical device if the designated device does not exist.
The
devname remains unchanged if no higher logical device exists.
sysnum input
INT:value
specifies the system (in a network) that is searched for
ldevnum. If omitted, the
local system is assumed.
devtype input
INT:value
specifies an optional device type qualifier. If specified, the device type has to
match the designated device. If they do not match, the device is ignored and the
search continues.
devsubtype input
INT:value
specifies an optional device subtype qualifier. If specified, the device subtype has
to match the designated device. If they do not match, the device is ignored and
the search continues.
Considerations
•
The device name is returned in network form whenever the sysnum parameter is
supplied (except when the local system number is specified).
•
If the sysnum parameter is supplied, devices whose names contain seven
characters are not accessible using this procedure. This is because internal-form
network names are limited to six characters.
•
A process name is returned as a device name if you specify a logical device
number that corresponds to a destination control table (DCT) entry for a process.
•
If the devname being returned is that of a demountable disk, and the disk has been
demounted or is down, GETDEVNAME returns a status of 0, and the name
returned will be one of the following:
•
4 words of blanks (" "," "," "," ")
•
4 words of zero (0,0,0,0)
•
1 word identifying the node number and 3 words of blanks, for example,
"\n"," "," "," " (n is the value in SYSNUM)