l8HP DECprint Supervisor (DCPS) for OpenVMSG

HP DECprint Supervisor (DCPS) for OpenVMS
System Manager's Guide

z d f

11.6 What to Do if Layup Definition Files Are Not Found

JDECprint Supervisor software places the following sample layup definition ?files in the location specified by the logical name DCPS$LAYUP:

LPS$HOLES.LUP
LPS$SINGLEHOLES.LUP
LPS$DOUBLEHOLES.LUP
LPS$NUP.LUP!
COLOR-PRINTER-FULL-PAGE.LUP
PROPRINTER-FULL-PAGE.LUP

GMake sure that the layup directory logical name, DCPS$LAYUP, points to GSYS$SYSDEVICE:[SYSHLP.EXAMPLES.DCPS] or to the directory that contains 2the .LUP sample files on all nodes in the cluster.

11.7 What to Do if Files Are Printed with Unexpected Results

MThe DECprint Supervisor software attempts to print every file in every print Hjob even if there are problems in the specification of print parameters >and print job attributes. Print queues with erroneous default Gparameters can still print files, but all the print parameters are not @effective and messages are generated indicating the problem, as Xdescribed in Section 11.7.1.

=In cases where the file is printed using the wrong data type Htranslator, the file data type has not been correctly determined by the NDECprint Supervisor software. The methods for solving problems with automatic odata type detection are described in Section 11.7.2.m

11.7.1 What to Do if Default Queue Parameters Are Not Effective

EIf you enter a parameter in DCPS$STARTUP.COM incorrectly, print jobs Hsent to that print queue are printed, but the invalid parameter and the 9parameters following it are not applied to the print job.

GIf an invalid print parameter is included in the queue definition, the Eprinting system generates an error message that is displayed on your Gscreen and printed on the job trailer page for every print job sent to Ethe associated queue. The parameters that are not processed take the default settings.

EIn the following example, there is an extra L in the argument to the Csecond parameter, PAGE_ORIENTATION. Therefore, the printing system Eignores the second parameter, NUMBER_UP=2. Only the first parameter, SHEET_SIZE=B, is processed.

"
:$ @SYS$STARTUP:DCPS$GENERIC_QUEUE - ! Landscape queue B DCPS$WIDE$PRINT - ! P1 - Generic queue name K TEK4014_TTB4 - ! P2 - /GENERIC = execution queues ; "SHEET_SIZE=B,PAGE_ORIENTATION=LANDSCAPE,NUMBER_UP=2" G ! P3 - Default queue parameter

DFor every print job for this queue, an error message similar to the Dfollowing is displayed on the screen and printed on the job trailer page in the message section:

"
E10-JUN-2005 15:21 %DCPS-E-PARSYNERR, Syntax error in the /PARAMETERS 0qualifier at or near PAGE_ORIENTATION=LANDSCAPE

c

11.7.2 What to Do if a File Data Type Is Not Recognized

JIf the DECprint Supervisor software fails to determine the data type of a Dprint file correctly, the user can explicitly specify the DATA_TYPE Eparameter. If necessary, you can set up a generic queue for specific Ddata types. All files printed to this queue will have the specified Hdata type, unless the user explicitly specifies another data type using Hthe DATA_TYPE parameter. Users can also specify the DATA_TYPE=AUTOMATIC >parameter to explicitly specify automatic data type detection.

HThe automatic data type feature examines the following to determine the data type of the file:

The value of the DATA_TYPE parameter in the PRINT commandH
The queue default data type specified in the DCPS$STARTUP.COM file+
OpenVMS file tags (for example, DDIF ) stored_semantics tags)
The contents of the file
The file extension

MIf the DECprint Supervisor software cannot determine the file data type from Dthese steps, the default text data type is used. If no default text Bdata type has been defined by the user or the system manager (see uSection 4.2.2), the file is processed as ANSI. When the default text Hdata type is used, the text can precede PostScript; the file is printed Dproperly. However, the file may not be printed properly if any more Gtext follows the PostScript data. In this case, it may be necessary to Gedit the file and print the text and PostScript data as separate files.

