l8HP DECprint Supervisor (DCPS) for OpenVMSG

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



 z d f  
PreviousContentsIndex



EIf the error occurs during the printing of a PostScript file, either Ethe PostScript file or the application that generated the PostScript Gfile is in error. If the application is supplied by HP, contact the HP 4Customer Support Center and submit a problem report.

HUNSUP_DEF_AUTOTYPE, data-type is not supported as an AUTOMATIC "data type, assuming AUTOMATIC=ANSI
HExplanation: The default text data type defined by the DDCPS$[queue-name_]DEFAULT_TRANSLATOR logical name is not a <legal value. The legal values are ANSI, PROPRINTER, and PCL.
CUser Action: The system manager must redefine the logical name.

AUNSUP_DEFTRANS, data-type is not supported as a Default Translator, ANSI will be used.
;Explanation: The data type assumed by the MDECprint Supervisor software as the default text data type is not valid. The DDECprint Supervisor software will use ANSI as the default data type.
DUser Action: The system manager should correct the "specification of the logical name ADCPS$[queue-name]_DEFAULT_TRANSLATOR. The queue must be Bstopped (STOP /QUEUE /RESET) and started (START /QUEUE) for a new definition to take effect.

AUNSUPTAG, File tagged as data_syntax will not be printed
7Explanation: The file contains a DDIF <stored_semantics tag that is not supported.
GUser Action: You cannot print this type of file using !the DECprint Supervisor software.

?UNSUP_USER_AUTOTYPE, data-type is not supported as an ,AUTOMATIC data type, assuming AUTOMATIC=ANSI
GExplanation: The user's PRINT command, or the default Dqueue parameter in the DCPS$STARTUP.COM command file, specifies the GDATA_TYPE=AUTOMATIC=default-text-data-type parameter using an Dillegal value for default-text-data-type. Legal values are ANSI, PROPRINTER, and PCL.
CUser Action: If the error was in a PRINT command, <resubmit the print job with one of the legal values for the DATA_TYPE=AUTOMATIC parameter.

?If the error is in the queue definition, perform the following operations:



USERDATA, string
HExplanation: The PostScript program requested that the Bdata represented by string be sent to the user, with the ;operators print, pstack, ,=, and ==.
#User Action: None.

DVMERROR, vmerror: PostScript virtual memory exhausted --- offending command is string
CExplanation: The PostScript interpreter sensed an Derror while trying to execute the PostScript command represented by string.
GUser Action: If this error occurs during the printing Eof a file with a data type other than PostScript, an error exists in Ethe translation process. If the translator is supplied by HP, report /this problem to the HP Customer Support Center.

=If your print job fails to print because of a virtual memory 6limitation, you can take one of the following actions:



AZEROAREA, Layup definition margins result in no usable sheet area
FExplanation: You included a layup definition file in Ayour print job that sets margins that leave no area for printing.
uUser Action: See Chapter 11 for information on the *MARGINS option in a layup definition file.i

A.3 Layup Definition (BADLAYDEF) Messages



GThis section describes the layup definition error messages you receive Ewith the message identification BADLAYDEF. Messages are displayed in the following format:

F%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 occurred.

@The following error messages are generated by errors in a layup 7definition file and reported as the condition.



/  
Note

ALine numbers reported in the BADLAYDEF message may not always be Ecorrect for some Record Management Service (RMS) file organizations. 


Bad form for margin values
EExplanation: The value given for the MARGINS option $cannot be understood by that option.

Bad form for page grid values
CExplanation: The values given for the GRID option $cannot be understood by that option.

6Cannot give values with negated option option
HExplanation: A line contains both a negated option and 'a value, for example, NOALTERNATE=LEFT.

$Cannot negate option option
GExplanation: An option that should not be negative is given as a negative value.

)Cannot supply a value for option
BExplanation: A value is given for an option that cannot take a value.

"Could not find a number as a value
FExplanation: The value given for an option cannot be understood by that option.

%Extra characters present after values
BExplanation: Legitimate values for an option are followed by extra characters.

/Must express a value for option option
CExplanation: No value is given for an option that requires a value.

No option present
HExplanation: A line is not blank, but it also does not contain an option.

.No values specified for option option
CExplanation: A line contains an equal sign but no value.

Number must be greater than 1
GExplanation: The numeric values for an option are out 'of range, for example, PAGESPERSHEET=0.

Page count must be less than 100
AExplanation: The GRID option must have positive :values. The product of the two values must be 100 or less.

%Unrecognized keyword keyword
FExplanation: The value given for a keyword cannot be understood.

#Unrecognized option option
CExplanation: A line does not contain a recognized option.


G

Appendix B
PRINT Command Qualifiers




IWith the DECprint Supervisor, you can print files on PostScript printers Busing the OpenVMS PRINT command. The PRINT command qualifiers are Jdocumented in this appendix and in the HP OpenVMS DCL Dictionary.

