VMS Help RTL Routines, SMG$, SMG$GET_TERM_DATA  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Get Terminal Data routine accesses TERMTABLE.EXE and returns
    the character sequence that causes a terminal to perform a
    specified operation.

    Format

      SMG$GET_TERM_DATA  termtable-address ,request-code

                         ,maximum-buffer-length ,return-length

                         ,capability-data [,input-argument-vector]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 termtable-address

    OpenVMS usage:address
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Specifies the address of the TERMTABLE entry for the desired
    terminal. The termtable-address argument is the address of an
    unsigned longword that contains the address of the terminal
    capabilities table (TERMTABLE).

    The TERMTABLE address is returned by SMG$INIT_TERM_TABLE or
    SMG$INIT_TERM_TABLE_BY_TYPE.

 request-code

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference

    Longword constant of the form SMG$K_code, where code is the name
    of the desired capability field. The request-code argument is
    the address of a signed longword that contains the request code.
    The SMG$K_code constants can be found in the library supplied by
    Compaq, $SMGTRMPTR.

 maximum-buffer-length

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference

    Maximum length of the buffer into which the requested capability
    data is written. The maximum-buffer-length argument is the
    address of a signed longword that contains the maximum number
    of bytes that can be written into the buffer.

 return-length

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       write only
    mechanism:    by reference

    Receives the number of bytes actually written into the buffer.
    The return-length argument is the address of a signed longword
    into which is written the number of bytes transferred into the
    buffer.

 capability-data

    OpenVMS usage:unspecified
    type:         unspecified
    access:       by reference, array reference
    mechanism:    0

    Address of the first byte of the buffer which is to receive
    the capability data. The capability-data argument contains the
    address of the buffer.

 input-argument-vector

    OpenVMS usage:vector_longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference, array reference

    Address of a list of longwords used for capabilities that require
    a variable number of arguments, and for those that require
    substitution or arithmetic operations on an argument. The input-
    argument-vector argument is the address of an array of unsigned
    longwords that contains capability arguments. The first longword
    must contain the number of arguments that follow.