HP TCP/IP Services for OpenVMS

Previous Contents Index

20.3 Enabling MIME Mail

The MIME (Multipurpose Internet Mail Extensions) specification provides a set of additional headers you can use so that users can send mail messages composed of more than simple ASCII text. MIME is an enhancement to RFC 822.

For MIME mail to be decoded correctly, follow these guidelines:

If MIME mail does not decode, check the mail headers on the client system. If you see multiple blocks of headers and the MIME version header is not in the first block, confirm that you have followed these guidelines. Note that the headers of messages forwarded over OpenVMS Mail are mapped only if there is no cover note (that is, if the headers of a forwarded message are at the top of the message immediately following the headers of the forwarding message).

Chapter 21
Configuring XDMCP-Compatible X Displays

The X Window System, developed by the Massachusetts Institute of Technology, is a network-based graphics window system based on the client/server application model. The X protocol, through which the client and server communicate, runs on TCP/IP Services or DECnet. This means that an X display on one system can display information output from an application running on another system in the network.

An X display is a graphic output device that is known by The X Display Manager (XDM), such as:

This chapter reviews key concepts, discusses how to configure an XDMCP-compatible X display using the TCP/IP Services XDM server, and covers the following topics:

21.1 Key Concepts

The X Display Manager (XDM) is an X client that manages the login process of a user's X window session. XDM is responsible for displaying a login screen on a display specified by an X server, establishing an X window session, and running scripts that start other X clients. When the user logs out of the X session, XDM is responsible for closing all connections and resetting the terminal for the next user session.

An earlier version of XDM had limitations that were resolved with the introduction of the XDM Control Protocol (XDMCP). Before XDMCP, XDM used the XSERVERS file to keep track of the X terminals for which it managed the login process. At startup, XDM initialized all X terminals listed in the XSERVERS file. If the X terminal was turned off and then on again, XDM had no way of knowing that a new login process should be initiated at the X terminal. To reinitialize the X terminal, the XDM process had to be restarted. This problem was solved through the development of the XDM Control Protocol.

Now, because of XDMCP, XDM can listen for management requests from X terminals as well as use the XSERVERS file for the X terminals that were not XDMCP compatible. Most X terminals today are XDMCP compatible.

The TCP/IP Services implementation of XDM is based on the X11R6.1 release from X Consortium.

21.2 XDMCP Queries

XDMCP provides the following methods to query XDM for service:

The TCP/IP Services implementation of XDM does not support the indirect query with a chooser box supported by some other XDM servers.

An authentication protocol is supported for all three types of requests.

21.3 XDM Configuration Files

If the files are present, XDM uses the following files to configure the X display environment:

After installing XDM, you can use the TCP/IP Services-supplied configuration templates located in SYS$SPECIFIC:[TCPIP$XDM] to create the configuration files. The default directory location of the configuration and template files is the SYS$SPECIFIC:[TCPIP$XDM] directory.

21.3.1 Master Configuration File

The master configuration file, which is an optional file, specifies the location and file names of the other configuration files used to control the operation of XDM.

Example 21-1 shows the contents of the default configuration template file ([TCPIP$XDM]XDM_CONFIG.TEMPLATE) supplied with XDM:


! File name:      XDM_CONFIG.CONF 
! Product:        HP TCP/IP Services for OpenVMS 
! Version:        V5.4 
! © Copyright 1976, 2003 Hewlett-Packard Development Company, L.P. 
! XDM master configuration file 
DisplayManager.keyFile:            SYS$SPECIFIC:[TCPIP$XDM]XDM_KEYS.TXT 
DisplayManager.servers:            SYS$SPECIFIC:[TCPIP$XDM]XSERVERS.TXT 
DisplayManager.accessFile:         SYS$SPECIFIC:[TCPIP$XDM]XACCESS.TXT 
DisplayManager*RemoveDomainname:   true 

The file specification for the master configuration file is:


