HP OpenVMS Systems Documentation

/ALL

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

/EXTRACT

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.

Note that when using an LBX proxy server, the extracted authentication 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.

/QUOTA

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.

/SYMBOLS

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.

/VALUES=(property-name[,...])

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

1.1.3 Command Examples

1. In the following example, you are logged into your workstation (WSA1:) and want to run the DECwindows Clock application on a remote node (FLOPSY) and display it on another workstation (ZEPHYR). Both systems are using the MIT-MAGIC-COOKIE-1 authentication protocol to control access to the X display server.
   Assuming you are already authorized to connect to the server on node ZEPHYR, you create a display device that connects to ZEPHYR and generates a new authorization key. This key grants trusted connections to the server on ZEPHYR within 60 seconds of key generation. To restrict trusted access to the server, the key is stored in a new X authority file, XAUTHORITY_TEMP.DECW$XAUTH.
   The authorization key is then extracted and copied to FLOPSY, and merged with other entries in your X authority file on that system. You then set host to node FLOPSY and set display to node ZEPHYR. When you run the clock application from FLOPSY, it connects to the server on ZEPHYR and is allowed access as specified by the generated authorization key.

   $ SET DISPLAY/CREATE/GENERATE=TRUSTED/XAUTHORITY=XAUTHORITY_TEMP/NODE=ZEPHYR $ PIPE SHOW DISPLAY/EXTRACT | RSH FLOPSY "XAUTH NMERGE SYS$INPUT" $ SET HOST FLOPSY $ SET DISPLAY/NODE=ZEPHYR $ RUN SYS$SYSTEM:DECW$CLOCK

2. The commands in the following example 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. The symbol is then used to set the port value for a new display device.

   $ 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" $ SET DISPLAY UNTRUSTED/CREATE/XAUTHORITY=TEMP/GENERATE- _$ /VALUE=(NAME=DECW$SESSION_MANAGER,-) _$ SET="'DECW$DISPLAY__DECW$SESSION_MANAGER'")

3. In the following example, you are logged into a local workstation (WSA23:) on node FLOPSY and want to connect to an external host (hubbub.company.com), which is outside of your company's firewall. You use the proxy manager on a gateway host (GATEWY) to start the LBX proxy server, connect to the external host, and display the DECwindows Clock application.
   Note that DECnet is used within the local area network (LAN) to communicate to the proxy manager, and TCP/IP is used by the proxy server to communicate to the X display server on the external host. When using a managed proxy server, the proxy server chooses the transport for the client-to-proxy server connection.

   $ SET DISPLAY/CREATE/PROXY=GATEWY/NODE=hubbub.company.com- _$ /PMTRANSPORT=DECNET/NOLBXAUTHENTICATE/TRANSPORT=TCPIP $ SHOW DISPLAY Device: WSA23: [super] Node: HUBBUB.COMPANY.COM Transport: TCPIP Server: 0 Screen: 0 Connection will use: LBX proxy on node: gatewy.company.com Transport to proxy: TCPIP Server number: 63 $ RUN SYS$SYSTEM:DECW$CLOCK

Use the following new logicals to override the normal defaults when creating display devices:

• DECW$SETDISPLAY_DEFAULT_TRANSPORT -- Specifies the default transport to use when creating a display device without the /TRANSPORT qualifier.
• DECW$WS_NAME_COUNT -- Specifies the default name count quota for a new display device. This logical must be defined in executive mode and in the system logical name table.
• DECW$WS_DATA_SPACE -- Specifies the default data space quota for a new display device. This logical must be defined in executive mode and in the system logical name table.

To take advantage of the capabilities offered by the X Keyboard (XKB) extension and the enhanced X server security and authorization available with HP DECwindows Motif for HP OpenVMS Alpha Version 1.3, the following utilities have been introduced to the DECwindows Motif environment.

1.2.1 AccessX Keyboard Utility (accessx)

The AccessX Keyboard utility (accessx) is a client application that enables you to set one or more AccessX keyboard enhancements available with the X Keyboard extension (XKB). These enhancements make it easier for users with disabilities to interact with workstation input devices (keyboard and mouse).

Specifically, AccessX enhancements for XKB offer the following capabilities:

