VMS Help SET, DISPLAY, Qualifiers  *Conan The Librarian (sorry for the slow response - running on an old VAX)

1 - /CREATE

    Creates the workstation display device (WSAn:) on which a
    DECwindows application is displayed. You must specify the /CREATE
    qualifier the first time you use the SET DISPLAY command, but
    you need not respecify it if you continue to redirect output from
    applications to other workstations with subsequent SET DISPLAY
    commands.

    When you specify the /CREATE qualifier without the /NODE
    qualifier, the workstation device defaults to the current node.
    Additionally, if you omit the /TRANSPORT qualifier, the transport
    defaults to either the value specified by the DECW$SETDISPLAY_
    DEFAULT_TRANSPORT logical, if defined, or to DECNET.

2 - /DELETE

    Cancels the redirected display by deassigning the logical name
    DECW$DISPLAY and deleting the created display device. If you
    specified a logical name as the display-device parameter with
    the SET DISPLAY/CREATE command, entering the SET DISPLAY/DELETE
    display-device command cancels the redirected display by
    deassigning the logical name you specified and deleting the
    created display device.

    The DECwindows Session Manager defines DECW$DISPLAY in your job
    logical name table when you open a terminal (DECterm) window.
    When you redirect application output to another workstation
    with the SET DISPLAY/CREATE command, an additional DECW$DISPLAY
    logical name is defined in your process logical name table. This
    definition supersedes the definition in the job logical name
    table. Output from applications run from the process in which
    you executed the SET DISPLAY/CREATE command will be displayed on
    the workstation referred to by the definition of DECW$DISPLAY in
    the process logical name table. Enter the SHOW DISPLAY command
    to see where this application will be displayed. To see whether
    multiple definitions for DECW$DISPLAY exist, enter the command
    SHOW LOGICAL DECW$DISPLAY.

    If DECW$DISPLAY is still defined (for example, in the job
    logical name table) after you specify the /DELETE qualifier, any
    DECwindows applications run from this process will be displayed
    on the workstation device to which output is now directed. Enter
    the SHOW DISPLAY command if you are unsure of the node to which
    DECW$DISPLAY refers.

                                 CAUTION

       If you modify or delete the definition of DECW$DISPLAY from
       the job logical name table, you will be unable to start
       another session. Be careful not to specify the /DELETE
       qualifier without having first redirected the display with
       the SET DISPLAY/CREATE command.

    You cannot specify the /DELETE and /CREATE qualifiers on the same
    command line.

3 - /EXECUTIVE_MODE

    Creates an executive-mode device and assigns the logical name
    DECW$DISPLAY to point to it. This qualifier must be used with
    the /CREATE qualifier. Devices created with the /EXECUTIVE_MODE
    qualifier are deleted only in the following situations:

    o  They are explicitly deleted with the /DELETE qualifier.

    o  The system is rebooted.

    To modify or delete executive-mode devices, you must have SYSNAM
    (system logical name) privilege.

4 - /NODE

       /NODE=workstation_display

    Defines the workstation on which you want to display DECwindows
    applications. The node name you provide cannot be a cluster alias
    (a name that represents multiple nodes configured in an OpenVMS
    Cluster), but must instead identify an actual node.

    You must create a workstation display device with the
    /CREATE qualifier before you can redirect the output from
    applications to other workstations. Do not enter the SET
    DISPLAY/NODE=workstation_display command without having
    previously specified the /CREATE qualifier.

    When you specify the /CREATE qualifier without the /NODE
    qualifier, the workstation defaults to the current node.

    Make sure that you are authorized to display applications
    on the workstation you specify. For more information about
    using the DECwindows Session Manager to authorize yourself to
    display applications from other nodes, refer to the DECwindows
    documentation.

    Each node, both source and destination, must be defined in
    the other's network node database. For example, to display
    applications on node HUBBUB from ZEPHYR, HUBBUB must be entered
    in ZEPHYR's network node database, and ZEPHYR must be entered
    in HUBBUB's network node database. In addition, users on ZEPHYR
    must be authorized in the DECwindows Session Manager to display
    applications on HUBBUB. For information about entering nodes in a
    network node database, refer to the DECnet for OpenVMS Networking
    Manual and the DECnet for OpenVMS Network Management Utilities
    manual. These manuals are available on the Documentation CD-ROM.

5 - /SCREEN

       /SCREEN=screen-number

    Defines the screen to be associated with this display device. In
    some hardware configurations, the system supports more than one
    screen. In such a configuration, you can specify the screen to
    which the application is directed.

6 - /SERVER

       /SERVER=server-number

    Defines the server to be associated with the display device
    indicated by the display-device parameter to the SET DEVICE
    command. Using the transport mechanism, the server passes
    data between the user and the application. In some hardware
    configurations, the system supports more than one server. In
    such a configuration, you can specify the server to which the
    application is directed. If you do not specify the display-
    device parameter, the SET DISPLAY/SERVER command associates the
    server with the display device indicated by the logical name
    DECW$DISPLAY.

7 - /SUPERVISOR_MODE

       /SUPERVISOR_MODE (default)

    Creates a supervisor-mode device and assigns the logical name
    DECW$DISPLAY to point to it. This qualifier must be used with the
    /CREATE qualifier. When the user logs out, the device is deleted.

8 - /TRANSPORT

       /TRANSPORT=transport-name

    Defines the mechanism, for example, DECnet or local, that passes
    information between the application and the workstation. The
    transport mechanism is used to send input from the user to
    the application and output from the application to the display
    device. The transport-name can be one of the following values:

    o  TCPIP or DECNET

       Specifies the appropriate network transport for applications
       running and displaying on different nodes. You can specify
       the default transport value used with the SET DISPLAY/CREATE
       command by defining the DECW$SETDISPLAY_DEFAULT_TRANSPORT
       logical in either the job, process, or system table. The
       value of this logical is then used each time you enter the
       SET DISPLAY/CREATE command without the /TRANSPORT qualifier.
       If you specify neither the qualifier nor the logical, the
       value of DECNET is used as default.

    o  LOCAL

       Optimizes the performance of applications running and
       displaying on the same node.

9 - /USER_MODE

    Creates a user-mode display device and assigns the logical name
    DECW$DISPLAY to point to it. This qualifier must be used with
    the /CREATE qualifier. The lifetime of a user-mode device is
    one DECwindows image: when the next DECwindows image exits, the
    device is deleted.