Bulletin number:  294
Products affected: D505A D605A D700E D705B D705C_alpha
Description: Return codes from iserver
Component: iserver libraries
Date: Mon May 21 16:42:50 BST 1990
-----
 
Routines like so.pollkey return values like spr.operation.failed and
spr.ok.  Spr.ok is defined as 0 and spr.operation.failed is defined as
128.
 
The iserver can return one of two values.  If all is well it returns
0.  If not it returns sp_error.  Unfortunately sp_error is defined as
129.
 
Workaround.  A return code of zero (spr.ok) means that all is well.
Other codes represent some form of failure.  If the return code is in
the range 1 to 127 inclusive then an error has been detected by the
library routines.  If the value is 128 or above a host dependent error
is indicated.  Any piece of code should check for a return code
greater than or equal to spr.operation.failed and not just equal to.
 
IF
  return.code = spr.ok
    ...  All is well 
  return.code >= spr.operation.failed
    ...  Host or system dependent failure
  TRUE
    ...  Other library defined and documented error
 
This has a lot of documentation implications.  [00156]