Guardian Procedure Calls Reference Manual

The line handler exists and the specified system is accessible, but the line handler logical device number

exceeds 15 bits of magnitude.

The specified system is the local system, so there is no line handler logical device number to return.

In either case, the system number is returned in sysnum.

The specified system does not exist.0

All paths to the specified system are down.-1

Bounds error occurred on sysname or sysnum.-3

Considerations

• If the caller provides sysname, sysnum is returned the corresponding number, but if the

caller omits sysname, the caller must supply sysnum.

• If the sysname specified does not exist, sysnum is set to 255.

• When retrieving a line handler logical device number that exceeds 15 bits of magnitude:

LOCATESYSTEM uses the number 32767 to represent any logical device number whose value

exceeds 15 bits of magnitude. (The value 32767 is reserved and is never used as an actual

logical device number.) To retrieve logical device numbers having more than 15 bits of

magnitude, replace calls to LOCATESYSTEM with calls to NODENAME_TO_NODENUMBER_.

Example

LDEV := LOCATESYSTEM ( SYS^NUM , SYS^NAME );

LOCATESYSTEM Procedure (Superseded by NODENAME_TO_NODENUMBER_ Procedure) 767