LPDSERV

Initialization › Initialization Parameter Statement Descriptions › LPDSERV

LPDSERV

Syntax

LPDSERV MAXTASK=[ 20 | nnnn ], 
        TCPPORT=[ 515 | nnnn ],
        TCPNS=[ YES | NO ], 
        LPRM=[ YES | NO ],
        PORTVAL=[ NO | YES | SUPV ],
        HOSTVAL=[ NO | YES ],
        DAM=[ JES | ESF | SAR | DUMMY | NO ],
        DESF=cccc,      
        DSAR=cccccccc,
        DSARMODE=[ SAR | EXP ], 
        DNAME=[ &N | &xnol | cccccccc ], 
        DUSERID=[ &P | &xnol | cccccccc ],
        DCLASS=[ A | &xnol | c ],
        DLRECL=nnnn,
        DDEST=[ &xnol | cccccccc ],     
        DFORM=[ &xnol | cccccccc ],     
        DDDNM=[ &xnol | cccccccc ],     
        DWRITER=[ &xnol | cccccccc ], 
        DHEADER=[ nnnn | cccccccc ],
        DJOBNAME=[ &xnol | cccccccc ],
        DTITLE=[ &xnol | cccccccc ],
        DKEY=xxxxxxxxxxxxxxxx,
        DOPTS=[ D|A|B|E|F|L|P|S] [C] [G] [J] [N] [O] [Q] [R] [U] [V] [X] [Y] [Z] [4],
        DCPTAB=cccccccc,
        DCPOUT=cccccccc,
        DTIMEOUT=[ 120 | nnnn ],
        DTRACE=[ DATA | ALL ],
        DEXIT=[ CONTROL | DATA | ALL ],
        DFIEXT=[ &N9 | &xnol | ccc ],
        DOUTLIM=[ 99999 | 99999K | 99999M ],
        DVALEXT=EXT1|...|EXTn,
        DINVEXT=EXT1|...|EXTn

Description

The LPDSERV statement specifies the general characteristics of the LPD Interface and the default values for the various LPDDEST parameters.

LPDSERV Parameters

This section describes the LPDSERV parameters.

MAXTASK= 20 | nnnnn

This parameter specifies the maximum number of concurrent TCP/IP LPD sessions

The lower limit is 1 and the upper limit is 9999. The default value is 20.

TCPPORT= 515 | nnnnn

This parameter specifies the TCP/IP port number on which the LPD Interface listens for session requests. If not specified, the LPD looks up the printer service in the TCP/IP Service File. If not found, the LPD defaults to use port number 515.

The lower limit is 1 and the upper limit is 65535. The default value is 515.

TCPNS= YES | NO

This parameter specifies whether a TCP/IP Name Server must be used to translate IP addresses into symbolic host names.

Valid values are:

YES—(Default) Call the Name Server to try to translate the IP addresses.
NO—Use the IP addresses

LPRM= YES | NO

This parameter specifies whether LPRM/CANCEL commands against CA Spool printer queues are allowed or not.

Valid values are:

YES—(Default) Allow LPRM/CANCEL commands against CA Spool printer queues.
NO—Reject LPRM/CANCEL commands against CA Spool printer queues.

PORTVAL= NO | YES | SUPV

This parameter specifies whether the requestor's source port must be validated or not.

Valid values are:

NO—(Default) Source port is not validated.
YES—Validate source port is in the range 721 to 731 inclusive.
SUPV—Validate source port is in the range 721 to 1023 inclusive.

HOSTVAL= NO | YES

This parameter specifies whether a requestor's IP address, defined to the TCP/IP Name Server, must be validated or not.

Valid values are:

NO—(Default) Skip validation of requestor's IP address.
YES—Validate that requestor's IP address is defined to the TCP/IP Name Server.

DAM= JES | ESF | SAR | DUMMY | NO

This parameter specifies the Default Access Method (DAM) to be used for incoming print requests.

Valid values are:

JES—(Default) Print files are, by default, written to JES SYSOUT files
ESF—Print files are, by default, written to CA Spool
SAR—Print files are, by default, written to CA View
DUMMY—Print files are, by default, received and discarded (thrown away)
NO—Print files are, by default, rejected

DESF= cccc

This parameter specifies the default CA Spool subsystem name to be used. If a value is not specified, the default subsystem name is the CA Spool subsystem name.

DSAR= cccccccc

This parameter specifies the default CA View database to be used. The CA View database name must be a 1 to 17-character alphanumeric string. There is no default value.

DSARMODE= SAR | EXP

This parameter specifies the default CA View user mode.

SAR—mode can retrieve any archived SYSOUT or any archived CA Deliver reports for viewing and printing.
EXP—CA Deliver mode lets you access reports archived from CA Deliver that are accessible to your distribution identifier (DIST ID).

