AcuServer returns an error code whenever an AcuServer file access fails.
AcuServer error codes have the following format:
9D,xxx
"9D" indicates a server error and is returned in your file-status variable.
You can retrieve the extended code with the "-x" runtime switch, or by calling C$RERR. Note that you can pass two parameters to C$RERR to fetch interface errors. The first parameter retrieves the two- or three-digit extended error code. This parameter must be at least PICTURE X(5). The second parameter retrieves a message associated with the error condition and should be at least PICTURE X(80).
AcuServer errors
AcuServer errors have a three-digit extended code. These errors include:
9D,100 Invalid syntax for FILE-PREFIX.
The correct syntax for FILE-PREFIX is:
FILE-PREFIX @server-name:pathname
9D,101 The version of the server is not compatible.
9D,102 Invalid connection password specified by client.
9D,103 Connection to server refused, access denied.
9D,104 PC/TCP resident kernel is not loaded.
9D,105 User count exceeded.
An error 9D, 101 indicates that the version of the Acucobol runtime and the version of AcuServer are incompatible. Currently there are no incompatible versions of client-enabled runtimes.
An error 9D,105 indicates that the number of users attempting to use AcuServer exceeds the number of users authorized by your license. To extend the number of authorized users, please call Acucorp Customer Service.
RPC and network errors
RPC network errors have a two-digit extended code. You can determine the meanings of the network error codes by referring to the RPC documentation, or by displaying the error message returned in the second parameter to C$RERR.
RPC_SUCCESS=0, /* call succeeded */ RPC_CANTENCODEARGS=1, /* can't encode arguments */ RPC_CANTDECODERES=2, /* can't decode results */ RPC_CANTSEND=3, /* failure in sending call */ RPC_CANTRECV=4, /* failure in receiving result */ RPC_TIMEDOUT=5, /* call timed out */ RPC_VERSMISMATCH=6, /* rpc versions not compatible */ RPC_AUTHERROR=7, /* authentication error */ RPC_PROGUNAVAIL=8, /* program not available */ RPC_PROGVERSMISMATCH=9, /* program version mismatched */ RPC_PROCUNAVAIL=10, /* procedure unavailable */ RPC_CANTDECODEARGS=11, /* decode arguments error */ RPC_SYSTEMERROR=12, /* generic "other problem" */ RPC_UNKNOWNHOST=13, /* unknown host name */ RPC_PMAPFAILURE=14, /* the pmapper failed in its call */ RPC_PROGNOTREGISTERED=15, /* remote program is not registered */ RPC_FAILED=16, /* unspecified error */ RPC_UNKNOWNPROTO=17, /* unknown protocol */ RPC_INTR=18, /* call interrupted */ RPC_UNKNOWNADDR = 19, /* Remote address unknown */ RPC_TLIERROR = 20, /* Misc error in the TLI library */ RPC_NOBROADCAST = 21, /* Broadcasting not supported */ RPC_N2AXLATEFAILURE = 22, /* Name to address translation failed */ RPC_UDERROR = 23, /* recv got uderr indication */ RPC_INPROGRESS = 24, /* asynchronous error */ RPC_STALERACHANDLE = 25, /* asynchronous error */ RPC_CANTCONNECT = 26, /* couldn't make connection (cots) */ RPC_XPRTFAILED = 27, /* received discon from remote (cots) */ RPC_CANTCREATESTREAM = 28, /* can't push rpc module (cots) */