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

    The Home Cursor routine moves the virtual cursor to the specified
    corner of a virtual display.

    Format

      SMG$HOME_CURSOR  display-id [,position-code]

1 - Returns

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

2 - Arguments

 display-id

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

    Specifies the virtual display in which the virtual cursor is
    moved. The display-id argument is the address of a longword that
    contains the display identifier.

    The display identifier is returned by SMG$CREATE_VIRTUAL_DISPLAY.

 position-code

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

    Specifies the point to which the virtual cursor moves. The
    position-code argument is the address of a longword that contains
    the position code.

    Valid codes for position-code are as follows:

    Code               Meaning

    SMG$C_UPPER_LEFT   Row 1, column 1 (the upper left corner).
                       This is the default if position-code is not
                       specified.
    SMG$C_LOWER_LEFT   Row n, column 1 (where n is the number of
                       rows in the display). That is, the lower left
                       corner. It is useful to specify this position
                       when accepting input for an upward-scrolling
                       virtual display.
    SMG$C_UPPER_RIGHT  Row 1, column m (where m is the number of
                       columns in the display). That is, the upper
                       right corner.
    SMG$C_LOWER_RIGHT  Row n, column m (where n is the number of
                       rows and m is the number of columns in the
                       display). That is, the lower right corner.