Guardian Application Conversion Guide DCT Limits Extension Addendum

Affected Procedures

Guardian Application Conversion Guide DCT Limit Extension Addendum—527418-001

1-7

GETSYSTEMNAME

Calls to the GETSYSTEMNAME procedure do not need to change if they do only the

following:

•

Convert a system number to a system name

•

Use the return value only to test for success or failure

If the returned ldev would exceed 15 bits, GETSYSTEMNAME 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. GETSYSTEMNAME 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 GETSYSTEMNAME 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 GETSYSTEMNAME procedure,

which changed for RVU G06.23

•

The description of the NODENUMBER_TO_NODENAME_ procedure, which was

modified to accommodate the change to ldev

If appropriate, replace the call to the GETSYSTEMNAME procedure with a call to the

D-series procedure NODENUMBER_TO_NODENAME_.

Example 1-3. GETSYSTEMNAME Procedure

Change calls of the form:

INT LDEV;

INT SYS_NUM;

INT SYS_NAME[0:3];

LDEV := GETSYSTEMNAME(SYS_NUM, SYS_NAME);

To calls of the form:

LITERAL MAXLEN = 8;

INT(32) LDEV;

INT(32) SYS_NUM;

INT ERROR;

INT NAMELEN;

STRING SYS_NAME[0:MAXLEN - 1];

ERROR := NODENUMBER_TO_NODENAME_( SYS_NUM

, SYS_NAME : MAXLEN

, NAMELEN

, LDEV );