TRANSFER Programming Manual

Managing the XDIR Server
The XDIR Server
069138, Update 1 to 040970 Tandem Computers Incorporated E–15
Managing the XDIR
Server
You need to be aware of certain issues of compatibility, performance, and security and
integrity when you configure an XDIR server.
Compatibility The necessary changes to the gateway make XDIR servers built with the C30 version of
TRANSFER (or IPM T9110AAK) incompatible with the C31 release of TRANSFER.
You must do the following for compatibility:
1. Add the PROC UOW^CAPABILITIES to your XDIR source code. This procedure
sets the SEND-IMPORT-MSG field of the RSP to N. It also sets the
SEND-EXPORT-MSG field of the RSP to N.
To avoid an unsatisfied external reference in the new XDIR server, you can add
the following. These two additions are recommended, but not necessary.
PROC UOW^SEND^IMPORT^MSG
PROC UOW^SEND^EXPORT^MSG
2. Recompile and bind a new XDIR server; “Building the XDIR Server” earlier in this
appendix gives details on how to do this.
Performance Performance might be only slightly degraded by the Exporter and Importer sending
IPCs (interprocess communications) to the XDIR server, as opposed to converting
names internally. If, however, the XDIR server experiences problems and frequently
returns positive error codes, this would have a detrimental effect on the gateway's
performance. The responsibility for writing an XDIR server that fails infrequently
rests with the user.
The opens of the XDIR servers are distributed by the export servers and also by the
import servers, but not collectively. That is, if there are six XDIR servers named
$XDR0:5, three exporter servers named $ZTZ0:2, and three import servers named
$ZTI0:2, the exporter servers would have the following opens:
$ZTZ0 opens $XDR0.
$ZTZ1 opens $XDR1.
$ZTZ2 opens $XDR2.
The import server opens, however, would be:
$ZTI0 opens $XDR0.
$ZTI1 opens $XDR1.
$ZTI2 opens $XDR2.
Servers $XDR3:5 would be idle. You can remedy this by changing the import server's
PATHWAY definition with
ALTER X400-IMPORTER, PARAM XDIR "$XDR3:5"
so that the import servers open only the otherwise unused XDIR server processes.