• Sticky Keys -- Allows you to perform multikey operations with one hand, one finger, or a mouth stick. You can use this feature to enter certain uppercase letters and punctuation characters without having to hold down the Shift key. This feature also makes it easier to enter control sequences, such as Ctrl/C.
• Mouse Keys (also known as Dead Mouse) -- Lets you map actions that you would perform with a mouse to keys on the numeric keyboard or other keys that you specify. With this feature, you can use one finger or a mouth stick to move the cursor to different areas of the screen, manipulate menus, and select, cut, and paste text.
• Toggle Keys -- Provides audio feedback when the Shift Lock (Caps Lock) key is pressed. This feature helps users who might have difficulty seeing the keyboard light indicator for the Shift Lock key or users who are using a keyboard that does not provide light indicators for any keyboard settings.
• Repeat Keys -- Allows you to adjust the auto-repeat keyboard mechanism speed or to turn it off entirely. With this feature turned on, you can set your keyboard so that holding down a key for a longer than average time does not cause a repeat entry of that character.
• Slow Keys -- Makes the keys less likely to respond when brushed accidentally. With this feature turned on, the computer accepts only keystrokes that are held for a certain length of time. The computer ignores light keystrokes that are held only for a moment.
• Bounce Keys -- Eliminates the problem of pressing a key and then accidentally pressing it again before moving to another key. You can set this feature to tell the computer not to process a second pressing of a key unless a certain length of time elapses between each pressing.
• Time Out -- Shuts off the AccessX features (except for Repeat Keys) on a workstation after a specified period of time. If you are sharing a workstation and have set AccessX features, the settings are automatically turned off before the next use. To retain the AccessX settings at all times, you can turn off the Time Out feature.

The settings for these capabilities are stored as X resource specifications available from an AccessX configuration file. This utility reads the appropriate file (either for the client or server) and adjusts the resource settings depending upon the changes you make. See Section 1.2.1.1 and Section 1.2.1.2 to learn more about the configuration file and its default values.

To run this utility, define accessx as a foreign command, and copy the UID file to DECW$USER_DEFAULTS:

$ accessx :== "$DECW$EXAMPLES:ACCESSX.EXE"
$ COPY DECW$EXAMPLES:ACCESSX.UID DECW$USER_DEFAULTS:ACCESSX.UID

The command format for accessx is as follows:

$ accessx [-options...]

You can run accessx by entering the command at the DCL prompt, with or without options. The options, described in Table 1-2, allow you to specify which configuration file to load and choose whether to display the status of the editing session. If no options are specified, the client configuration file is loaded by default.

Once invoked, the accessx dialog box is displayed, which lets you select the AccessX features that you want to enable. It also provides a test area that allows you to preview your settings before applying them to a DECwindows Motif session.

For detailed information on the controls and menu options in the dialog box, see the online help available from the Help menu option.

1.2.1.1 The AccessX Configuration File

The AccessX configuration file is an X resource file used to store and load specific AccessX settings for the client. The default client configuration file is located in SYS$LOGIN:ACCESSX.DAT and is created the first time you choose Save Settings.

You can choose to edit the file directly or use the accessx utility (with the -client or -server option) to modify the settings. Note that any comments inserted in this file are deleted when you perform a save settings action.

The format for entries in this file follow the standard X resource specification format, which is:

*resource:value

For example:

*BounceKeysToggle.set:False

Since an application can consist of a combination of input widgets (such as, push buttons and a scroll bar), you can use the widget class and name identifiers to create additional resource specifications to control these widgets.

1.2.1.2 Default Resource Settings

Table 1-3 lists the AccessX resources and their default values. These are default settings maintained by the server and also represent the initial settings in the client configuration file, prior to modification.

The X Authority utility (xauth) enables you to manage the contents of one or more X authority files. The X authority file contains information used to authorize client connections to the X server.

This utility is typically used to extract authorization records from one system and combine them with the records on another system, such as when granting access to additional users or enabling remote logins. The actual record entries vary depending on the authentication scheme currently in use.

In contrast to other X Window System utilities that are available with DECwindows Motif, xauth is included as a part of OpenVMS Alpha operating system. The xauth commands are case-insensitive and available directly from the DCL command line, xauth command line, or from a batch file.

The command format for xauth is as follows:

$ xauth [-f authfile] [-options...] [command]

Table 1-4 defines the available options.

Table 1-5 defines the available commands.