Customization › Automatic Printer Definition › Unknown Destinations

Unknown Destinations

When an attempt is made to create a file for an unknown destination, CA Spool invokes Automatic Printer Definition to determine whether the destination must be added as a printer node to enable the file to be created.

This functionality requires that the parameter DESTVAL in the CA Spool parameter deck (ESFPARM) is set to DYNAMIC or DYNAPDIP.

Whenever APD is invoked, CA Spool searches for applicable printer attributes for the printer node to be added. In essence, it finds the DEFNODE definition with the best match between the destination name and the DEFNODE APDNODE= parameter value. The APDNODE parameter value can be made a wildcard. These DEFNODE printer attributes are then used to define the printer.

To make any changes to DEFNODE statements in relation to dynamic printers, issue the REINIT command.

If no match is found, the DEFNODE PRINTER statement is used as a model for the new mode.

DESTVAL=DYNAPDIP DEST='IP:ipaddr' APD Support

The DESTVAL=DYNAPDIP initialization parameter activates special DEST='IP:ipaddr' APD - Automatic Printer Definition support for DEST='IP:ipaddr' printers. For non-DEST='IP:ipaddr' dynamically added printers, initialization works as if DESTVAL=DYNAMIC was specified.

The DESTVAL=DYNAPDIP support works with the following CA Spool input interfaces:

• DD SUBSYS interface
• SYSOUT allocation intercept with SUBS=CLASS/DEST/DESTCLAS and SUBSCLAS=
• XFERSAPI=YES/THREAD if XFERXCLAS=, XFERDEST= and XFEROPT=6
• NJE interface using DEST='nodename.IP:ipaddr'

When output with DEST='IP:ipaddr' is received using one of the supported CA Spool input interfaces, a corresponding APD printer is automatically defined (if not already defined).

DEST=IP:'123.456.789.012' is converted into a unique printer name starting with #, followed by seven alphanumeric characters.

DEST='IP:*hostname*' is converted into a most often unique printer name starting with #, followed by seven alphanumeric characters.

The DEST='IP:*hostname*' parameter is saved as a print file attribute and used during printing.

The maximum supported value for the DEST=’IP:ipaddr’ parameter is 64 characters, where the first three characters are the IP: prefix.

Defining DEFNODE with APDNODE=#* assigns default printer attributes to DYNAPDIP added printers.

A DYNAPDIP added printer is automatically deleted when no more files are queued to the printer.

When all DYNPRT printers are in use, the SYSOUT allocation intercept of DEST='IP:ipaddr' output is halted and DEST='IP:ipaddr' output is not intercepted. When a DYNPRT printer frees up, the interface restarts.

REINIT does not delete DYNAPDIP added printers, but REINIT of DYNAPDIP added printers are supported.