XDM uses the DisplayManager*RemoveDomainname: value when computing the display name for XDMCP clients. BIND, when performing a host name lookup creates a fully qualified host name for the X terminal. When this keyword is set to TRUE, XDM removes the domain name portion of the host name if it is the same as the local host domain. The default value of DisplayManager*RemoveDomainname: is TRUE.

21.3.2 XACCESS.TXT File

The XACCESS.TXT file, a required file, allows or restricts access to remote X servers. If the XACCESS.TXT file is not present, the system restricts all remote X server access. You use this file to control the way XDM responds to broadcast, direct, and indirect requests from X servers.

The default file specification for the XACCESS.TXT configuration file is:


If you choose to use another file name or directory location, you can override the default by adding a line in the XDM_CONFIG.CONF file similar to the following:

DisplayManager.accessFile:  WORK1$:[XDM]XACCESS.TXT    

Example 21-2 shows a sample XACCESS.TXT configuration file.

Example 21-2 XACCESS.TXT File

# File name:      XACCESS.TXT 
# Product:        HP TCP/IP Services for OpenVMS 
# Version:        V5.4 
# © Copyright 1976, 2003 Hewlett-Packard Development Company, L.P. 
# access control file for XDMCP connections 
# To control Direct and Broadcast access: 
# pattern 
# To control Indirect queries: 
#  pattern  list of hostnames and/or macros ... 
# To define macros: 
#       %name  list of hosts ... 
# The first form tells xdm which displays to respond to itself. 
# The second form tells xdm to forward indirect queries from hosts 
# matching the specified pattern to the indicated list of hosts. 
# In all cases, xdm uses the first entry which matches the terminal; 
# for IndirectQuery messages only entries with right hand sides can 
# match, for Direct and Broadcast Query messages, only entries without 
# right hand sides can match. 
*     #any host can get a login window 
# To hardwire a specific terminal to a specific host, you can 
# leave the terminal sending indirect queries to this host, and 
# use an entry of the form: 
#terminal-a host-a 

The supplied template file allows any access from any host. To restrict access, see the following sections for more information.

Allowing Direct Access

To allow access from a specific host, add a line to the XACCESS.TXT file with the host name, as shown in the following example:


Denying Access

To restrict access from a specific host, add a line to the XACCESS.TXT file with the host name, preceded by an exclamation point, as shown in the following example:


You can use the question mark (?) and the asterisk (*) wildcard characters to specify host names that vary with one character or more than one character.

Allowing Indirect Access

To allow indirect access, add a line to the XACCESS.TXT file similar to the following line:

rufus.company.com     richard.company.com henry.company.com william.company.com 

21.3.3 XSERVERS.TXT File

The XSERVERS.TXT file was originally used to specify all X servers to be managed by XDM. However, since the introduction of XDMCP, there is no need to specify X servers that are XDMCP compatible in this file.

This file now specifies the X servers that do not support XDMCP. Unlike other XDM implementations, this file is not used to specify XDM support for the local display server.

The default file specification for the XSERVERS.TXT file is:


If you choose to use a different name and directory location, you can override the default by adding a line to the XDM_CONFIG.CONF file similar to the following line:

DisplayManager.servers:  WORK1$:[XDM]XSERVERS.TXT 

Example 21-3 shows a sample XSERVERS.TXT configuration file.

Example 21-3 XSERVERS.TXT File

# File name:      XSERVERS.TXT 
# Product:        HP TCP/IP Services for OpenVMS 
# Version:        V5.4 
# © Copyright 1976, 2003 Hewlett-Packard Development Company, L.P. 
# This file can be used to suppport X terminals which do not support XDMCP 
# For each terminal, add a line that consists of 
#     DisplayName:0 foreign 
# Where DisplayName is a IP name. 
rufus.compaq.com:0 foreign 

In Example 21-3, the word "foreign" indicates that the X server is running on another machine.

21.3.4 XDM_KEYS.TXT File

The XDM_KEYS.TXT file provides XDM-AUTHENTICATION-1 style XDMCP authentication. This optional file contains key ID and key value pairs for use with X terminals that support or require XDM authorization.

