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

    The Replace Input Line routine replaces the specified lines in
    the recall buffer with the specified string.

    Format

      SMG$REPLACE_INPUT_LINE  keyboard-id [,replace-string]

                              [,line-count] [,flags]

1 - Returns

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

2 - Arguments

 keyboard-id

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

    Keyboard identifier. The keyboard-id argument is the address of
    an unsigned longword containing the identifier of the virtual
    keyboard from which to read.

    You create a virtual keyboard by calling the SMG$CREATE_VIRTUAL_
    KEYBOARD routine.

 replace-string

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    String that contains the line to be entered into the recall
    buffer. The replace-string argument is the address of a
    descriptor pointing to this string. The default is a null string,
    which removes the last line entered.

 line-count

    OpenVMS usage:byte_unsigned
    type:         byte (unsigned)
    access:       read only
    mechanism:    by reference

    Number of lines to be replaced. The line-count argument is the
    address of an unsigned byte containing the number of lines to
    be replaced with replace-string. The default value for the line-
    count argument is 1 (the last line entered).

 flags

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

    Specifies optional behavior. The flags argument is the address of
    an unsigned longword that contains the flag. There is one valid
    value:

    SMG$M_KEEP_CONTENTS    The string specified by replace-string
                           replaces the existing string specified by
                           line-count. By using this flag in a loop,
                           the line recall buffer can be preloaded
                           with information by the application.