Customization › Automatic Printer Definition › APD User Exits

APD User Exits

CA Spool can affect and control the outcome of APD (Automatic Printer Definition) processing by means of user exit ESFU008X or the user exit specified on the UEX008 parameter of the LOADEXIT statement in the CA Spool parameter file. These exits are invoked every time an APD process runs. The ESFU008 exit can modify any attributes in the TDCE control block that is used to define the printer. These exits are invoked after the DEFNODE has been found and attributes inserted into the TDCE control block, but before the printer is defined.

Implementation of ESFU008X must be reentrant code that is link edited into the ESFMAIN load module. Implementation of an exit defined on the UEX008 parameter of the LOADEXIT statement must be reentrant code. It is not link edited into the ESFMAIN module.

Both the UEX008 version and the ESFU008X exits have access to the set of printer attributes selected by APD. This set of attributes is mapped by the $IQTDCE macro in CBQ4MAC. The exits can also access the attributes of the file that causes the APD process to run. This set of attributes is mapped by the $IQFQE macro in CBQ4MAC.

Based on this information, the exit might:

• Allow APD to proceed, possibly after modifying one or more printer attributes.
• Change the name of the destination. This forces APD to restart the process of looking up printer attributes.
• Reject the definition of the new printer.

Note: For more information about the use of the UEX008 exit definition and ESFU008X, see the Programming Guide.