l8HP DECprint Supervisor (DCPS) for OpenVMSG

HP DECprint Supervisor (DCPS) for OpenVMS
User's Guide


 z d f  
PreviousContentsIndex

g

11.3 Layup Error Notification



FErrors in layup definition files are returned with the identification CBADLAYDEF. To display the error messages on your terminal, use the D/NOTIFY qualifier in the PRINT command line. To print or keep error Gmessages, use the MESSAGES parameter to the PRINT /PARAMETERS command. (Error messages use the following format:

 

" 
[    %DCPS-W-BADLAYDEF, condition on line line-number in layup definition 



FThe condition describes the problem and line-number Cis the line number in the layup definition file on which the error soccurred. See Section A.3 for the text and explanation of the 8messages generated by errors in a layup definition file.

Q

Chapter 12
Using Forms in Your PRINT Command



FThe system manager can create form definitions, which you can include Ein your PRINT command to modify the appearance of your printed file. BWhen you specify an unknown form, DECprint Supervisor informs you Cimmediately. If you specify an unknown setup module to modify your Mfile, DECprint Supervisor does not inform you of the problem until it starts 6printing the job and needs to access the setup module.

hExample 12-1 shows a PRINT command that includes a form called LANDSCAPE.

 G  
Example 12-1 Including a Form in a PRINT  Command
 

" 
9    $ PRINT /QUEUE=LPS20 /FORM=LANDSCAPE



0The following sections explain how to use forms.X

12.1 Finding Forms on Your System



FTo find the forms available for your use, issue the following command:

 

" 
'    $ SHOW QUEUE /FORM



1A list of forms and their functions is displayed:

 

" 
>    Form name                            Number   Description >    ---------                            ------   ----------- I    PITCH12 (stock=DEFAULT)                 122   12 Characters per Inch K    PITCH13 (stock=DEFAULT)                 121   13.2 Characters per Inch K    PITCH16 (stock=DEFAULT)                 120   16.5 Characters per Inch H    PITCH6 (stock=DEFAULT)                  125   6 Characters per Inch J    PITCH660 (stock=DEFAULT)                124   6.6 Characters per Inch K    PITCH8 (stock=DEFAULT)                  123   8.25 Characters per Inch F    PORTRAIT (stock=DEFAULT)                 20   80 by 60 (portrait) B    PS (stock=LASER)                       2001   Postscript Form 



DYou can display the attributes of a form using the SHOW QUEUE /FORM C/FULL command. For example this command displays the attributes of DCPS$DEFAULT:

 

" 
:    $ SHOW QUEUE /FORM /FULL DCPS$DEFAULT



 

" 
>    Form name                            Number   Description >    ---------                            ------   ----------- ?    DCPS$DEFAULT (stock=DEFAULT)           1115   DCPS default 6        /LENGTH=66 /STOCK=DEFAULT /TRUNCATE /WIDTH=80 



DThis form sets the page length and width, truncates long lines, and uses a default paper stock.V

12.2 Using Forms with ANSI Files



DMost of the time, you use form definitions with ANSI files, because Fmany of the qualifiers for form definitions apply only to ANSI files. DThe qualifiers allow you to specify the page length and margins and Dallow long lines to either truncate or wrap to the next line. Files @with data types besides ANSI, such as PostScript, have internal ,controls that set up your page's attributes.

iTable 12-1 shows the qualifiers that affect only ANSI files.

i  - 1                          
Table 12-1 DEFINE / FORM Qualifiers for ANSI Files
This Qualifier ... Does the Following ...
 /LENGTH= n . Sets the length of each page, in lines.
 /MARGIN= keyword= n  Sets the page margins.
 /PAGE_SETUP= module ; Applies a page setup module to each page in the job.
 /[NO]TRUNCATE > Truncates long lines that do not fit in the page width.
 /WIDTH= n ; Sets the width of the page in columns or characters.
 /[NO]WRAP 8 Wraps lines wider than the page to the next line.




/  
Note
FThese form definitions are useful only with ANSI files, because other Ctypes of files have internal controls for these attributes.
a

12.3 Using Forms with All Types of Files



HThere are two qualifiers that the system manager can use with all types Gof files: /SETUP and /STOCK. The following sections explain what those qualifiers do.T

12.3.1 Using Forms that Invoke Setup Modules (/SETUP)



HYour system manager can associate a setup module with a form. To see if Fa setup module has been included in a form definition, issue the SHOW CQUEUE /FORM /FULL command and look for the /SETUP qualifier in the 'descriptions of the forms. For example:

 

" 
-    $ SHOW QUEUE /FORM /FULL



 

" 
>    Form name                            Number   Description >    ---------                            ------   ----------- F    CONFIDENTIAL (stock=DEFAULT)           15     Prints CONFIDENTIAL F       /LENGTH=66 /SETUP=(PRIVATE) /STOCK=DEFAULT /TRUNCATE /WIDTH=80 



DIn this example, the setup module called PRIVATE is included in the form definition.U

12.3.2 Using Forms that Specify the Paper Stock (/STOCK)



FYour system manager can use the /STOCK qualifier to specify a type of Hpaper that must be used when a form is invoked. When you use that form, @you must ensure that the the specified stock is in the printer. EOtherwise, the job is held in the queue until you load the specified )stock or use a different form definition.

DTo see if a form requires special stock, issue the SHOW QUEUE /FORM F/FULL command and look for the /STOCK qualifier in the description of the form. For example:

 

" 
7    $ SHOW QUEUE /FORM /FULL LANDSCAPE



 

" 
>    Form name                            Number   Description >    ---------                            ------   ----------- H    LANDSCAPE (stock=DEFAULT)                10   132 by 66 (landscape) N        /LENGTH=66 /MARGIN=(TOP=2,BOTTOM=4) /SETUP=(LANDSCAPE) /STOCK=DEFAULT         /TRUNCATE /WIDTH=132 



HIf the /STOCK qualifier has the DEFAULT parameter, any type of paper is allowed._

12.4 Using the Default Form Definition



FIf you omit a form definition in your print request but supply one of Fthe following qualifiers, the default form definition DCPS$DEFAULT is -automatically associated with your ANSI file:



ATo find the attributes of the default form definition, issue the following command:

 

" 
:    $ SHOW QUEUE /FORM /FULL DCPS$DEFAULT



 

" 
>    Form name                            Number   Description >    ---------                            ------   ----------- ?    DCPS$DEFAULT (stock=DEFAULT)           1115   DCPS default 6        /LENGTH=66 /STOCK=DEFAULT /TRUNCATE /WIDTH=80 



Z

Chapter 13
Using Setup Modules in Print Jobs



EThis chapter contains general information about using setup modules, @and information about setup modules that can be used by several mprinters. See Chapter 18 for information about printer-specific modules.

GYou can also use setup modules implicitly through the use of forms, as Idescribed in Chapter 12.Z

13.1 What Is a Setup Module?



AA setup module is a file containing instructions that modify the Happearance of a print job or redefine the instructions in the print job.

FTo include a setup module in a print job, use the /SETUP qualifier in Bthe PRINT command. The following example uses a setup module that -specifies 600 dots-per-inch (DPI) resolution:

 

" 
L    $ PRINT /QUEUE=LPS32$2SIDES /SETUP=RES_600X600 IMAGE.PS

\

13.2 Locating Setup Modules



<DCPS ships with various setup modules, which are located in %the following device control library:

SYS$LIBRARY:DCPS$DEVCTL.TLB

5To list the setup modules, use the following command:

 

" 
B    $ LIBRARY /LIST /TEXT SYS$LIBRARY:DCPS$DEVCTL



HA list of setup modules, similar to the following example, is displayed:

 

" 
    DCW1000_DISPLAY     DCW1000_ENHANCED     DCW1000_HIGHRES     LPS$$APPLE360_INITPSDEVICE     LPS$$APPLE360_SETINPUTTRAY     RES_1200X1200     RES_1200X600 





/  
Note
FDo not modify any of the setup modules or the device control library. 


FSome setup modules are created only for certain printers. Those setup Hmodules have the printer name as part of their file name. For instance, Cthe setup module DL3500_RET_DARK is intended for the DEClaser 3500 printer.

wSee Section 13.4 and later sections for descriptions of some of the setup modules.D

13.2.1 Locating Custom Setup Modules



GCustom setup modules go in special device control libraries, which are Erequired to be .TLB (text library) files located in SYS$LIBRARY. The Efollowing command lists all of the text libraries in SYS$LIBRARY. To Hdetermine which of these libraries are special device control libraries Eused with DCPS, check with your system manager or correlate the .TLB Gfile names with the libraries and library search lists associated with ;the /LIBRARY qualifier for your system's DCPS print queues.

 

" 
2    $ DIRECTORY SYS$LIBRARY:*.TLB

T

13.2.2 Displaying the Contents of a Setup Module



CTo see the instructions that a setup module contains, follow these steps:

    E
  1. Extract the setup module from the device control library. The I following example extracts the setup module DI_ON from DCPS$DEVCTL.TLB 5 and renames it MYSETUP.TXT in the user's directory:

     

    " 
    [    $ LIBRARY /EXTRACT=DI_ON /OUTPUT=MYSETUP /TEXT SYS$LIBRARY:DCPS$DEVCTL
        
    J

  2. Type or edit the setup module to display its contents. For example:

     

    " 
    '    $ TYPE MYSETUP.TXT
        
    F
    The setup module DI_ON enables the DECimage image enhancement 5 feature, and contains the following instructions:

     

    " 
        %! "    % ~~~~~~~~~~ DI_on ~~~~~~~~~~ +    statusdict begin false setDECimage end ?    systemdict /languagelevel known {languagelevel} {1} ifelse 2    2 ge {currentpagedevice /Install get exec} if *    statusdict begin true setDECimage end "    % ~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
        
    

    

    /  
    Note
    FSome setup modules contain escape sequences or graphics, which cannot ,be displayed when you type the file.
    
S

13.3 Creating a Setup Module



-To create a setup module, follow these steps:

    J
  1. Create a setup module that includes the necessary escape sequences  or PostScript operators.H
  2. Ask your system manager to insert the setup module into a device  control library.E
  3. Print the file, specifying the setup module and the file. For example:

     

    " 
    Q    $ PRINT /QUEUE=PS$A14 /SETUP=module-name MYFILE.DAT
        
    

s

13.4 Modifying DECimage Parameters with Setup Modules



FThe following setup modules invoke the DECimage feature or modify the DDECimage parameters. They are grouped into the following categories:



GFor example, the following command adds sharpening and shifts the gray levels:

 

" 
g    $ PRINT /NOTIFY /QUEUE=queue-name /SETUP=(DI_SHARP_2,DI_DARKER) file-name

d

13.5 Resolution Setup Modules



BYou can use the following resolution setup modules to temporarily 6change the resolution on multiple resolution printers:





/  
Note
FNot all of these setup modules are applicable to all printers.




 z a d f  
PreviousNextContentsIndex