DNAME= &n | &xnol | cccccccc

This parameter specifies the default output file name for incoming print requests. The file name must be a 1 to 32-character alphanumeric string. For JES and ESF output files, only the first 8 characters are used.

Valid values are:

&n—(Default) Specifies that the first 32 alphanumeric characters of the 'N – Name of source file' control file line are to be used
&xnol—This syntax is used to select a given part of any control file line as the default file name
cccccccc—This syntax can be used to assign a specific default output file name.

DUSERID= &P | &xnol | cccccccc

This parameter specifies the default user ID for incoming print requests. The user ID must be a 1 to 8 character alphanumeric string. The default value is &P.

DCLASS= A | &xnol | c

This parameter specifies the default output class to be used for incoming print requests for the following:

JES output files—The default output class is A
ESF output files—The default is to not specify any output class, so that the printer-dependent CA Spool output class default is used
SAR output files—The default is to not specify any output class

Valid values are:

A—The default output class for JES files
&xnol—This syntax can be used to select a given part of any control file line as the default output class.
c—This syntax can be used to assign a specific default output class

DLRECL= nnnn

Specifies the default LRECL value to use when a file is written.

DDEST= &xnol | cccccccc

This parameter specifies the default output file destination name for incoming print requests; the destination name must be a 1 to 8-character alphanumeric string for one of the following:

JES output files—The default is to not specify any SYSOUT destination
ESF output files—The default is to use the printer queue name of the incoming print request as the destination name
SAR output files—The default is to not specify any destination name

Valid values are:

&xnol—This syntax can be used to select a given part of any control file line as the default destination name.
cccccccc—This syntax can be used to assign a specific default destination name.

DFORM= &xnol | cccccccc

This parameter specifies the default output file form name for incoming print requests. The form name must be a 1-to 8-character alphanumeric string.

Note:

For JES output files, only the first four characters of the form name are used. The default is to not specify any SYSOUT form name.
For ESF output files, the default is to not specify any form name.
For SAR output files, the default is to not specify any form name.

Valid values are:

&xnol—This syntax can be used to select a given part of any control file line as the default form name.
cccccccc—This syntax can be used to assign a specific default form name.

DDDNM= &xnol | cccccccc

This parameter specifies the default output DDname for incoming print requests. The DDname must be a 1 to 8-character alphanumeric string

This parameter can be used to pass a unique file name to JES using the DDname parameter as follows:

&xnol—This syntax can be used to select a given part of any control file line as the default DDname.
cccccccc—This syntax can be used to assign a specific default DDname

There is no default value.

DWRITER= &xnol | cccccccc

This parameter specifies the default output writer name for incoming print requests. The writer name must be a 1 to 8-character alphanumeric string

This parameter can be used to pass a unique file name to JES using the writer parameter, as follows:

&xnol—This syntax can be used to select a given part of any other control file line as the default writer name
cccccccc—This syntax can be used to assign a specific default writer name

There is no default value.

DHEADER= nnnn | cccccccc

This parameter specifies where the data header line &D in the first received data buffer per default starts. The data header can be used for dynamic extracting of file attributes from the data file.

nnnn—This syntax specifies the default data header line offset. If a numeric value (nnnn) is specified, the search for the data header line begins at offset nnnn into the first data buffer.
cccccccc—This syntax specifies the default search string within the first data buffer. The data header line starts after the first occurrence of the search string. If the search string is not found, the data header line starts at offset 0.

The default value 0 implies the first 132 characters of the first data buffer.

DJOBNAME= &xnol | cccccccc

This parameter specifies the default job name for incoming print requests without the J—Job name for banner page specified. The job name must be a 1-8 character alphanumeric string.

Valid values are:

&xnol—This syntax can be used to select a given part of any other control file line as the default job name.
cccccccc—This syntax can be used to assign a specific default job name.

There is no default value.

DTITLE= &xnol | cccccccc

This parameter specifies the default title for incoming print requests without the T – Title for print file specified. The title must be a 1-60 character alphanumeric string.

Valid values are:

&xnol—This syntax can be used to select a given part of any other control file line as the default job name.
cccccccc—This syntax can be used to assign a specific default job name.

There is no default value.

DKEY= xxxxxxxxxxxxxxxxx

This parameter specifies the default 32/48/64 hexadecimal encryption key to be used to decrypt incoming AES Rijndael encrypted print data.

There is no default value.

DOPTS= D | A | B | E | F | L| P | S [C] [G] [J] [N] [O] [Q] [R] [U] [V] [X] [Y] [Z] [4]

This parameter specifies the default file type and various processing options for incoming print requests.

Specify the default file type by selecting one of the following:

D—(Default) Automatic file type detection; the first 32 KB bytes of data received are analyzed to set file type A, B, E, F, P, or S.
A—Incoming file is processed as an AFP print file
B—Incoming file is processed as a Binary print file
E—Incoming file is processed as a Text print file
F—Incoming file is processed as a PDF print file
L—Incoming file is processed as if it contains EBCDIC line data
P—Incoming file is processed as a PCL print file
S—Incoming file is processed as a PostScript file

(Optional) Select one or more of the following options:

C—Applies when the D option is specified. Processes the incoming file as a PCL print file if any PCL commands exist in the first 32 KB of data.
G—Specifies that overwrite records from Windows Generic/Text files must be combined into one record.
J—Assigns unique job name without assigning unique userid at the same time like the U option.
N—Specifies that a NOCC output file must be written.
O—Specifies that receive of empty files is allowed.
Q—Specifies that PRMODE=File-Extension is set for JES SYSOUT files, so it can be picked up by CA Dispatch.
R—Specifies that each incoming PCL command must be written to a separate record in output PCL print files.
U—Assigns the value of DNAME/FNAME as the job name. Also assigns the user ID of the sender as the creator of the JES SYSOUT files.
V—Specifies that ASCII AFP data must automatically be translated to EBCDIC AFP data.
X— Specifies that incoming PJL commands must be excluded in output Text and PCL print files.
Y—Specifies that incoming PJL commands and PCL commands must be excluded in output Text print files.
Z—Specifies that an early ACK must be sent to receive control file commands, if the data file is received before the control file.
4—Allows incoming print data to be AES Rijndael encrypted.

The default is D.

DCPTAB= cccccccc

This parameter specifies the default translate table (located in ESFTRAN) that will be used for ASCII to EBCDIC data translation for incoming text files.

The following entries are available in the default translate table module:

cccccccc	ASCII In CodePage	EBCDIC Out CodePage
12521140	1252—Windows Latin 1	1140—USA, Canada
12521141	1252—Windows Latin 1	1141—Austria, Germany
12521142	1252—Windows Latin 1	1142—Denmark, Norway
12521143	1252—Windows Latin 1	1143—Finland, Sweden
12521144	1252—Windows Latin 1	1144—Italy
12521145	1252—Windows Latin 1	1145—Spain, Latin America
12521146	1252—Windows Latin 1	1146—UK
12521147	1252—Windows Latin 1	1147—France
12521148	1252—Windows Latin 1	1148—International

The default value is the standard IBM C ASCII-to-EBCDIC translate table.

DCPOUT= cccccccc

Specifies the default AFP EBCDIC CodePage specified in the AFP EBCDIC output file if the V option is used. There is no default value.

DTIMEOUT= 120 | nnnnn

This parameter specifies the default maximum time interval (in seconds) to wait for incoming data from the remote TCP/IP host before the session is terminated.

The lower limit is 1 and the upper limit is 9999. The default value is 120.

DTRACE= DATA | ALL

This parameter specifies the default tracing used for incoming print requests.

Valid values are:

DATA—All data received and sent is traced
ALL—All data received and sent and all files opened are traced; all data written and files closed are traced

The default value is no tracing. The CONTROL parameter that was available in previous releases has been removed.

DEXIT= CONTROL | DATA | ALL

This parameter specifies the default calls to the LPD user exit for incoming print requests.

Valid values are:

CONTROL—The user exit is called when an LPD command, LPD job command, or a control file is received.
DATA—The user exit is called with DEXIT=CONTROL, as well as whenever some data is received or sent.
ALL—The user exit is called with DEXIT=DATA, as well as for all open, write, and close output file requests.

The default value is no user exit calls

DFIEXT= &N9 | &xnol | ccc

This parameter specifies the default file extension for incoming print requests.

Valid values are:

&N9—(Default) Use last source file name word as file extension.
&xnol—This syntax can be used to select a given part of any control file line as the default file extension.
ccc—This syntax can be used to assign a specific default file extension.

DOUTLIM= 99999 | 9999K | 9999M

This parameter specifies the default maximum file size allowed in bytes, kilobytes or megabytes. The default value is no file limit.

99999—Maximum allowed file size in bytes
99999K—Maximum allowed file size in KB
99999M—Maximum allowed file size in MB

DVALEXT= EXT1/…/EXTn

This parameter specifies the default the file extensions that the LPD Interface accepts. Valid file extensions must be separated with '/', and the parameter length cannot exceed 60 characters. If an invalid file extension is received, the print request is cancelled. The default is no file extension validation.

DINVEXT= EXT1/…/EXTn

This parameter specifies the default the file extensions that the LPD Interface rejects. Invalid file extensions must be separated with '/', and the parameter length cannot exceed 60 characters. If an invalid file extension is received, the print request is cancelled. The default is no file extension validation.