Each noncomment line in the XDM_KEYS.TXT file contains a display ID and a key value. The file is used when a request containing a display ID key is received from an X terminal. The corresponding key value is encrypted and returned to the X terminal. If the key value in the configuration file matches the key value specified by the X terminal's control information, the session is allowed.

The default file specification for the XDM_KEYS.TXT files is:


If you choose to use a different name and directory location, you can override the default by adding a line to the XDM_CONFIG.CONF file similar to the following line:

DisplayManager.keyFile:  WORK1$:[XDM]XDM_KEYS.TXT 

Example 21-4 shows a sample XDM_KEYS.TXT configuration file.

Example 21-4 XDM_KEYS.TXT

# File name:      XDM_KEYS.TXT 
# Product:        HP TCP/IP Services for OpenVMS 
# Version:        V5.4 
# © Copyright 1976, 2003 Hewlett-Packard Development Company, L.P. 
# XDM security key file 
# Excursion Display ID:   Excursion Cookie: 
test123456    123457 
# Exceed Display ID:   Exceed Key: 
HCLpcXserver:629409365   1234568 


XDM's default operation after login is controlled by the SYS$SYSTEM:TCPIP$XDM_XSESSION.COM file. This file first parses its p1 display parameter nodename[:server[.screen]] and creates the DECwindows display using the following command:

$ SET DISPLAY/CREATE/NODE=workstation_display/TRANSPORT=TCPIP/SERVER=server_number - 

The default operation is to then create a Common Desktop Environment using the following command:


At present, CDE is only available on Alpha systems in version 1.2-4 or later of DWMOTIF. It is not available on VAX systems. If the CDE command procedure XSESSION.COM is not found on the system, XDM looks for the DECwindows Desktop Session Manager startup command procedure DECW$STARTSM.COM to initiate the session by using the following command:


Before executing either of these command procedures (but after performing the SET DISPLAY command), XDM looks for an XDM_XSESSION.COM file in the user's SYS$LOGIN directory. If found, XDM executes that file instead, passing it both the full display specifcation nodename[:server[.screen]] as p1 , and just the nodename as p2 . Users then have full control over exactly what type of session they prefer to start. For example, to simply start a DECterm, the following DCL commands would be placed into their XDM_XSESSION.COM file:


For a complete description of the CREATE command and its qualifiers, use the DCL command HELP at the OpenVMS system prompt.

21.4 XDM Log Files

XDM maintains three log files to record XDM server and client activity:

Table 21-1 lists the XDM log files and their OpenVMS directory locations.

Table 21-1 XDM Log Files
Process File Name Location
X terminal xterm_name_domain.COM SYS$SPECIFIC:[TCPIP$XDM.WORK]
  xterm_name_domain.ERR SYS$SPECIFIC:[TCPIP$XDM.WORK]
  xterm_name_domain.OUT SYS$SPECIFIC:[TCPIP$XDM.WORK]
User xterm_name_domain.LOG SYS$LOGIN

21.5 XDM Server Startup and Shutdown

The XDM server can be shut down and started independently from the rest of the TCP/IP Services software. This is useful when you change parameters or logical names that require the service to be restarted.

The following files are provided:

To preserve site-specific parameter settings and commands, create the following files. These files are not overwritten when you reinstall TCP/IP Services:

21.6 Configuring the XDM Server

To configure your XDM server, you need to:

21.7 Ensuring XDM Is Enabled and Running

To make sure that the XDM service is enabled and that the XDM process is running, enter the following TCPIP command:

Service             Port  Proto    Process          Address            State 
XDM                  177  UDP      TCPIP$XDM             Enabled 

21.8 Configuring Other X Displays

If you have an X terminal that does not support the XDMCP protocol, you can manage this terminal by using an XSERVERS.TXT configuration file. See Section 21.3.3 for information about how to create the configuration file.

If you are running hp eXcursion, refer to the Compaq PATHWORKS 32 eXcursion User's Guide for configuration information. For all other X servers, refer to the third-party X Window System software documentation for information about how to configure their product.

Previous Next Contents Index