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

    The Load a Virtual Display from a File routine creates a new
    virtual display and loads it with a virtual display saved with
    SMG$SAVE_VIRTUAL_DISPLAY.

    Format

      SMG$LOAD_VIRTUAL_DISPLAY  display-id [,filespec]

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

    Identifier of the new virtual display to be loaded with the
    saved virtual display. The display-id argument is the address
    of an unsigned longword into which is written the new display
    identifier.

 filespec

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

    String containing the file specification of the file in which the
    specified virtual display is saved. The filespec argument is a
    character string containing the file specification.

    If filespec is omitted, SMG$LOAD_VIRTUAL_DISPLAY searches for the
    default file specification SMGDISPLY.DAT.