HELPLIB.HLB  —  SHOW  DISPLAY
    Indicates the node where output from a DECwindows application
    will be displayed.

    Format

      SHOW DISPLAY  [display-device]

1  –  Parameter

 display-device

    Refers to the display-device parameter specified with the SET
    DISPLAY command. If you are directing application output to
    multiple workstations in the same session, you can use logical
    names to point to each workstation. Using the SHOW DISPLAY
    command, you can specify this logical name as the display-device
    parameter to see where application output will be displayed.

    If you do not specify a display-device string, the logical name
    DECW$DISPLAY is used.

2  –  Qualifiers

2.1    /ALL

       /ALL (Alpha/Integrity servers only)

    Displays all named properties and their values related to the
    current display device.

2.2    /EXTRACT

       /EXTRACT (Alpha/Integrity servers only)

    Obtains the authorization data for the display device and writes
    that data to SYS$OUTPUT. The authorization data is obtained from
    the current X authority file and is in the format expected by the
    X Authority utility (xauth).

    Note that when using an LBX proxy server, the extracted
    authorization information references the address of the proxy
    server and not the X display server.

    Do not use the /EXTRACT qualifier with any other SHOW DISPLAY
    qualifier.

    See the description of the SET DISPLAY command for more
    information.

2.3    /QUOTA

       /QUOTA (Alpha/Integrity servers only)

    Displays the current name count and data space quota values for
    the display device. This display includes the set limit and the
    amount of space currently available for use.

2.4    /SYMBOLS

       /SYMBOLS (Alpha/Integrity servers only)

    Defines one or more global DCL symbols for each property
    displayed by the SHOW DISPLAY command. You can then use these
    property symbols in DCL command procedures.

    Each global symbol name follows the form:

    DECW$DISPLAY_name

    The following are the symbols for predefined properties:

       DECW$DISPLAY_NODE
       DECW$DISPLAY_TRANSPORT
       DECW$DISPLAY_SCREEN
       DECW$DISPLAY_SERVER
       DECW$DISPLAY_XAUTH

    Note that symbols for user-defined properties have a double
    underscore in the name. For example, the user-defined symbol
    for the value DISK$USER:[JONES] would be defined as follows:

    $ SHOW SYMBOL DECW$DISPLAY*

      DECW$DISPLAY_NODE == "101.124.99.119"
      DECW$DISPLAY_SCREEN == "0"
      DECW$DISPLAY_SERVER == "0"
      DECW$DISPLAY_TRANSPORT == "TCPIP"
      DECW$DISPLAY_XAUTH == "DISK$USER:[SMITH]SERVER1.DECW$XAUTH"
      DECW$DISPLAY__JONES == "DISK$USER:[JONES]"

    If a symbol name or value exceeds or violates any DCL limits or
    naming conventions, the symbol is not set and an error message is
    displayed.

    If the display device uses a proxy server, the symbols
    DECW$DISPLAY_NODE, DECW$DISPLAY_TRANSPORT, and DECW$DISPLAY_
    SERVER reflect values associated with the proxy server and not
    the X display server.

2.5    /VALUES

       /VALUES=(property-name[,...]) (Alpha/Integrity servers only)

    Displays the value for the specified property. If the value
    consists of one or more items, they are displayed as a comma-
    delimited list.

3  –  Examples

    1.$ SHOW DISPLAY
        Device:     WSA1:  [super]
        Node:       0
        Transport:  LOCAL
        Server:     0
        Screen:     0

      $ SET DISPLAY/CREATE/NODE=ZEPHYR
      $ SHOW DISPLAY
        Device:     WSA2:  [super]
        Node:       ZEPHYR
        Transport:  DECNET
        Server:     0
        Screen:     0
      $ SPAWN/NOWAIT/INPUT=NL: RUN SYS$SYSTEM:DECW$CLOCK

      In this example, you are logged in to your workstation, here
      referred to as node 0. (0 is the standard shorthand notation
      for representing your node.) You want to run the DECwindows
      Clock on your workstation and display it on another node,
      ZEPHYR.

      Assuming you are authorized to display applications on ZEPHYR,
      you redirect the application's output to ZEPHYR with the SET
      DISPLAY command and enter the SHOW DISPLAY command to verify
      the location of the redirected display. You then run Clock.
      Note that a new workstation display device, WSA2, is created
      when you enter the SET DISPLAY/CREATE command.

    2.$ SET DISPLAY/CREATE/VALUE=(NAME=DECW$SESSION_MANAGER,-
      _$ SET="tcpip/zephyr:9510")
      $ SHOW DISPLAY/SYMBOLS/ALL
          Device:    WSA23:  [super]
          Node:      0
          Transport: DECNET
          Server:    0
          Screen:    0

        User-defined values:

          "DECW$SESSION_MANAGER" = "tcpip/zephyr:9510"

      $ SHOW SYMBOL DECW$DISPLAY__DECW$SESSION_MANAGER
        DECW$DISPLAY__DECW$SESSION_MANAGER == "tcpip/zephyr:9510"

      In this example, you create a display device, and set the
      DECW$SESSION_MANAGER property to the network address of a
      session manager on remote node ZEPHYR using port number 9510.
      The SHOW DISPLAY/SYMBOLS command then defines a DCL symbol for
      the port value.
Close Help