Processing Distributed Files for Mainframe Storage › Storing Distributed Files in a CA Dispatch Data Repository › Configuring CA Spool with CA Dispatch › LPDDEST Statement

LPDDEST Statement

This statement defines each destination printer or printer queue. It contains details specific to each LPR printer destination. There are no limits to the number of LPDDEST statements that can be defined. The LPDDEST statements are stored in a PDS member that is allocated to the CA Spool started task JCL using the ESFPARM DD statement. If you are planning to use CA Spool's LPD Interface to store distributed, standard text, or AFP files in the same CA Dispatch database, you should use separate LPDDEST statements: one or more for the distributed files, and separate statements for AFP and standard text files. The following information describes how to define the LPDDEST statement for binary files.

The following example outlines the individual parameters on the LPDDEST statement important to the CA Dispatch repository when defining a printer destination to CA Spool.

The following parameters are required:

The following parameters are optional, but can be useful:

QDEST

Specifies the printer destination. The value should match the -Pprinter specification in the LPR command.

FAM

Specifies the access method used for incoming print requests. The value must be set to FAM=JES to enable CA Dispatch to pick up distributed file types, pre-spool or post-spool.

FWRITER

Defines the report ID for CA Dispatch. Using the dynamic value syntax, a report ID can be dynamically generated from the file name or other LPR parameters, or it can be hard-coded to a specific value. (Hard-coding it to a specific value is not recommended because it would require one LPDDEST statement per report, but there may be specific reports where this technique would be helpful.)

Note: If the FWRITER parameter is not defined on the LPDDEST statement, a writer name can be specified on the LPR command by coding an extended class -C parameter as follows: -C:WRITER=reportname. Adding a writer name to the LPR command does not override the value coded on the LPDDEST FWRITER parameter.

CA Spool's LPD Interface supports automatic output file attributes through the use of dynamic value parameters. The syntax for a dynamic value is &xnol, where:

Note: You can code up to four &xnol values for each LPDDEST statement.

You can find a detailed explanation of the possible values for these symbols in the chapter "Configuration."

The following examples use dynamic values on the FWRITER parameter to create a report ID based on the following file name:

C:\LPD\TEST\SAMPLE.REPORTA.DOC

FOPTS

Defines the file type and processing options. For storing distributed file types in CA Dispatch, the recommended setting is B (Binary). (If you are storing distributed and standard text or AFP files in the same CA Deliver database, you should set up separate LPDDEST statements, one for the distributed files, and a separate one for the text and AFP files. If you choose to collect both using the same LPDDEST statement, you must define the FOPTS parameter with a value of D, which will analyze the contents of each file to determine the file type. If there are instances where the file type cannot be determined by the contents, you must specify B. A value of Q is required to set PRMODE=File-Extension when using FAM=JES, and is necessary so the files can be picked up by CA Dispatch. Also, a value of U is required to provide a unique JOBNAME when using the -J parameter of the LPR command.

FCLASS

Specifies the output class.

FDEST

Specifies output destination.

FTIMEOUT

Specifies the maximum time interval (in seconds) to wait for incoming data before terminating the session (1 through 9999). The default is 120 seconds.

FOUTLIM

Specifies the maximum file size in bytes, KB, or MB. The default is no file limit.

FFIEXT

Adds or changes a file extension for all files received on a specific printer. The default file extension used is the last part of the file name (or FFIEXT=&N9).

This parameter is useful if files are being transferred from a platform that does not commonly use file extensions to identify document types.

Example:

You may want to define a default file extension of TXT to any files transferred from a UNIX machine.

Important! This parameter, when explicitly defined, overrides any existing file extensions for all files sent to this printer destination. For example, if the FFIEXT parameter is set to TXT, the SAMPLE.REPORTA.DOC file becomes SAMPLE.REPORTA.TXT, which could impact the ability to view the file. If you are not transferring files that contain common extensions, the default setting of &N9 retains the existing file extensions when the file is loaded into the CA Dispatch database.

Note: If you set the FOPTS parameter to D, and the file type is AFP, PCL, or PS, CA Spool's LPD Interface uses the actual file type as the default file extension.

FNAME

Specifies an output file name. FNAME=&J indicates that this is a job name picked up from the -J parameter of the LPR command.