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

    The Save Physical Screen routine saves the contents of the
    pasteboard so that a later call to SMG$RESTORE_PHYSICAL_SCREEN
    can restore it.

    Format

      SMG$SAVE_PHYSICAL_SCREEN  pasteboard-id ,display-id

                                [,desired-start-row]

                                [,desired-end-row]

1 - Returns

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

2 - Arguments

 pasteboard-id

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

    Specifies the pasteboard whose contents are to be saved. The
    pasteboard-id argument is the address of an unsigned longword
    that contains the pasteboard identifier.

 display-id

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

    Receives the display identifier of the display created to contain
    the contents of the specified pasteboard. The display-id argument
    is the address of an unsigned longword into which the display
    identifier is written.

    The display identifier must be passed to the SMG$RESTORE_
    PHYSICAL_SCREEN routine to restore the saved information.

 desired-start-row

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

    Specifies the first row to be saved. The desired-start-row
    argument is the address of a signed longword that contains
    the row number. If desired-start-row is omitted, row 1 of the
    pasteboard is used.

 desired-end-row

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

    Specifies the last row to be saved. The desired-end-row argument
    is the address of a signed longword that contains the row number.
    If desired-end-row is omitted, the last row of the pasteboard is
    used.