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

    The Erase Virtual Display routine erases all or part of a virtual
    display by replacing text characters with blanks.

    Format

      SMG$ERASE_DISPLAY  display-id [,start-row] [,start-column]

                         [,end-row] [,end-column]

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 to be erased. The display-id
    argument is the address of an unsigned longword that contains
    the display identifier.

    The display identifier is returned by SMG$CREATE_VIRTUAL_DISPLAY.

 start-row

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

    Specifies the row at which the erase operation begins. The start-
    row argument is the address of a signed longword that contains
    the number of the row at which the erasure begins.

    If the start-row argument is not specified, start-column is also
    ignored and the entire virtual display is erased. If you do not
    specify start-row and start-column, then end-row and end-column
    are ignored and the entire virtual display is erased.

 start-column

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

    Specifies the column at which the erase operation begins. The
    start-column argument is the address of a signed longword that
    contains the number of the column at which the erasure begins.

    If the start-column argument is not specified, start-row is also
    ignored and the entire virtual display is erased. If you do not
    specify start-row and start-column, then end-row and end-column
    are ignored and the entire virtual display is erased.

 end-row

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

    Specifies the row at which the erase operation ends; that is, the
    last row to be erased. The end-row argument is the address of a
    signed longword that contains the number of the last row to be
    erased.

    If the end-row argument is not specified, end-column is also
    ignored and all remaining rows in the display are erased.

 end-column

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

    Specifies the column at which the erase operation ends; that
    is, the last column to be erased. The end-column argument is the
    address of a signed longword that contains the number of the last
    column to be erased.

    If the end-column argument is not specified, end-row is also
    ignored and all remaining columns in the display are erased.