Guardian Procedure Calls Reference Manual

GETDEVNAME Procedure (Superseded by FILENAME_FINDNEXT_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
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 the optional devtypeand 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.
Syntax for TAL Programmers
status := GETDEVNAME ( ldevnum ! i,o
,devname ! o
,[ sysnum ] ! i
,[ devtype ] ! i
,[ devsubtype ] ); ! i
Parameters
ldevnum
input, output
INT:ref:1
is the logical device number at which an ascending search for a logical device is to begin. If
any of the optional sysnum, devtype, and devsubtype parameters are specified, only
GETDEVNAME Procedure (Superseded by FILENAME_FINDNEXT_ Procedure) 657