Directory services management exit routine

An installation-wide directory services management exit provides control over the extent to which VTAM® conducts search requests in the node in which the exit is loaded. The directory services management exit is the interface between VTAM's directory services and user-written code. VTAM conducts searches based on information provided by user code.

The exit routine is supported by VTAM end nodes, network node servers, border nodes, and origin and alternate directory servers. It is also supported by intermediate network nodes, but on broadcast searches only. Intermediate network nodes on directed searches do not invoke the directory services management exit routine.

You can use the DISPLAY EXIT command to display information regarding a directory services management exit. If you specify ISTEXCDM on the ID operand of the DISPLAY EXIT command, you can see which functions are active for the directory services management exit. You also can use a MODIFY EXIT command to activate, deactivate, or replace the exit routine without interrupting VTAM processing. See Operator commands for VTAM exit routines for more information about using the MODIFY EXIT command to modify VTAM exit routines. See z/OS Communications Server: SNA Operation for more information about these commands.

If you need to trace information relative to directory services management exit routine activity, use the MODIFY TRACE and MODIFY NOTRACE commands. These commands allow you to trace the directory services management exit's input and output. You can specify which exit functions to trace on the OPTIONS operand of the MODIFY TRACE and MODIFY NOTRACE commands. To display the trace, use the DISPLAY TRACES command.

Note: Because of the amount of generated data, the tracing of all exit functions might negatively affect performance. For this reason, use extensive tracing selectively.

For information about trace output, see z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures. For information about the MODIFY TRACE command, the MODIFY NOTRACE command, and the DISPLAY TRACES command, see z/OS Communications Server: SNA Operation.

This exit routine is optional. If you do not write an exit, all requests for directory services in your network are authorized. IBM® does not supply a directory services management routine or sample code.