Previous Topic: Configuring CA Spool's LPD Interface with CA ViewNext Topic: xVALEXT Parameter


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.

The following example shows how to define a printer destination to CA Spool using the LPDDEST statement. The following parameters are required:

Parameter

Description

QDEST=LPDPRT

Printer queue name or prefix

FAM=SAR

Access method

FSAR=CAI.VIEW

CA View database name (high-level qualifier)

FOPTS=B

File type/processing options

FNAME=&N0

File name

The following parameters are optional, but recommended:

Parameter

Description

FFIEXT=&N9

File extension

FWRITER=LPDF

File writer name

FTIMEOUT=120

Session timeout in seconds

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. You must set the value to FAM=SAR to enable the storage and viewing of distributed file types.

FSAR

Defines which CA View database should be used for storing and viewing the files routed to this printer destination.

FOPTS

Defines the file type and processing options. For storing distributed file types in CA View, the recommended setting is B (Binary). If you are storing distributed and standard text or AFP files in the same CA View 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.

FNAME

Defines the report ID for CA View. Using the dynamic value syntax, you can create a report ID in several ways.

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:

Value

Description

&

Indicates that it is a dynamic value.

x

Specifies the input control or data header line (must be in capital letter).

n

(Optional) Specifies which word in the input control line to use.

o

(Optional) Specifies which offset to use (n must be coded).

l

(Optional) Specifies the number of characters (o must be coded).

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

Note: 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 FNAME parameter to create a report ID based on the following file name:

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

FNAME Parameter

Report ID

Default (not specified)

CLPDTESTSAMP

Start from the left, and remove all special characters to a maximum of 12 positions.

FNAME=&N8

REPORTA

N specifies the name of the source file, and 8 indicates the next-to-last word (REPORTA).

FNAME=&N704&N806

SAMPREPORT

&N704—N specifies the name of the source file, and 7 indicates the second-to-last word (SAMPLE). 04 extracts the first four characters.

&N806—N specifies the name of the source file, and 8 indicates the next-to-last word (REPORTA). 06 extracts the first six characters.

FNAME=&N0

REPORTA

N specifies the name of the source file, and 0 indicates the last word, unless it is a common extension. If it is a common extension such as TXT or DOC, the next-to-last word is used.

FNAME=xxxxxx

xxxxxx is a hard-coded value that is assigned to every report ID. For example, if the FNAME parameter is coded with a value of SALES, the report ID used for every file that is transferred is SALES.

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. For example, you may want to define a default file extension of TXT to any files transferred from a UNIX machine.

Note: 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 will become SAMPLE.REPORTA.TXT, which could impact the ability to view the file. If you are not transferring files that will contain common extensions, the default setting of &N9 will retain the existing file extensions when the file is loaded into the CA View database.

If you set the FOPTS parameter to D, and the file type is AFP, PCL, or PS, CA Spool will use the actual file type as the default file extension. Alternatively, you can set up separate LPDDEST statements for each file type, hard-coding the FFIEXT on each.

FWRITER

Passes a unique name to the CA View database used for storing the files routed to this printer destination. The value placed in this parameter appears under the DEST column in CA View.

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.