AIn general, though, users should not be encouraged to modify the Econtents of their files or the file extensions so that the data type Hcan be determined. Instead, the application that generates the file may Hbe examined and modified if necessary; or you can provide site-specific Ffile extension files, default text data types, or generic queues with explicit default data types.

Appendix A
Printing System Management Commands

HYou use standard OpenVMS DCL commands to manage the DECprint Supervisor +queues, jobs, and related system resources.

Note

FRemember that the management commands only affect the system on which Dthey are issued. A network printer can serve other systems as well, Hwith each system having its own set of queues, jobs, forms, etc.

A.1 Overview of Management Commands

~Table A-1 lists the commands used to manage print queues, print Gjobs, and related system resouces. More information for these commands 7can be found in the HP OpenVMS DCL Dictionary.

y " #
Table A-1 Printing System Management Commands
Command Function
ASSIGN /MERGE J Removes jobs from one queue and puts them in another existing queue.
ASSIGN /QUEUE 4 Assigns a logical queue to an execution queue.
DEASSIGN /QUEUE < Deassigns a logical queue and stops the logical queue.
DEFINE /CHARACTERISTIC 5 Defines a queue characteristic name and number.
DEFINE /FORM : Defines a printer form name, number, and attributes.
DELETE /CHARACTERISTIC 7 Deletes the definition of a queue characteristic.
DELETE /ENTRY 3 Deletes one or more job entries from a queue.
DELETE /FORM ' Deletes the definition of a form.
DELETE /QUEUE Deletes a queue.
INITIALIZE /QUEUE D Not recommended for use with the DECprint Supervisor software.
SET ENTRY J Changes or deletes attributes of a job that is in the queue but not currently executing.
SET QUEUE 3 Changes the status and attributes of a queue.
SET QUEUE /ENTRY G This command has been superseded by the SET ENTRY command, which M performs identical functions. HP recommends that you use the SET ENTRY command.
SET QUEUE /RETAIN H Retains print jobs upon completion or termination due to an error.
SHOW ENTRY + Display information about print jobs.
SHOW QUEUE 1 Displays information about queues and jobs.
! SHOW QUEUE /CHARACTERISTICS H Displays information about queue characteristic names and numbers available on a queue.
SHOW QUEUE /FORM J Displays the names and numbers of the forms defined for your system.
START /QUEUE ! Starts or restarts a queue.
START /QUEUE /MANAGER C Starts the system job queue manager and opens the queue file.
STOP /QUEUE Pauses an execution queue.
STOP /QUEUE /ABORT A Stops the executing print job, but does not stop the queue.
STOP /QUEUE /MANAGER G Stops the system job queue manager and closes the job queue file.
STOP /QUEUE /NEXT B Stops the queue after the current job has finished printing.
STOP /QUEUE /REQUEUE L Stops the executing print job and requeues it to the specified queue, " but does not stop the queue.
STOP /QUEUE /RESET B Stops a queue immediately and returns control to the system.
c