sTable B-1 lists the PRINT command qualifiers and describes the functions of the qualifiers.

CSeveral qualifiers apply only to print jobs for ANSI files; if you Csupply this type of qualifier on a PRINT command line for printing Enon-ANSI files, the qualifier is ignored and the file is printed.

d  $ &                                                                                                                                                          
Table B-1 PRINT Command Qualifiers
Qualifier Description
 /[NO]AFTER L Indicates the print job will be held in the queue until the specified time.
 /[NO]BACKUP J Selects files for printing based on their last backup date and time.
 /[NO]BEFORE L Specifies a date and time for the file selection qualifiers (/BACKUP, L /CREATED, /EXPIRED, or /MODIFIED) and selects files with dates before " the specified date and time.
 /[NO]BURST Controls file burst pages.
 /[NO]BY_OWNER I Selects files to print based on the user identification code (UIC).
 /CHARACTERISTICS : Specifies printer characteristics for the print job.
 /[NO]CONFIRM 1 Prompts you for each file in the print job.
/COPIES : Specifies the number of copies of the file to print.
 /[NO]CREATED J Selects files for printing based on the file creation date and time.
 /[NO]DELETE I Deletes the print files automatically after the print job has been  processed.
 /[NO]EXCLUDE 0 Excludes a file or files from a print job.
 /[NO]EXPIRED L Selects files for printing based on the file expiration date and time.
 /[NO]FEED M Controls whether form feed characters are inserted at the end of pages.
 /[NO]FLAG  Controls file flag pages.
/FORM I Specifies a form type whose characteristics will be applied to the  print job.
 /[NO]HEADER ; Prints a header line at the top of each printed page.
 /[NO]HOLD M Holds the print job until specifically released with SET ENTRY/RELEASE.
 /[NO]IDENTIFY N Displays the print queue and print job number on your terminal when the  print job is submitted.
 /JOB_COUNT 5 Specifies the number of times to print the job.
 /[NO]LOWERCASE I Specifies printing on a printer with lowercase printing capability.
 /[NO]MODIFIED N Selects files for printing based on the date and time the file was last  modified.
/NAME ! Specifies a print job name.
/NOTE ; Specifies a message to print on job separation pages.
 /[NO]NOTIFY M Sends messages to your terminal when the print job starts and ends and when printer errors occur.
 /OPERATOR H Sends the specified message to the operator when the print job is  started.
/PAGES ; Specifies a range of pages in the print job to print.
 /PARAMETERS K Specifies one or more PRINT parameters for controlling the print job.
 /[NO]PASSALL K Specifies whether to bypass DECprint Supervisor formatting of output.
 /PRIORITY - Specifies a priority for the print job.
/QUEUE 2 Specifies the print queue for the print job.
/REMOTE : Creates a print job on a remote node in the network.
 /[NO]RESTART J Enables the print job to be restarted after it has been interrupted.
/RETAIN G Specifies the circumstances under which you want your jobs to be  retained in a queue.
/SETUP D Specifies a setup module to control printing of the print job.
/SINCE L Specifies a date and time for the file selection qualifiers (/BACKUP, K /CREATED, /EXPIRED, or /MODIFIED) and selects files with dates after " the specified date and time.
 /[NO]SPACE $ Controls double-spaced output.
 /[NO]TRAILER " Controls file trailer pages.
/USER 0 Specifies the user name for the print job.


@Each qualifier is described in more detail with examples on the following pages.



/AFTER=time



/NOAFTER (default)

DSpecifies a time at which the print job should be released from the Bqueue and printed. Without this qualifier, a print job is printed 6immediately or as soon as a printer becomes available.

EFor example, the following print job will be started after 6:00 p.m.:

 

"
2    $ PRINT /AFTER=18:00 FARM.DAT




/BACKUP



/NOBACKUP (default)

BSelects files to print based on the time that the files were last Fbacked up. Use this qualifier with the /BEFORE or /SINCE qualifier to Gspecify the backup time. Other file selection qualifiers are /CREATED, G/EXPIRED, and /MODIFIED. If /BEFORE or /SINCE is used without any file 4selection qualifier, the file creation time is used.

CFor example, the following print job includes only the files named 0GROTON that were backed up before June 20, 2005:

 

"
A    $ PRINT /BACKUP /BEFORE=20-JUN-2005 GROTON.*




/BEFORE=time



/NOBEFORE (default)

GPrints files dated before the specified time of file creation, backup, Gexpiration, or modification. You can enter a keyword (TODAY, TOMORROW, Dor YESTERDAY) instead of a time. Use this qualifier with one of the 7following qualifiers to change the file selection mode:                
/BACKUP ? Selects files based on the time they were last backed up.
 /CREATED M Selects files based on the file creation time. (This is the default if / no file selection qualifier is included.)
 /EXPIRED 6 Selects files based on the file expiration time.
 /MODIFIED A Selects files based on the time the file was last modified.


