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

    The Create a Virtual Keyboard routine creates a virtual keyboard
    and returns its assigned keyboard identifier.

    Format

      SMG$CREATE_VIRTUAL_KEYBOARD  keyboard-id [,input-device]

                                   [,default-filespec]

                                   [,resultant-filespec]

                                   [,recall-size]

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:       write only
    mechanism:    by reference

    Receives the keyboard identifier of the newly created virtual
    keyboard. The keyboard-id argument is the address of an unsigned
    longword into which is written the keyboard identifier.

 input-device

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

    String containing the file specification or logical name of the
    file or terminal to be used for this virtual keyboard. The input-
    device argument is the address of a descriptor pointing to the
    file specification. If omitted, this defaults to SYS$INPUT.

 default-filespec

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

    String containing the default file specification. The default-
    filespec argument is the address of a descriptor pointing to the
    default file specification. If omitted, the null string is used.

    The default-filespec argument might be used to specify a default
    device and directory, leaving the input-device argument to supply
    the file name and type.

 resultant-filespec

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

    String into which the procedure writes the fully expanded file
    specification of the file used. The resultant-filespec argument
    is the address of a descriptor pointing to the string into which
    is written the file specification that was used.

 recall-size

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

    Number of input lines to be saved for later recall. The optional
    recall-size argument is the address of an unsigned byte
    containing the specified number of lines. A value of 0 turns
    off input line recall. By default, 20 lines are saved for later
    recall.