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

    The Save the Virtual Display to a File routine saves the contents
    of a virtual display and stores it in a file.

    Format

      SMG$SAVE_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:       read only
    mechanism:    by reference

    Specifies the virtual display to be saved. 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.

 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 the address of a descriptor pointing to the character string
    containing the file specification.

    A new file is created each time this routine is called.
    If filespec is omitted, the default file specification is
    SMGDISPLY.DAT.