**Table A-1 Printing System Management Commands**
Command	Function
ASSIGN /MERGE	J Removes jobs from one queue and puts them in another existing queue.
ASSIGN /QUEUE	4 Assigns a logical queue to an execution queue.
DEASSIGN /QUEUE	< Deassigns a logical queue and stops the logical queue.
DEFINE /CHARACTERISTIC	5 Defines a queue characteristic name and number.
DEFINE /FORM	: Defines a printer form name, number, and attributes.
DELETE /CHARACTERISTIC	7 Deletes the definition of a queue characteristic.
DELETE /ENTRY	3 Deletes one or more job entries from a queue.
DELETE /FORM	' Deletes the definition of a form.
DELETE /QUEUE	Deletes a queue.
INITIALIZE /QUEUE	D Not recommended for use with the DECprint Supervisor software.
SET ENTRY	J Changes or deletes attributes of a job that is in the queue but not currently executing.
SET QUEUE	3 Changes the status and attributes of a queue.
SET QUEUE /ENTRY	G This command has been superseded by the SET ENTRY command, which M performs identical functions. HP recommends that you use the SET ENTRY command.
SET QUEUE /RETAIN	H Retains print jobs upon completion or termination due to an error.
SHOW ENTRY	+ Display information about print jobs.
SHOW QUEUE	1 Displays information about queues and jobs.
! SHOW QUEUE /CHARACTERISTICS	H Displays information about queue characteristic names and numbers available on a queue.
SHOW QUEUE /FORM	J Displays the names and numbers of the forms defined for your system.
START /QUEUE	! Starts or restarts a queue.
START /QUEUE /MANAGER	C Starts the system job queue manager and opens the queue file.
STOP /QUEUE	Pauses an execution queue.
STOP /QUEUE /ABORT	A Stops the executing print job, but does not stop the queue.
STOP /QUEUE /MANAGER	G Stops the system job queue manager and closes the job queue file.
STOP /QUEUE /NEXT	B Stops the queue after the current job has finished printing.
STOP /QUEUE /REQUEUE	L Stops the executing print job and requeues it to the specified queue, " but does not stop the queue.
STOP /QUEUE /RESET	B Stops a queue immediately and returns control to the system.

A.2 Use of SET PRINTER with DCPS

FBecause PostScript printers are controlled by the DECprint Supervisor Nsoftware, the DCL SET PRINTER command has no meaning in a DECprint Supervisor Kenvironment. Print job characteristics for the DECprint Supervisor are set and displayed by other means.

DPrint job characteristics for DECprint Supervisor are determined by:

Parameters embedded in the job dataJ
Parameters passed in the /PARAMETERS qualifier of the PRINT command
DEFINE /FORM qualifiersE
For PrintServer printers, default parameters which are in the $ PrintServer configuration database>
The default queue parameters, which are defined in the DCPS$STARTUP.COM file

@Items 1, 2, and 3 in this list are controlled by the PostScript Hinterpreter or the data syntax translator, depending on the type of job @being processed. Item 4 is controlled by the PrintServer server vmanagement interface described in the DEC PrintServer Supporting Host Software for OpenVMS Management Guide.

tTable A-2 shows the SET PRINTER qualifiers and the equivalent 5control in a DECprint Supervisor printing system.

Ž 0 -
Table A-2 SET PRINTER Qualifier Equivalents for DECprint Supervisor Queues
SET PRINTER Qualifier Equivalent Control
/CR K Insertion of carriage return characters is controlled by the current data type translator.
/FALLBACK K Translation of DIGITAL multinational characters is controlled by the K current font. If the character does not exist in the specified font, & the font error character prints.
/FF D Mechanical form feeds are controlled by the current data type / translator or the PostScript interpreter.
/LOWERCASE R The DECprint Supervisor printer is considered to be a lowercase printer. It 0 does not translate lowercase to uppercase.
/PAGE I The number of lines printed on each page is controlled by the ANSI M translator (ANSI files only). This characteristic is available through DEFINE /FORM.
/PASSALL K Whether the system interprets special characters or forwards them as J 8-bit binary data is controlled by the current data type translator.
/PRINTALL N Whether the printer interprets special characters or prints their 8-bit J binary equivalent is controlled by the current data type translator.
/TRUNCATE K Truncation of data that exceeds the limitation imposed by the /WIDTH N qualifier is controlled by the form definition or the current data type translator.
/WIDTH E The number of characters allowed on each line of the currently M installed media is controlled by the form definition, or a combination ? of the current data type translator and the current font.
/WRAP G Generation of a carriage-return/line-feed by the printer when it L reaches the end of a line is controlled by the form definition or the # current data type translator.

