Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-7
GETDEVNAME Procedure
(Superseded by DEVICE_GETINFOBYLDEV_
GETDEVNAME Procedure
(Superseded by DEVICE_GETINFOBYLDEV_
Procedure (Superseded on G-series Releases)
or FILENAME_FINDNEXT_ Procedure
)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Summary
The GETDEVNAME procedure obtains the name associated with a logical device
number. GETDEVNAME returns the name of a designated logical device, if such a
device exists, and if the device attributes match any optional
devtype and
devsubtype parameters specified. If the designated logical device does not exist or
does not match optional
devtype, and devsubtype parameters, the search
continues for the name of the next higher (numerically) logical device which does meet
these criteria.
When GETDEVNAME searches for the next higher logical device and optional
parameters are supplied, it returns the name of the next higher logical device that
matches all supplied
sysnum, devtype and devsubtype parameters.
A status word is returned from GETDEVNAME that indicates whether or not the
designated device exists or if a higher entry exists. By repeatedly calling
GETDEVNAME and supplying successively higher logical device numbers, you can
obtain the names of all system devices.
Parameters
devtype and devsubtype can serve as a mask for those callers
interested only in a particular type or subtype of device.
By passing either
devtype or devsubtype or both, the caller can exclude all devices
with other types or subtypes from the search.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be
used for new development. This procedure is supported only for compatibility with
previous software.
Note. This procedure is supported for compatibility with previous software and should not be
used for new development.