HP OpenVMS DCL Dictionary
F$MULTIPATH (Alpha/I64 Only)
Returns a specified item of information for a specific
A character string containing the requested information.
Specifies a physical device name or a logical name equated to a
physical device name. Specify the device name as a character string
After the device-name argument is evaluated, the F$MULTIPATH
function examines the first character of the name. If the first
character is an underscore (_), the name is considered a physical
device name; otherwise, a single level of logical name translation is
performed and the equivalence name, if any, is used.
Specifies the type of device information to be returned. The item
argument must be specified as a character string expression. Currently,
the only valid item is MP_PATHNAME, which returns a string with the
path name for the specified multipath-capable device.
Prior to the first use of F$MULTIPATH with MP_PATHNAME, the context
symbol must be initialized to a value of 0. The F$MULTIPATH function is
responsible for maintaining the value of the context symbol.
Do not modify the context symbol value after it has been initialized to
0; doing so could result in unpredictable behavior of F$MULTIPATH.
Invokes the $DEVICE_PATH_SCAN system service to return a specified item
of information for a specific multipath-capable device.
The F$MULTIPATH lexical function also returns any error messages
generated by the $DEVICE_PATH_SCAN system service.
For more information about the $DEVICE_PATH_SCAN system service, refer
to the HP OpenVMS System Services Reference Manual.
$ XYZ = 0
$ PATH = F$MULTIPATH( "$1$DGA12", "MP_PATHNAME", XYZ )
$ IF PATH .EQS. "" THEN GOTO EXIT
$ WRITE SYS$OUTPUT "PATH NAME = ''PATH'"
$ GOTO LOOP
This example shows the use of F$MULTIPATH with the MP_PATHNAME item
code. Note that the context symbol XYZ has been initialized to 0
outside of the loop. The output from this command procedure is shown
below. When all paths for a given multipath device have been returned,
the end of the list is signalled by the return of a blank path name.
path name = PGA0.5000-1FE1-0001-5782
path name = PGA0.5000-1FE1-0001-5783
path name = PGA0.5000-1FE1-0001-5781
path name = PGA0.5000-1FE1-0001-5784
path name = MSCP