**Table A-2 SET PRINTER Qualifier Equivalents for DECprint Supervisor Queues**
SET PRINTER Qualifier	Equivalent Control
/CR	K Insertion of carriage return characters is controlled by the current data type translator.
/FALLBACK	K Translation of DIGITAL multinational characters is controlled by the K current font. If the character does not exist in the specified font, & the font error character prints.
/FF	D Mechanical form feeds are controlled by the current data type / translator or the PostScript interpreter.
/LOWERCASE	R The DECprint Supervisor printer is considered to be a lowercase printer. It 0 does not translate lowercase to uppercase.
/PAGE	I The number of lines printed on each page is controlled by the ANSI M translator (ANSI files only). This characteristic is available through DEFINE /FORM.
/PASSALL	K Whether the system interprets special characters or forwards them as J 8-bit binary data is controlled by the current data type translator.
/PRINTALL	N Whether the printer interprets special characters or prints their 8-bit J binary equivalent is controlled by the current data type translator.
/TRUNCATE	K Truncation of data that exceeds the limitation imposed by the /WIDTH N qualifier is controlled by the form definition or the current data type translator.
/WIDTH	E The number of characters allowed on each line of the currently M installed media is controlled by the form definition, or a combination ? of the current data type translator and the current font.
/WRAP	G Generation of a carriage-return/line-feed by the printer when it L reaches the end of a line is controlled by the form definition or the # current data type translator.

Note

GNot all data type translators implement the preceding functions in the @same manner; refer to a translator's documentation for specific 'information about its behavior.

Appendix B
Logical Names Used by DCPS

DThis appendix provides some information about OpenVMS logical names >that are used by the DECprint Supervisor for OpenVMS software.

7Here are some guidelines for using these logical names:

Any logical whose name begins with "DCPS" is only used I by the DECprint Supervisor software. Other logical names (for example, C PSM$ANNOUNCE) may be used by and impact other components of your OpenVMS system.I
You should place your desired definitions for these logical names C in DCPS$STARTUP.COM or in something that it invokes. The startup D procedure template has comments about how to define some of these.E
Changes to some logical names have an immediate effect, while H changes to others take effect only when a queue starts or when a DCPS C symbiont process is first created. The ramifications of this are H particularly significant if you are using multistreamed DCPS symbiont ~ processes (see Section 3.5.1.2). You should assume that the symbiont H reads all logical names only when it is first created, thus requiring H you to first stop all queues and then retart them before your changes can take effect.J
You should define the desired logical names in the system table in A executive mode (that is, using DEFINE /EXECUTIVE_MODE /SYSTEM).H
In an OpenVMS Cluster environment, you should define the desired H logical names on all nodes that utilize the DCPS software. To examine G logical names defined by DCPS, you need to look on the node on which ' the DCPS symbiont process is running.b
Additional logical names may be listed in the Release NotesRelease Notes.

yTable B-1 lists the logical names used by DCPS, their acceptable Avalues and a brief explanation of what they mean. There are also Greferences to other sections of this document or other documents where 6you can find more information about the logical names.

Note

wIn the Table B-1, qn is an abbreviation for the queue name.

