*Conan The Librarian
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/I64 only) Displays all named properties and their values related to the current display device.
2.2 - /EXTRACT
/EXTRACT (Alpha/I64 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/I64 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/I64 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 == "188.8.131.52" 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/I64 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.