OULERR   

Equivalent PK functions: PK_ERROR_ask_last

OULERR ( selcod, ival, string, nchars, ifail )
==============================================

  Output information about the most recent KI-error

    Can be called from the GO.

Receives:
  KI_cod_sler              *selcod         --- enquiry code

Returns:
  int                      *ival           --- integer value
  char                      string[nchars] --- null-terminated character string
 <KI_int_nchars>           *nchars         --- length of character string
                                           --- (excluding terminal null)
  KI_cod_error             *ifail          --- error code


Description:

  OULERR returns information about the most recent KI-error (ie non-zero ifail
  return from a KI routine), and is principally intended as a debugging aid to
  help pinpoint the precise cause of the error. The value of 'selcod' determines
  what information is returned :-

  +--------+-------------------+-----------------+-----------------+-----------+
  |'selcod'|   interpretation  |     'ival'      |   'string'      | max-length|
  | value  | of 'selcod' value |  return value   |  return value   | of string |
  +--------+-------------------+-----------------+-----------------+-----------+
  | SLERRO | SLER_ROutine      | KI-routine-id   | KI-routine-name |     32    |
  +--------+-------------------+-----------------+-----------------+-----------+
  | SLEREC | SLER_Error_Code   |  ifail-value    | ifail-mnemonic  |     32    |
  +--------+-------------------+-----------------+-----------------+-----------+
  | SLEREX | SLER_EXplanation  |  ifail-value    | explanation of  |    256    |
  |        |                   |                 |   error code    |           |
  +--------+-------------------+-----------------+-----------------+-----------+
  | SLERAR | SLER_ARgument     | argument number | name of faulty  |     32    |
  |        |                   | ([-1],1,2,..)   |   argument      |           |
  +--------+-------------------+-----------------+-----------------+-----------+
  | SLERAI | SLER_Array_Index  | array-index     |    null         |      1    |
  |        |                   | ([-1],0,1,..)   |                 |           |
  +--------+-------------------+-----------------+-----------------+-----------+
  | SLERLE | SLER_List_Entry   | list-entry no.  |    null         |      1    |
  |        |                   | ([-1],1,2,..)   |                 |           |
  +--------+-------------------+-----------------+-----------------+-----------+
  | SLERTG | SLER_TaG          | tag value       |    null         |      1    |
  |        |                   | [or -1]         |                 |           |
  +--------+-------------------+-----------------+-----------------+-----------+

  For codes SLERAR, SLERAI, SLERLE, SLERTG, 'ival' may be returned as (-1)
  to indicate that the enquiry is not relevant to this error (for example, the
  error may not be specific to a particular argument).

  Where 'string' is null, it will simply contain the terminal null, and the
  value of 'nchars' will be zero.