Windows C User Exits › Windows Client Middleware User Exits › Client Manager - Windows User Exits › IEFDP_SEARCHDIR—Directory Services Search Exit (Windows) › Purpose

Purpose

The Directory Services User Exit is the Client Manager's implementation of Transaction routing. Transaction routing is a conceptual process that lets cooperative flow data be routed from a Distributed Process Client (DPC) to a programmatically determined Distributed Process Server (DPS).

Note: For more information about transaction routing and directory services, see the Distributed Processing—Client Manager User Guide.

This exit is used to return a target system name to the Client Manager. This exit takes a single argument which points to two (2) NULL terminated strings. The first string is the transaction code and the second string is NextLocation data provided by the application. IEFDP_SearchDir should return a NULL value to the Client Manager if an appropriate target system cannot be found. If NextLocation data is provided, the sample program assumes that it contains a target system name.

Each time IEFDP_SearchDir is called, the sample code determines if the iefdir.trn input file has changed. If it has, the binary search tree is refreshed.