b ' , 2 T U
Table B-1 DCPS Logical Names
Logical Name Acceptable Values Meanings and References
Logical names that provide information to DCPS
DCPS_LIB ¹ search list } List of DCPS setup libraries and their data types; Section 7.4.2
DCPS$DEFAULT_TRANSLATOR <set of translators> ² h System wide default text data type; Section 4.2.2
DCPS$$ qn_DEFAULT_TRANSLATOR <set of translators> ² k Queue specific default text data type; Section 4.2.2
DCPS$DEVCTL_CACHE TRUE l Enable system wide device control caching; Section 7.11
DCPS$ qn_DEVCTL_CACHE TRUE p Enable queue specific device control caching; Section 7.11
DCPS$qn_DEVICE_NAME ³ string N Actual device name associated with the queue when name is too long for C INITIALIZE /QUEUE /ON qualifier (and SHOW QUEUE /FULL lists w "DCPS$" as the device instead); Section 3.3.2
DCPS$IGNORE_UNKNOWN_USER TRUE N Disable unknown user error system wide when username not found in UAF; M Section 3.5.9
DCPS$% qn_IGNORE_UNKNOWN_USER TRUE N Disable unknown user error for a queue when username not found in UAF; M Section 3.5.9
DCPS$% qn_INTERRUPT_WHEN_BUSY TRUE D Disable wait for serial printers to be "not busy"; R Section 3.5.2
DCPS$LAYUP ⁴ search list w Directory where layup files are stored; Software Installation GuideSoftware Installation Guide
DCPS$MAX_STREAMS 0..32 o Number of queues per DCPS symbiont process; Section 3.5.1
DCPS$ qn_NO_SYNC TRUE H Disable usual synchronization on printers other than PrintServer O printers; Section 3.5.3
DCPS$% qn_OLD_ANSI_PAGE_SIZES TRUE L Use old (pre-V1.1A) vertical spacing for A4 size in ANSI translator; S Section 3.5.10
DCPS$qn_PARAMETER ³ string o Default queue parameters; Section 3.3.4
DCPS$ qn_PRODUCT_NAME string „ Product name to use for the printer on an LPD queue; Section 3.5.7
DCPS$PURGE_TIME delta time x Time to wait before purging working set; Section 3.5.4
DCPS$ qn_SEPARATOR_TRAY number ~ Tray number to take job burst and flag pages from; Section 6.2.3
DCPS$SHEET_SIZE string ~ Sheet size to use as default for all LPD queues; Section 3.5.6
DCPS$ qn_SHEET_SIZE string E Sheet size to use as default for the printer on an LPD queue; M Section 3.5.6
DCPS$SPOOL string o Enable spooling for all LPD queues; Section 3.5.5
DCPS$ qn_SPOOL string m Enable spooling for an LPD queue; Section 3.5.5
DCPS$SPOOL_DIRECTORY string z Directory used to store temporary spool files; Section 3.5.5
DCPS$ qn_STALL_TIME delta time s Timeout before declaring a printer stalled; Section 5.12
DCPS$% qn_SUPPRESS_JOBTRAILER TRUE t Disable printing of job trailer; Section 6.2.2
DCPS$SUPPRESS_PJL_MESSAGES TRUE O Suppress unsolicited PJL messages received from printers on all queues; K Section 3.5.8
DCPS$' qn_SUPPRESS_PJL_MESSAGES TRUE M Suppress unsolicited PJL messages received from printer on one queue; K Section 3.5.8
PSM$ANNOUNCE string z String which prints on separator pages; Section 6.4
Logical names that return information from DCPS
DCPS$ qn_PID w Process ID of DCPS symbiont controlling the queue; Section 5.8
DCPS$ qn_STALLED g Reason for queue being stalled; Section 5.12
DCPS$VERSION s DCPS software version running on the system; DCPS Version

