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


Previous Contents Index

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

/CREATED

/NOCREATED (default)

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

For example, to print only the files named FARM that were created after March 4, 2001, use the following command:


$ PRINT/CREATED/AFTER=4-MAR-2001 FARM.*

/DELETE

/NODELETE (default)

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

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


$ PRINT/DELETE FARM.DAT

CAUTION

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

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


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


Use the /DELETE qualifier with discretion.

/EXCLUDE=file-spec

/NOEXCLUDE (default)

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

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


$ PRINT/EXCLUDE=FARM.DAT FARM.*

/EXPIRED

/NOEXPIRED (default)

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

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


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

/FEED

/NOFEED (default)

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

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


$ PRINT/FEED FARM.DAT

/FLAG[=keyword]

/NOFLAG (default)

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

For 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

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

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

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


$ PRINT/FORM=SHORT$REPORT GROTON.RPT

/HEADER

/NOHEADER (default)

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

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

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


$ PRINT/HEADER FARM.DAT

/HOLD

/NOHOLD (default)

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

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


$ PRINT/HOLD FARM.DAT

/IDENTIFY (default)

/NOIDENTIFY/

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

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


$ PRINT/NOIDENTIFY FARM.DAT

/JOB_COUNT=n

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

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


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

When you use /JOB_COUNT in a print job for the 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 computer system and can slow down your print job.

/LOWERCASE

/NOLOWERCASE (default)

Specifies that the print job requires lowercase printing. This qualifier does not apply to PostScript printers. If you include it in your 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 modified. Use this qualifier with the /BEFORE or /SINCE qualifier to specify the time. Other file selection qualifiers are /BACKUP, /CREATED, and /EXPIRED. If /BEFORE or /SINCE is used without any file selection qualifier, the file creation time is used.

For example, to print all the files named GROTON that were modified after March 19, 2001, use the following command:


$ PRINT/MODIFIED/AFTER=19-MAR-2001 GROTON.*

/NAME=job-name

Specifies the print job's name, which is printed on the job separation pages. 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.

For example, to print FARM.DAT with a job name AG_DATA, use the following command:


$ PRINT/NAME=AG_DATA FARM.DAT

/NOTE=string

Specifies a message string of up to 255 characters to be printed on the job separation pages.

For example, to include a distribution location on the separation pages, use the following command:


$ PRINT/NOTE="SEND TO SECOND FLOOR, BIN 7" FARM.DAT

/NOTIFY

/NONOTIFY (default)

Causes you to be notified when the job starts and finishes, and notifies you of errors that occur during the printing process and of messages returned by PostScript operators (such as print, pstack, =, and ==).

If you omit the /NOTIFY qualifier, the default action is not to display these print job messages.

For example, to ensure you are notified of print job status, use the following command:


$ PRINT/NOTIFY FARM.DAT,GROTON.DAT

If you use Distributed Queuing Service (DQS) software to queue print jobs to a remote printer, /NOTIFY returns job start and finish messages that may or may not represent the actual time of starting and ending printing. DQS suppresses the display of printer error messages and other messages from the printer on the user's terminal.

/OPERATOR=string

Specifies a message string to be sent to the operator when the print job starts. The message can contain up to 255 characters. Include quotation marks around the message string.

For example, to send the distribution location to the operator's terminal, use the following command:


$ PRINT/OPERATOR="FARM.DAT TO JONES" FARM.DAT

/PAGES=[lowlim,]uplim

Ignored by the DECprint Supervisor software. Use the PAGE_LIMIT parameter described in Section 1.7. If you include the /PAGES qualifier in a PRINT command to a PostScript printer, the qualifier is ignored and the print job is printed.

/PARAMETERS=parameter

Specifies values for the DECprint Supervisor printing features. The parameters are listed in Appendix C.

For example, to include the SIDES parameter to print on two sides of a sheet, use the following command:


$ PRINT/PARAMETERS=SIDES=2 GROTON.DAT

/PASSALL

/NOPASSALL (default)

Maintains the original characteristics of the print job through printer processing, preventing /HEADER, margin processing, and tab emulation (described in Chapter 6). The /PASSALL qualifier does not prevent operations specified by the system manager with DEFINE/FORM/SETUP. If your print job uses a form definition, the form characteristics for that form type prevail. (Refer to Chapter 13 for more information.)

For example, to print the FARM.DAT file without the special processing described above, use the following command:


$ PRINT/PASSALL FARM.DAT

/PRIORITY=n

Specifies a priority number to be assigned to the print job. You can use this qualifier to ensure that print jobs are printed in a specific order. The value of n is 0--255. To set this priority higher than the system value of MAXQUEPRI, you must have operator (OPER) privileges.

For example, to print FARM.DAT with a lower priority than GROTON.DAT, and ensure that GROTON is printed first, enter two PRINT commands, as shown:


$ PRINT/PRIORITY=1 FARM.DAT
$ PRINT/PRIORITY=2 GROTON.DAT

/QUEUE=queue-name

Specifies a print queue for printing the job. You supply the name of the execution queue or generic queue for queue-name. If you omit this qualifier, the print job is placed in the SYS$PRINT default queue, defined by the system manager.

To list the print queues at your site, use the SHOW QUEUE command, as described in Section 2.2.

For example, to print FARM.DAT on the printer for queue PS$DUPLEX, use the following command:


$ PRINT/QUEUE=PS$DUPLEX FARM.DAT

/REMOTE

Initiates a remote print request on another system.

When you include this qualifier, the file to be printed must exist on the remote node. You must include the host node name in the file specification portion of your print request. The file is queued on the default print queue (SYS$PRINT) of the other system and takes the printer characteristics defined for that system. The /QUEUE and /PARAMETERS qualifiers are ignored when you use the /REMOTE qualifier.

For example, to print GROTON.DAT on a printer on node AGRO::, use the following command:


$ PRINT/REMOTE AGRO::[MACDONALD]GROTON.DAT

/RESTART

/NORESTART (default)

Requests that the print job be automatically restarted if the printer jams or stops.

A print job with multiple files or copies that depends on passing the PostScript parameters from one file to the next may not be restarted successfully. (See Section 1.5.)

Do not use /RESTART with printer jobs when you:

For example, to ensure that the print job for FARM.DAT in print queue ANSI$PSPRINT will be restarted, use the following command:


$ PRINT/RESTART/QUEUE=ANSI$PSPRINT FARM.DAT

/RETAIN=option

Specifies the circumstances under which you want your jobs to be retained in a queue. When a job is retained in the queue, you can issue the SHOW QUEUE command after the job completes to see the status of the job. Without job retention, no record of a job is left in a queue after a job completes.

Use the following options to specify job retention:
ALWAYS Holds the job in the queue regardless of the job's completion status.
DEFAULT Holds the job in the queue as specified by the queue's retention policy.
ERROR Holds the job in the queue only if the job completes unsuccessfully.
UNTIL= time-value Holds the job in the queue for the specified length of time, regardless of the job's completion status.

/SETUP=module

Includes the specified setup module (from the queue's device control libraries) with the print job. The system manager can add and modify setup modules in device control libraries.

You supply one or more setup module names from the queue's device control libraries. To include more than one module name, separate the module names with commas and enclose the set in parentheses.

For example, to include the PostScript modules 4UP_GRID and 4UP_WIDE with the print job for FARM.RPT, use the following command:


$ PRINT/SETUP=(4UP_GRID,4UP_WIDE) FARM.RPT

/SINCE=time

/NOSINCE (default)

Prints files dated after the specified time, selecting files dated after the specified date and time. You can include a keyword instead of the time, including TODAY, TOMORROW, and YESTERDAY.

Use this qualifier with one of the following qualifiers to change the file selection mode:
/BACKUP Selects files based on the time they were last backed up.
/CREATED Selects files based on the file creation time. (This is the default if no file selection qualifier is included.)
/EXPIRED Selects files based on the file expiration time.
/MODIFIED Selects files based on the time the file was last modified.

For example, to print only the files named GROTON that were modified after March 1, 2001, use the following command:


$ PRINT/MODIFIED/SINCE=01-MAR-2001 GROTON.*

If you omit the /SINCE qualifier, the specified files are printed regardless of file creation, backup, modification, or expiration times.

/SPACE

/NOSPACE (default)

Requests printouts with single-spacing or double-spacing (one blank line between each text line). Use /SPACE for double-spaced output. Use /NOSPACE for single-spaced output.

For example, to print FARM.DAT with double-spaced lines, use the following command:


$ PRINT/SPACE FARM.DAT

/TRAILER=keyword

/NOTRAILER (default)

Specifies whether to print file trailer pages at the end of each file. Include this qualifier between the PRINT command and the file specification. You can supply the keyword ALL to specify trailer pages after each file, or ONE to specify a trailer page only after the last file in the print job. If you omit this qualifier, the default action of the print queue is used.

This qualifier does not affect the output of the job trailer page. Refer to the System Manager's GuideSystem Manager's Guide for more information about the job separation pages.

For example, to include a trailer page for all the files in the print job GROTON, use the following command:


$ PRINT/TRAILER=ALL GROTON.*

/USER=user-name

Allows you to print a job for another user. You must have the CMKRNL privilege and R (read) access to the file to print a job for another user. When you omit this qualifier, the default action is to print files with your user name.

For example, to print the file named FARM.DAT for user JONES, enter the following command:


$ PRINT/USER=JONES FARM.DAT


Previous Next Contents Index