Re: API Help

[Pete Hall <pbhall@xxxxxxxxxx>]

At 15:45 07/27/2000 , Chris wrote:
>I am trying to use API Q1ARTVMED.
>
>It has 5 parameters
>
>1 receiver variable
>2 length of receiver
>3 format name
>4 control Value information
>5 Error code.
>
>for Error code it tells me to look in the System Programmers Interface 
>Reference   Where on earth can you find this book? I looked in all the 
>online books and could find nothing.
>
>also I don't know what to put in the length of receiver.

That would be the standard API error structure. Most of them use it. There 
are two formats, ERC0100 and ERC0200. ERC0100 looks like this:

      D E_ErrorStruct   DS

       * Size of the error structure is already set
      D  E_BytesProvid                10U 0 Inz(%Size(E_ErrorStruct))

       * The number of bytes of data returned if an error occurred
       * After an API call, E_BytesAvail will be zero if the API
       * ran successfully
      D  E_BytesAvail                 10U 0 Inz

       * Exception error message ID
      D  E_MsgId                       7    Inz

       * Unused
      D                                1

       * Message Data for the message identified in E_MsgID
      D  E_ExcptData                 100    Inz

ERC0200 further breaks E_ExcptData down into subfields. The same data is 
returned in any case.

It is documented in the System API Reference, SC41-5801 in section 1.2.4.1, 
API Error Reporting, Error code Parameter.
Pete Hall
pbhall@execpc.com
http://www.execpc.com/~pbhall
+---
| This is the Midrange System Mailing List!
| To submit a new message, send your mail to MIDRANGE-L@midrange.com.
| To subscribe to this list send email to MIDRANGE-L-SUB@midrange.com.
| To unsubscribe from this list send email to MIDRANGE-L-UNSUB@midrange.com.
| Questions should be directed to the list owner/operator: david@midrange.com
+---