Passes error text with formatted ASCII output to programs for
    processing

1  –  Format

    sql$get_error_text (buf [,errmsglen])

2  –  Returns

    The status code that results from the copy operation of the
    vector's text to the user's buffer.

3  –  Arguments

3.1  –  buf

    The buffer declared to receive the text

    Value:         Address of the buffer declared to receive the text
    Data type:     Character string
    Passing        By descriptor
    mechanism:

3.2  –  errmsglen

    The number of characters allotted for the error messages to be
    returned. This parameter is optional.

    Value:         Number of characters allotted for the error
                   messages
    Data type:     Word
    Passing        By reference
    mechanism:

4  –  Description

    Use the sql$get_error_text routine when you want to pass error
    text with formatted ASCII output (FAO) substitutions to your
    program for processing.

    To use the sql$get_error_text routine, you must include a buffer
    (field) in your program declarations to receive the text SQL will
    pass to it. Declare this field as a text string with a length
    sufficient to accommodate the number of characters you expect
    for the message associated with the RDB$LU_STATUS value and for
    all follow-on messages. As an option, you can declare the buffer
    length as a separate field (defined as a signed word).

5  –  Related Routines

    o  sql_get_error_text