Guardian Application Conversion Guide DCT Limits Extension Addendum

Affected Procedures
Guardian Application Conversion Guide DCT Limit Extension Addendum—527418-001
1-8
LOCATESYSTEM
In Example 1-3 on page 1-7, LDEV returns the value 32767D if SYS_NUM specifies
the local system in any of these ways:
•
By name
•
By the value -1D
•
By default (that is, SYS_NUM is omitted)
LOCATESYSTEM
Calls to the LOCATESYSTEM procedure do not need to change if they do only the
following:
•
Convert a system name to a system number
•
Use the return value only to test for success or failure
If the returned ldev would exceed 15 bits, LOCATESYSTEM returns the value 32,767
(which is never used as an actual ldev in the system). Because 32,767 is a positive
value when treated as a signed 16-bit integer, it correctly indicates a successful return.
LOCATESYSTEM also returns the value 32,767 if the specified system is the local
node, which also indicates a successful return.
If a call to the LOCATESYSTEM procedure uses the return value as an ldev or checks
for specific error codes, read the following in the Guardian Procedure Calls Reference
Manual:
•
The description of the function value ldev for the LOCATESYSTEM procedure,
which changed for RVU G06.23
•
The description of the NODENAME_TO_NODENUMBER_ procedure, which was
modified to accommodate the change to ldev
If appropriate, replace the call to the LOCATESYSTEM procedure with a call to the
D-series procedure NODENAME_TO_NODENUMBER_.
If your program tests for specific error codes, add a case for error code -3, which
indicates that a bounds error occurred on the sysname or sysnum parameter.