DIf you omit the /BEFORE qualifier, the specified files are printed, Gregardless of file creation, backup, modification, or expiration times.

DFor example, to print only the files named GROTON that were created 0before June 23, 2005, use the following command:

 

"
B    $ PRINT /CREATED /BEFORE=23-JUN-2005 GROTON.*


"

/BURST[=keyword]



/NOBURST (default)

FSpecifies file burst pages printed before each copy of each file. The Bkeyword ALL prints a burst page before each file; the keyword ONE Eprints a burst page before the first file in the job. This qualifier vdoes not affect job burst pages. Refer to the System Manager's GuideSystem Manager's Guide for more 'information about job separation pages.

FFor example, to include a burst page before GROTON.DAT but not before $FARM.DAT, use the following command:

 

"
7    $ PRINT GROTON.DAT /BURST FARM.DAT




/BY_OWNER=uic



/NOBY_OWNER (default)

EPrints only files with the specified UIC (user identification code). ;The default action is to print files regardless of the UIC.

AFor example, to print the files named FARM.DAT that have the UIC '[MACDONALD], use the following command:

 

"
;    $ PRINT /BY_OWNER=[MACDONALD] FARM.DAT


1

/CHARACTERISTICS=characteristic

CPrints files on a printer that has been defined with the specified =characteristics. Use the SHOW QUEUE/FULL command to list the $characteristics for the print queue.

BFor example, to print FARM.DAT on a printer with a characteristic -defined as REDINK, use the following command:

 

"
=    $ PRINT /CHARACTERISTICS=REDINK FARM.DAT




/CONFIRM



/NOCONFIRM (default)

FSends a confirmation prompt for each file, to which you can reply Yes Hor No to allow or disallow printing of that file. If you do not include Hthis qualifier, you receive no prompts to confirm printing of each file in the request.

CFor example, to print files named GROTON with confirmation of each file, use the following command:

 

"
-    $ PRINT/CONFIRM GROTON.*@    PRINT DISK:[MACDONALD]GROTON.TXT.3 ? [NO] Y




/COPIES=n

EAllows you to request multiple copies of a file. If you include this >qualifier before the file specification, each file is printed Hn times. To obtain copies of a single file in a print job with Emultiple files, include this qualifier after the file specification. HThe default action if you do not include this qualifier is to print one copy of each file.

FFor example, to print two copies each of FARM.DAT and GROTON.DAT, use the following command:

 

"
:    $ PRINT /COPIES=2 FARM.DAT,GROTON.DAT




KWhen you use the /COPIES qualifier in a print job for DECprint Supervisor, ?the software must translate your file and transmit the file in ?PostScript form for each copy of the file that you request, if @translation is required. This process increases the load on the 1computer system and can slow down your print job.

FIf you encounter problems when printing multiple copies of the files, Duse the /JOB_COUNT qualifier or separate PRINT commands to create a $print job for each copy of the file.

/CREATED



/NOCREATED (default)

ASelects files to print based on the file creation time. Use this Dqualifier with the /BEFORE or /SINCE qualifier to specify the time. FOther file selection qualifiers are /BACKUP, /EXPIRED, and /MODIFIED. GIf /BEFORE or /SINCE is used without any file selection qualifier, the file creation time is used.