**Table B-1 DCPS Logical Names**
Logical Name	Acceptable Values	Meanings and References
Logical names that provide information to DCPS
DCPS_LIB ¹	search list	} List of DCPS setup libraries and their data types; Section 7.4.2
DCPS$DEFAULT_TRANSLATOR	<set of translators> ²	h System wide default text data type; Section 4.2.2
DCPS$$ qn_DEFAULT_TRANSLATOR	<set of translators> ²	k Queue specific default text data type; Section 4.2.2
DCPS$DEVCTL_CACHE	TRUE	l Enable system wide device control caching; Section 7.11
DCPS$ qn_DEVCTL_CACHE	TRUE	p Enable queue specific device control caching; Section 7.11
DCPS$qn_DEVICE_NAME ³	string	N Actual device name associated with the queue when name is too long for C INITIALIZE /QUEUE /ON qualifier (and SHOW QUEUE /FULL lists w "DCPS$" as the device instead); Section 3.3.2
DCPS$IGNORE_UNKNOWN_USER	TRUE	N Disable unknown user error system wide when username not found in UAF; M Section 3.5.9
DCPS$% qn_IGNORE_UNKNOWN_USER	TRUE	N Disable unknown user error for a queue when username not found in UAF; M Section 3.5.9
DCPS$% qn_INTERRUPT_WHEN_BUSY	TRUE	D Disable wait for serial printers to be "not busy"; R Section 3.5.2
DCPS$LAYUP ⁴	search list	w Directory where layup files are stored; Software Installation GuideSoftware Installation Guide
DCPS$MAX_STREAMS	0..32	o Number of queues per DCPS symbiont process; Section 3.5.1
DCPS$ qn_NO_SYNC	TRUE	H Disable usual synchronization on printers other than PrintServer O printers; Section 3.5.3
DCPS$% qn_OLD_ANSI_PAGE_SIZES	TRUE	L Use old (pre-V1.1A) vertical spacing for A4 size in ANSI translator; S Section 3.5.10
DCPS$qn_PARAMETER ³	string	o Default queue parameters; Section 3.3.4
DCPS$ qn_PRODUCT_NAME	string	„ Product name to use for the printer on an LPD queue; Section 3.5.7
DCPS$PURGE_TIME	delta time	x Time to wait before purging working set; Section 3.5.4
DCPS$ qn_SEPARATOR_TRAY	number	~ Tray number to take job burst and flag pages from; Section 6.2.3
DCPS$SHEET_SIZE	string	~ Sheet size to use as default for all LPD queues; Section 3.5.6
DCPS$ qn_SHEET_SIZE	string	E Sheet size to use as default for the printer on an LPD queue; M Section 3.5.6
DCPS$SPOOL	string	o Enable spooling for all LPD queues; Section 3.5.5
DCPS$ qn_SPOOL	string	m Enable spooling for an LPD queue; Section 3.5.5
DCPS$SPOOL_DIRECTORY	string	z Directory used to store temporary spool files; Section 3.5.5
DCPS$ qn_STALL_TIME	delta time	s Timeout before declaring a printer stalled; Section 5.12
DCPS$% qn_SUPPRESS_JOBTRAILER	TRUE	t Disable printing of job trailer; Section 6.2.2
DCPS$SUPPRESS_PJL_MESSAGES	TRUE	O Suppress unsolicited PJL messages received from printers on all queues; K Section 3.5.8
DCPS$' qn_SUPPRESS_PJL_MESSAGES	TRUE	M Suppress unsolicited PJL messages received from printer on one queue; K Section 3.5.8
PSM$ANNOUNCE	string	z String which prints on separator pages; Section 6.4
Logical names that return information from DCPS
DCPS$ qn_PID		w Process ID of DCPS symbiont controlling the queue; Section 5.8
DCPS$ qn_STALLED		g Reason for queue being stalled; Section 5.12
DCPS$VERSION		s DCPS software version running on the system; DCPS Version

E²<set of translators> = ANSI, AUTOMATIC, LIST, PCL, POSTSCRIPT, REGIS, TEK4014, etc.
@¹Defined with a default value in the DCPS$STARTUP.COM
H⁴Defined by DCPS$REQUIRED.COM using information you supplied during the DCPS installation
/³Defined by DCPS$EXECUTION_QUEUE.COM

z a d f

Contents

Index

HP DECprint Supervisor (DCPS) for OpenVMSSystem Manager's Guide

11.6 What to Do if Layup Definition Files Are Not Found

11.7 What to Do if Files Are Printed with Unexpected Results

11.7.1 What to Do if Default Queue Parameters Are Not Effective

11.7.2 What to Do if a File Data Type Is Not Recognized

Appendix APrinting System Management Commands

A.1 Overview of Management Commands

A.2 Use of SET PRINTER with DCPS

Appendix BLogical Names Used by DCPS

HP DECprint Supervisor (DCPS) for OpenVMS
System Manager's Guide

Appendix A
Printing System Management Commands

Appendix B
Logical Names Used by DCPS