HFor example, to print only the files named FARM that were created after (June 4, 2005, use the following command:

 

"
>    $ PRINT /CREATED /AFTER=4-JUN-2005 FARM.*




/DELETE



/NODELETE (default)

HDetermines whether the system deletes the print file after printing. If 9you omit this qualifier, the default action is /NODELETE.

EFor example, to delete the file FARM.DAT after printing, use the the following command:

 

"
-    $ PRINT /DELETE FARM.DAT






/  
CAUTION

NWhen you specify the /DELETE qualifier with the DECprint Supervisor software, Ethe job controller always deletes the requested files, regardless of 1whether the print job was completed successfully.

EFor example, the following print job is not printed because the user Fentered an invalid SHEET_SIZE parameter (GREEN). Although the file is 1not printed, the job controller deletes the file.

 

"
N    $ PRINT /DELETE /PARAMETERS=(SHEET_SIZE=GREEN) GROTON.TXT




2Use the /DELETE qualifier with discretion.

$

/EXCLUDE=file-spec



/NOEXCLUDE (default)

DSpecifies files to be excluded from the print job (not printed with Dothers that match the file specification). This qualifier is useful Fwhen wildcards are used in the file specification. The default action Gwhen you omit this qualifier is to print all files that match the file specification.

EFor example, to print all the files named FARM, except FARM.DAT, use the following command:

 

"
5    $ PRINT /EXCLUDE=FARM.DAT FARM.*




/EXPIRED



/NOEXPIRED (default)

CSelects files to print based on the file expiration time. Use this Dqualifier with the /BEFORE or /SINCE qualifier to specify the time. FOther file selection qualifiers are /BACKUP, /CREATED, and /MODIFIED. GIf /BEFORE or /SINCE is used without any file selection qualifier, the file creation time is used.

BFor example, to print files named GROTON that are dated to expire 3before January 10, 2000, use the following command:

 

"
B    $ PRINT /EXPIRED /BEFORE=10-JAN-2000 GROTON.*




/FEED



/NOFEED (default)

HControls whether form feed characters are inserted into the data stream Gwhen the bottom margin is reached. Use /NOFEED to specify no insertion Hof form feed characters into the print job. If you omit this qualifier, the default action is /FEED.

EFor example, to print FARM.DAT with form feed characters inserted at 3the bottom of each page, use the following command:

 

"
+    $ PRINT /FEED FARM.DAT


!

/FLAG[=keyword]



/NOFLAG (default)

FControls printing of a file flag page preceding the file. The keyword GALL prints a file flag page before each copy of each file in the print Fjob; the keyword ONE prints a file flag page before the first file in Gthe print job. When you omit this qualifier, the default action is the Gaction determined by the system manager for the queue. (This qualifier udoes not affect job flag pages. Refer to the System Manager's GuideSystem Manager's Guide for more (information about job separation pages.)

EFor example, to print a flag page before each file in the print job, use the following command:

 

"
:    $ PRINT /FLAG=ALL FARM.DAT,GROTON.DAT


!

/FORM=form-name

ESpecifies that your print job requires a form with a specific set of sform characteristics, as described in Chapter 12. You can specify =only form names that have been defined by the system manager.

FIf the stock type required for the form is not mounted, the print job Fis placed in a pending state and is released when the printer has the required stock type loaded.

FFor example, to print GROTON.RPT with form type SHORT$REPORT, use the following command:

 

"
:    $ PRINT /FORM=SHORT$REPORT GROTON.RPT




/HEADER



/NOHEADER (default)

EPrints a header line, with file name, page number, and file creation date, at every page break.

GThe header information is not inserted automatically; you must specify E/HEADER to obtain header lines in the output. You can disable header -line insertion using the /NOHEADER qualifier.

DFor example, to print FARM.DAT with header lines, use the following command:

 

"
-    $ PRINT /HEADER FARM.DAT




/HOLD



/NOHOLD (default)

DSpecifies whether the print job should begin immediately or be held Huntil a SET ENTRY/RELEASE command releases the job for printing. If you =omit this qualifier, the print job is not held automatically.

ETo hold a print job until the SET ENTRY/RELEASE command releases the job, use the following command:

 

"
+    $ PRINT /HOLD FARM.DAT




/IDENTIFY (default)



/NOIDENTIFY/

CSpecifies whether to display the print queue and print job's entry Enumber when the print job is queued. /IDENTIFY is the default action.

FFor example, to suppress the display of the print queue and print job ?entry number when printing FARM.DAT, use the following command:

 

"
1    $ PRINT /NOIDENTIFY FARM.DAT




/JOB_COUNT=n

GPrints the job n times. The value of n is 1--255. If Gyou omit this qualifier, one copy of the print job is printed. You can Huse the /COPIES qualifier to specify multiple copies of a specific file in the multiple-file print job.

GFor example, to print FARM.DAT followed by GROTON.DAT three times, use the following command:

 

"
=    $ PRINT /JOB_COUNT=3 FARM.DAT,GROTON.DAT




HWhen you use /JOB_COUNT in a print job for the DECprint Supervisor, the Fsoftware must translate your file and transmit the file in PostScript Cform for each copy of the file that you request, if translation is Erequired. This process increases the load on the computer system and can slow down your print job.

/LOWERCASE



/NOLOWERCASE (default)

?Specifies that the print job requires lowercase printing. This Fqualifier does not apply to PostScript printers. If you include it in Cyour print request, this qualifier is ignored and the print job is printed.

/MODIFIED



/NOMODIFIED (default)

?Selects files for printing based on the time the file was last Emodified. Use this qualifier with the /BEFORE or /SINCE qualifier to ?specify the time. Other file selection qualifiers are /BACKUP, F/CREATED, and /EXPIRED. If /BEFORE or /SINCE is used without any file 4selection qualifier, the file creation time is used.

DFor example, to print all the files named GROTON that were modified /after June 19, 2005, use the following command:

 

"
B    $ PRINT /MODIFIED /AFTER=19-JUN-2005 GROTON.*



/NAME=job-name

GSpecifies the print job's name, which is printed on the job separation Fpages. The job name can contain up to 39 alphanumeric characters. The @default job name is the name of the first file in the print job.




 z a d f  
PreviousNextContentsIndex