VMS Interface for QMS Crown Printers ® ® 1800208-001G
Trademarks The following are trademarks or registered trademarks of their respective owners. Other product names mentioned in this manual may also be trademarks or registered trademarks of their respective owners. Registered trademarks are registered in the United States Patent and Trademark Office; some trademarks may also be registered in other countries. QMS, QMS-PS, Crown, the Crown seal, and the QMS logo are registered trademarks of QMS, Inc.
Contents 1 Introduction License Agreement ............................................................ 1-2 QMS VMS Host Software Option ...................................... 1-2 The QMS DECnet Interface Option ................................... 1-3 Included with the DECnet Option 1-4 For Serial/Parallel Connected-Printers ............................ 1-4 Included with the Serial/Parallel Option 1-4 LN03 Plus Printer Emulation ............................................. 1-5 Accessing Printer Features ..
2 DECnet Host Software Installation Introduction ........................................................................ 2-2 Before You Begin ............................................................... 2-2 Setting Up the Printer ........................................................
Navigating through PS Executive 2-23 Starting PS Executive for VMS 2-24 Printer Default Settings 2-24 Start Remote Console Session 2-24 Show Printer Counters 2-25 Identifying the Printer Location 2-25 Exit PS Executive 2-26 3 Serial/Parallel Host Software Installation Introduction ........................................................................ 3-2 Before You Begin ............................................................... 3-2 If This is an Update 3-2 Terminal Characteristics .................
Using Queues ..................................................................... 4-6 Queue Characteristics 4-6 Creating Generic Queues 4-7 Execution and Generic Queues ........................................ 4-8 Managing Queues .............................................................. 4-8 Merging Queues ................................................................. 4-9 QMS VMS-Supported Parameters .................................... 4-9 Characteristic File .......................................
Feed 5-9 Device Control Libraries ................................................... 5-9 QMS Device Control Library Module for DECnet Interface (QMS$RESET) 5-10 QMS Device Control Library Modules for Serial/Parallel Interfaces (QMS$RESET_S) 5-10 QMS Device Control Library Module for Serial/Parallel/DECnet Interfaces (QMS$HEADER) 5-12 Order of Data Sent to the QMS Printer 5-12 Symbiont-Generated Special Pages .............................. 5-13 prtpost: A PostScript Text Formatter ..........................
Q-FAX A-2 The QMS Corporate Bulletin Board System A-3 CompuServe A-3 Internet A-3 QMS Customer Response Center (CRC) A-4 QMS World-wide Offices ..................................................
1 Introduction In This Chapter . . .
License Agreement License Agreement The host software must be installed on all hosts that are to have access to the printer. » Note: The terms of the licensing agreement that you accepted by opening the package containing the host software restrict the software installation to multiple computers at a single site without the right to distribute, rent, sub-license, or lease the software or documentation. A separate license agreement and fee are required for each site at which the software is used.
The QMS DECnet Interface Option The QMS DECnet Interface Option The DECnet interface option for QMS Crown printers provides a hardware and software connection to your DECnet network. See your printer user’s guide for installation instructions for your hardware interface. With the interface hardware properly installed in the printer and the accompanying host software loaded on the host, the QMS printer becomes a node on the network. The host software n Creates execution queues.
For Serial/Parallel ConnectedPrinters Included with the DECnet Option The DECnet interface option includes the following components: n Host software provided on popular media types for DECnet- and serial/parallel-connected printers. n DECnet interface boards for either thin-wire, thick-wire, or 10BaseT Ethernet (to be installed by a QMS-authorized field engineer). n LN03 Plus printer emulation and compatible fonts on a 3.5" disk and requires a hard drive or a cartridge.
LN03 Plus Printer Emulation n LN03 Plus printer emulation and compatible fonts on a 3.5" disk (and a downloadable image on the host software for printers which do not have a 3.5" disk drive). n Installation instruction sheet for the 3.5" disk version of the LN03 Plus emulation. n LN03 Plus Emulation Guide for QMS Printers. n VMS Interface for QMS Crown Printers. LN03 Plus Printer Emulation The QMS-developed LN03 Plus emulation is made available in several formats.
About this Manual Many printer manufacturers provide only one set of parameters that the system administrator must use for all print jobs. Using the standard VMS PRINT command qualifiers, however, you can customize the output for each job by temporarily changing the default configuration setting on the QMS Crown printer. This is accomplished through the QMS-provided characteristic file which contains the mapping of the PRINT qualifiers to appropriate Document Option Commands (DOC).
About this Manual 6 A Troubleshooting Outlines common error and status messages related to the printer for host software installation. An installation troubleshooting flowchart is also included. QMS Customer Support Provides product sales and support telephone numbers and describes how to communicate with QMS through the QMS Bulletin Board, CompuServe, Internet, and Q-FAX.
About this Manual Typographic Conventions The following typographic conventions are used in this manual: » Mixed-Case Courier Text you type, and messages and information displayed on the screen Mixed-Case Italic Courier Variable text you type; replace the italicized word(s) with information specific to your printer or computer UPPERCASE COURIER Information displayed in the printer message window lowercase italic Variable information in text and VMS commands UPPERCASE VMS commands and qualifies;
2 DECnet Host Software Installation In This Chapter . . .
Introduction Introduction The QMS VMS host software is compatible with DECnet Phase IV (DECnet-VAX) and Phase V (DECnet-OSI), Alpha AXP, and systems running VMS and OpenVMS. This chapter takes you step-by-step through the installation of the QMS DECnet print symbiont and associated software for DECnet (Ethernet)-connected printers.
Before You Begin Phase V (DECnet-OSI): Before beginning the installation on DECnet Phase V, create an NCL (Network Control Language) node entry for the printer. You need to add the printer to the local or DNS Register via SYS$COMMON:[SYSMGR]DECNET DNS REGISTER.COM or SYS$COMMON:[SYSMGR]DECNET_LOC_REGISTER.COM » Note: The command you use depends on the topology of your network. NCL, rather than NCP, verifies that you set up the network and node information necessary for proper printing.
Setting Up the Printer Setting Up the Printer The DECnet interface option shares its configuration menu on the printer control panel with the TCP/IP interface option. Before beginning the software installation, use the following instructions to configure the DECnet-specific interface options (Administration/Emulations/ DECnet-TCP/IP menu). See your printer user's guide for instructions on how to use the printer control panel.
Setting Up the Printer Emulation Option Use the Emulation option in the DECnet-TCP/IP menu to choose a default emulation for print jobs received over the DECnet-TCP/IP interface: » Note: Not all emulations are supported on all QMS printers. Check your user's guide to determine which ones are supported on your printer. n Select ESP for Emulation Sensing Processor. ESP mode is the printer default. In ESP mode, the printer examines all print jobs to interpret the emulation.
Setting Up the Printer Min K Spool/Spooling Options The printer's memory (including a portion of the internal hard disk) is used for spooling print jobs from the host. All interfaces on the printer share the total number of kilobytes available in memory. By default, a minimum of 15 KB (the Min K Spool option in the DECnet-TCP/IP menu) is dedicated to spooling jobs received over the DECnet-TCP/ IP interface.
Setting Up the Printer 1 If the printer is on line, press the Online/Offline key to take the printer off line. 2 Press the Menu key to enter the printer Configuration menu. 3 Press the Next key until the message window displays ADMINISTEATION, and then press the Select key. 4 Press the Next key until the message window displays COMMUNICATIONS, and then press the Select key. 5 If your printer supports two optional interfaces, you will NETWORK 1 and NETWORK 2 options.
Setting Up the Printer When you press the Select key after you’ve entered the last digit, the printer momentarily displays the address you selected and then returns to the DECNET-TCP/IP menu. 13 Press the Online/Offline key to put the printer back on line. The new DECnet address takes effect immediately after you turn the printer off and on again. DECnet HSL [Hot Status Listener] Option By default, this option is Disabled.
Setting Up the Printer fixed mode, the printer uses the quoting mechanism of the binary communications protocol to distinguish between the special control characters and print job binary data.
Setting Up the Printer Options The following options are available in the PS Protocol menu: Menu Administration/Communications/Interface/PS Protocol Choices Name and Description Interfaces Normal—Enables standard, ASCII hex Parallel, Serial, protocol. Data is sent and received in Ethernet, TokenASCII format. This mode is Ring, LocalTalk recommended if you do not print binary data. It was designed for data in the printable ASCII range.
Setting Up the Printer Qbinary (Quoted Binary) Fixed—Enables Ethernet, Tokenbinary communications protocol. Print Ring jobs cannot alter this value through PostScript operators. Data in the printable ASCII range also prints. Use the special quoting mechanism for the special characters and ^D (EOF). Default Normal Notes A data stream sent through the serial or parallel interface using Binary is treated the same as a data stream sent through an optional network interface using QBinary.
If This is a Software Update Def [Default] Job Prio [Priority] Option The Def Job Prio option allows you to specific which jobs are printed first, according to the interface through which they are received, when jobs are received simultaneously. In other words, you can give jobs received via the DECnet - TCP/IP interface priority over jobs received via the parallel and serial interfaces, or vice versa. Valid choices range from 001 to 099, with 001 meaning highest priority. The factory default is 001.
Installing the DECnet Host Software Installing the DECnet Host Software The QMS host software for DECnet-connected printers checks for the presence of DECnet Phase IV or Phase V protocol and prompts your responses accordingly. Phase IV and Phase V Installation The following procedure describes the installation of DECnet Phase IV and Phase V host software. Any differences between the two installation procedures are noted.
Installing the DECnet Host Software 4 The program next prompts you for the name of the save set: * Enter the products to be processed from the first distribution volume set. * Products: Type the product name from the distribution software tape label. The name has the format QMSSMBPSExxx where xxx is the version of the software. For example, you would type QMSSMBPSE031↵ if you’re installing Version 3.0.
Installing the DECnet Host Software 6 You’re now asked whether you’re installing a DECnet or a serial/parallel symbiont: * Configure host software for a serial/parallel interface (rather than DECnet) [NO]? Press Enter to indicate a DECnet installation. 7 The next prompt concerns the IVP (Installation Verification Program): * Do you want to run the IVP after the installation [YES]?' Press Enter if you want to run the IVP after installation; type N if you do not.
Installing the DECnet Host Software Entering the Printer Node Name and Address Use either the Phase V or Phase IV instructions that follow, depending on your site. Phase V Only: Successful installation of this product under DECnet-OSI (Phase V) requires that you have already defined a node name and address to be used with the printer you are installing. (The Installation Verification Procedure will fail otherwise.) You will be asked for the node name later in this installation procedure.
Installing the DECnet Host Software Phase IV Only: Phase IV installation continues with the following steps to enter the printer node name and address. 1 The program next prompts you for the printer node name: * Enter a node name for the QMS printer: Enter the node name of the QMS printer you’re updating. Note: Be careful not to end the node name with a single colon (:). Otherwise, the symbiont will assume a port connection.
Installing the DECnet Host Software Naming the Queues The installation continues for both Phase IV and Phase V software with the following steps to name the execution queue. 1 You’re next prompted for the name of the execution queue. Note: If this is a system update and the target queue exists, then that queue must be stopped and deleted from the active system.
Installing the DECnet Host Software Creating Generic Queues The installation continues with the following steps to create generic queues for the emulations. 1 The program asks if you want to create generic queues for each emulation supported by the printer: * Do you wish to create generic queues [YES]?' If this is a software update, type N to allow the previously created queues to be used.
After Installing the Host Software After Installing the Host Software After host software installation, ensure that the system boot file calls the printer start-up file. For example, for VMS Version 5 systems, the SYS$SYSROOT: SYSTARTUP_V5.COM file should include this line: $ @SYS$STARTUP:QMS$START_QUEUE.COM If the printer is part of a VAXcluster system, ensure that all other members of the cluster include the call to the QMS$START_QUEUE.COM in their start-up files.
HSL Network Application HSL Network Application Activating the Hot Status Listener (HSL) application provides the host with pseudo real-time printer message logging. The HSL receives printer error and backchannel messages from DECnet-connected printers. The HSL can then relay the message to OPCOM, a terminal port, or to a log file in the original directory. The HSL logs error status and backchannel messages to the print file’s directory under the print_file_name.
HSL Network Application 2 Type the following commands: $ SET DEF SYS$COMMON:[sysexe]↵ $ @qms$inithsl↵ » Note: This command procedure works without modification for most sites but you should review the command procedure before running. Once these two steps are completed, the HSL application is active and ready to receive printer error and backchannel messages. Phase V Installation The HSL installation routine checks for DECnet Phase V.
PS Executive Series Utilities (Remote Console) Verifying the HSL Application To verify that the HSL application is running, enter the appropriate command: Phase IV $ mc ncp show object HSL↵ The following information is displayed on a DECNet host Object Number File/PID User ID HSL 0 SYS$COMMON:[SYSEXE]HSL.EXE 00000154 Password HSLHSLHSL Phase V $ mc ncl show session control application HSL↵ » Note: To prevent the creation of a log file, delete the directory SYS$SPECIFIC:[HSL].
PS Executive Series Utilities (Remote Console) Starting PS Executive for VMS PS Executive is installed as part of the host software installation. Once the software is installed, PS Executive can be started with the following command: $ run sys$system:qms$psexec↵ You’re asked for the printer node name: * What is the QMS printer node name Enter the node name for the printer whose settings you want to view.
PS Executive Series Utilities (Remote Console) Show Printer Counters The printer keeps track of the amount of data received and other accounting information. These printer “counters” are n Bytes Received Displays the total number of data bytes received by the printer since it was turned on. n Messages Received Displays the total number of messages received from the host since the printer was turned on.
PS Executive Series Utilities (Remote Console) Show Printer Location This menu option displays the string that was entered by Set Printer Location. If no location has been set, the following message displays: Use Set Printer Location first The printer location is stored in file SYS$COMMON:[sysexe]QMS$node_name.dat where node_name is the printer node name. Exit PS Executive To exit from PS Executive, highlight this option and press Return. You’re returned to the system prompt.
3 Serial/Parallel Host Software Installation In This Chapter . . .
Introduction Introduction This chapter takes you step-by-step through the installation of the QMS host software for host-, LAT-, or serial/parallel-connected printers. Before You Begin Before installing the host software, ensure that the designated system port is identified and properly configured for the target printer port to be used.
Terminal Characteristics Terminal Characteristics The software installation assigns the following terminal characteristics to the printer port: Interactive No Hostsync No Wrap No Broadcast No Modem No Brdcstmbx Line Editing No Secure server No SIXEL Graphics No ANSI_CRT No Edit_mode No DEC_CRT4 No Echo TTSync Scope No Readsync No Local_echo No DMA Overstrike Editing No Disconnect No Soft Characters No Regis No DEC_CRT No Type_ahead Lowercase No Remote NoForm No Autobaud No Altypeahd No Fallback Passthru
Installing the DECnet Host Software 3 The installation program prompts you for the name of the device where you mounted the software tape: * Where will the distribution volumes be mounted: Type the device name and press Enter. 4 The program next prompts you for the name of the save set: * Enter the products to be processed from the first distribution volume set. * Products: Type the product name from the distribution software tape label and press Enter.
Installing the DECnet Host Software 6 You’re now asked whether you’re installing a DECnet or a serial/parallel symbiont: * Configure host software for a serial/parallel interface (rather than a DECnet) [NO]? Type Y and press Enter Refer to the Version 3.x Release Notes, located in the SYS$HELP directory, for information on configuring the host software for other/additional interfaces. 7 The next prompt concerns the IVP (Installation Verification Program).
Installing the DECnet Host Software 9 You’re now asked for a terminal port: * Enter a terminal port for the QMS PS-product_name printer: This port is assigned to the product you’re installing. The name can have up to seven characters. Don’t include the colon (:) after the terminal port. n If the port is found, the following prompt displays: * The port was found and the desired characteristics have been set.
Installing the DECnet Host Software Naming the Queues The installation continues with the following steps to name the execution queue. 1 The program next prompts you for the name of the execution queue. You may choose the default name “QMS” by pressing the Return key, or choose a queue name by entering a unique name. * Enter a name for the QMS printer's execution queue [QMS_nodename]:' Note: _nodename is a name assigned automatically by the system administrator.
Installing the DECnet Host Software n 2 If this is a first-time installation and you want to take advantage of VMS queue load balancing and QMS print symbiont data typing, type Y. Data typing allows the symbiont to generate the appropriate DOCs to select the language to be used for processing the print job.
After Installing Software Defining Queue Logicals for Serial/Parallel If your QMS printer doesn’t support QMS Document Option Commands (DOC), the following logical was defined by the installation: $DEFINE/SYSTEM QMS$execution_queue_CONTROL -"NODOC" If you selected a parallel interface, the following logical was defined: $DEFINE/SYSTEM QMS$execution_queue_CONTROL -“PARALLEL” execution_queue is replaced with the name of your execution queue. The execution queue outputs directly to the printer.
After Installing Software QMS$START_QUEUE.COM in their start-up files. For VMS systems, include this line in each members start-up file: $ @SYS$COMMON:[SYS$STARTUP]QMS$START_QUEUE.COM » Note: If you saved predefined set-up files by moving them from the old device control library during the software update, you must be sure to move them back to the QMS$DEVCTL20.TLB library using the following commands: $ library/insert/text _$SYS$LIBRARY:QMS$DEVCTL20.TLB _$ module_name.
4 Queues, /PARAMETERS, and Logicals In This Chapter . . .
Order of Precedence Order of Precedence The following information provides the order of precedence for controlling printer output. The /PARAMETER qualifiers can be used on the command line or transparently through a logical definition which is associated with a specific queue.Whether the /PARAMETER qualifier is given on the command line or logical will determine which takes precedence.
Order of Precedence You may use any of the PRINT parameters explained in this chapter. Any parameter that you express on the command line takes precedence over the same parameter specified in the generic queue definition. Queue Logical Precedence Unique document handling features of the Crown printers are controlled using QMS Document Option Commands (DOC). These commands are prepended to the print job by the print symbiont.
Order of Precedence For example, the following command issued from the command line associates the SIDES parameter with the PSLEGAL_PUBS generic queue: $ DEFINE/SYSTEM QMS$PSLEGAL_PUBS_QUEUE _$ "SIDES=TWO" Whenever a job is sent to the PSLEGAL_PUBS queue, the job controller adds the SIDES=TWO parameter to the existing parameters (defined in the generic queue) that apply to all jobs sent to the queue. Changing parameters in logicals is also done from the command line.
Order of Precedence Keyword Emulation HP-P HP PCL x HPP HP PCL x HP-G HP-GL HPG HP-GL CCI CCITT QUIC QMS QUIC II LP Lineprinter LINEP Lineprinter For example, the following queue names carry with them the indicated data types, forcing DOCs to precede jobs printed through them: PS_QUEUE1 PostScript POSITRON_FAST PostScript ANSWER2 LN03 Plus LN03+_QUEUE LN03 Plus Implied data types can be overridden by either a queue logical or a data type argument on the command line.
Using Queues 3 The following command is entered to print a file: $ PRINT/QUEUE=MYQUEUE _$ /PARAMETER=DATA_TYPE=HPGL filename.ext The symbiont precedes this print job with DOCs that direct it to the HP-GL emulation. » Note: The /PARAMETER qualifier DATA_TYPE is a special case. All other /PARAMETER qualifiers can be declared only through the queue logical or on the command line. However, the order of precedence is the same as that explained above.
Using Queues Creating Generic Queues Define the generic queues by using the following commands in the QMS$START_QUEUE.COM file: $ INIT/QUEUE/START _$ /GENERIC=(exec_queue1, exec_queue2, _$ exec_queue3) generic_queue_name $ DEFINE/SYSTEM QMS$queue_name_QUEUE _$ "parameters,parameters,..." In this syntax, exec_queue1, exec_queue2, and exec_queue3 are the execution queues with which the generic queue generic_queue_name is associated.
Execution and Generic Queues _$ QMS$PSLEGAL_PUBS_QUEUE _$ "DATA_TYPE=POSTSCRIPT,SHEET_SIZE=LEGAL" Any job sent to the PSLEGAL_PUBS queue receives the PRINT parameters DATA_TYPE=POSTSCRIPT and SHEET_ SIZE=LEGAL. The print symbiont translates these parameters into QMS DOCs and sends the job to the printer that is associated with the QMS_PUBS execution queue.
Merging Queues Input Idle, DECnet print jobs are accepted only if the printer has completed the processing for the previous job and has begun to print it. You can delete the current job from the internal print queue by using the Cancel (or Reset) key on the printer control panel. Refer to your printer user’s guide for information on using the Cancel (or Reset) key.
QMS VMSSupported Parameters The following parameters are supported: COLLATE PAGE_GRID BOOK_STYLE PAGE_LAYOUT DATA_TYPE PAGE_LIMIT DOC PAGE_MARGIN INPUT PAGE_OFFSET MESSAGES PAGE_SCALING OFFSET/JOGGING SHEET_COUNT ORIENTATION PAGE_SCALINGSHEET_SIZE/PAGE_SIZE OUTPUT SIDES OVERLAY STAPLE PAGE_BORDER BOOK_STYLE The BOOK_STYLE parameter places two logical pages on each sheet (or face) in an order that produces a booklet when the paper is folded.
QMS VMSSupported Parameters DATA_TYPE The language of a file is its DATA_TYPE. If you use generic queues that specify a DATA_TYPE, you should send your files to the queues that correspond with the language/emulation you want the printer to use. Include the DATA_TYPE parameter in your generic queue definition to specify which printer emulation to use for print jobs sent to the queue.
QMS VMSSupported Parameters DOC Some QMS printers don’t support QMS Document Option Commands (DOC). The symbiont generates DOCs to access most printer features. Refer to your printer user's guide to determine if your printer supports DOC. You may force the omission of DOCs that are generated by the symbiont by entering the following command: $ PRINT/PARAMETER=DOC=OFF/QUEUE=queue_name _$filename Specifying DOC=ON has the same effect as omitting this command.
QMS VMSSupported Parameters » Note: Only LN03 Plus and PostScript emulations on the QMS printer return backchannel messages to the printed error log page.
QMS VMSSupported Parameters » Note: The OFFSET/JOGGING parameter must be specified as ON for offsetting to work. Turning offsetting off prevents the symbiont from defining the required offset ranges. ORIENTATION There are actually three parameters that control orientation. They are ORIENTATION, PAGE_ORIENTATION, and LPORIENTATION.
QMS VMSSupported Parameters If a generic queue includes this parameter and a print job sent to the queue doesn’t specify an output tray or bin with the PRINT command, the printer sends the printed page to the top output tray or bin when printing the job. If a generic queue doesn’t specify this parameter, you may include OUTPUT at the command line as follows: $ PRINT/PARAMETERS=(OUTPUT=selection) OVERLAY The OVERLAY parameter enables you to print an image as a background of your job.
QMS VMSSupported Parameters starting the range are compiled but are not printed. Pages that come after the last page in the range are flushed without being compiled. The default range is one page. PAGE_MARGIN The PAGE_MARGIN parameter defines the usable area of the sheet in which logical pages may be placed. The margins established by this parameter take effect after the sheet has been oriented by the ORIENTATION parameter.
QMS VMSSupported Parameters n The PRINT/COPIES command prints n collated copies of each file in your job regardless of the collation setting in the printer’s configuration menu. $ PRINT/COPIES=n filename.typ n The PRINT/JOB_COUNT command prints n collated copies of the entire job regardless of the collation setting in the printer’s configuration menu. $ PRINT/JOB_COUNT=n filename.typ SHEET_SIZE The sheet size is the physical size of the media on which you’re printing.
QMS VMSSupported Parameters » TWO Two-sided copies for binding along the left edge. TUMBLE Two-sided copies for binding along the top edge and with alternating pages rotated 180 degrees. Note: Other selections may be valid. Check your product-specific characteristic file. The following illustration shows the difference between SIDES=TWO and SIDES=TUMBLE.
Characteristic File STAPLE The STAPLE parameter may be used if your printer supports stapling. This parameter may be specified as on or off. Job, file flag, burst, and trailer pages are not stapled to your data pages if stapling is on. Use the following command to select stapling: $ PRINT/QUE=name/PARAMETERS=(STAPLE=selection) - _$ filename.ext » Note: The COLLATE parameter must be specified as on for STAPLE to work.
Characteristic File qualifier - character. Lines which have a % character in column one are comment lines. When you enter the /PARAMETER qualifiers on the command line, they must contain at least as many characters as their counterparts in the characteristics file. Example The following example characteristic file is used when you connect the symbiont to a QMS 4525 Crown printer.
Summary of Logicals OFFSET-offset,OFF-off,ON-on % % The following characteristics are most often used with number-up printing. % PAGE OFFSET-pageoffset PAGE SIZE-pagesize,LETTER-Letter,LEGALSLegalSmall,LEGAL-Legal, QUARTO-Quarto,COMMERCIALCommercial,A4-A4.
Summary of Logicals QMS$execution_queue_CONTROL This logical is associated with the execution queue and relays options to the symbiont that modify its default behavior. These options include “PARALLEL,” “NODOC,” “CARRIAGE,” “SJS,” and “INPUT.” n PARALLEL This option informs the symbiont that it’s connected to a parallel rather than a serial terminal port, thus preventing the symbiont from sending backchannel information back to the port.
Summary of Logicals $ DEFINE/SYSTEM QMS$queuename_CONTROL _$ “CARRIAGE,INPUT=BOTTOM,SJS=SES” A session is a single print job that encompasses two or more subjobs, and applies global printing attributes, such as duplexing and collating, to them. Each subjob can be of any supported emulation and can have its own printing attributes. See the QMS Document Option Commands manual and your printer user’s guide for more information on the %%Session command.
Summary of Logicals $ DEFINE/SYSTEM QMS$HPPCL_QMS860_QUEUE _$ "INPUT=TOP,SIDES=2" or $ DEFINE/SYSTEM QMS$QMS_4525_QUEUE _$ "STAPLE=ON,SIDES=2,INPUT=TOP,OUTPUT=20" QMS$any_queue_NUP This logical is associated with the execution or generic queue to relay arguments to be used when printing PRTPOST type output. See chapter 5, “Printing Your Files,” for more information on PRTPOST output.
5 Printing Your Files In This Chapter . . .
Using Application Software Using Application Software Most application or layered software products allow you to specify the queue in which to place jobs for printing. To set up your application for printing to the QMS printer, specify the generic queue that corresponds to your application's output language. For example, if your application outputs LN03 Plus commands, specify the generic queue (defined when you installed the host software) associated with the LN03 Plus language.
Using Set-up Modules, Forms, and Characteristics Using Set-up Modules, Forms, and Characteristics Set-up modules are files that are written in a language that is understood by your printer. These files can serve many purposes, depending on your needs, from changing default fonts or page margins for a particular job, to printing a border or title on every page. Use the following command to print with a set-up module: $ PRINT/SETUP=(mod1,mod2,...) filename.
Using Set-up Modules, Forms, and Characteristics Form set-up modules may also be defined in a form definition: $ DEFINE/FORM/SETUP=(mod1,mod2,...) form_name_$ form_number Set-up Modules If set-up modules are specified from the command line and a queue logical also defines a list of set-up modules, the modules specified on the command line are downloaded before those specified by the QMS$queue_name_SETUP logical where queue_name is the name of your specific execution queue.
Forms Forms You may create the form either from the command line or by editing the QMS$START_QUEUE.COM file with the following command: $ DEFINE/FORM form_name form_number _$ /DESCRIPTION= string _$ /SETUP=(mod1_name,mod2_name,...) _$ /LENGTH=nn _$ /WIDTH=nn _$ /PAGE_SETUP=(mod1_name,mod2_name,...) You provide a form_name (1 to 31 characters long) and form_number (in the range 1 to 127).
Forms Length The DEFINE/FORM command qualifier /LENGTH specifies the physical length of a form page in lines: $ DEFINE/FORM/LENGTH=n The default page length is 66 lines, which assumes a standard page length of 11" with 6 lines of print per inch. The value for n must be a positive integer greater than 0 and less than 255. Margin The DEFINE/FORM command qualifier /MARGIN specifies one or more of the four margin options: $ DEFINE/FORM/MARGIN=(option[,....
Forms Option Purpose RIGHT=n Specifies the number of columns to be left blank between the /WIDTH setting and the actual print image area. The n parameter must be a positive integer between 0 and the value of the /WIDTH parameter. When determining the / RIGHT parameter, start at the /WIDTH value and count to the left. The default value is 0, which means that the print image extends as far to the right as the /WIDTH value.
Forms Truncate The DEFINE/FORM command qualifier /TRUNCATE discards any characters that exceed the current line length specified by the / WIDTH and /MARGIN=RIGHT settings: $ DEFINE/FORM/NOTRUNCATE The /TRUNCATE qualifier is incompatible with the /WRAP qualifier because it forces /NOWRAP. If you specify both /NOTRUNCATE and / NOWRAP, the printer prints as many characters on a line as possible. This combination of qualifiers is useful for some types of graphics output.
Device Control Libraries If you specify /WRAP, you cannot specify /TRUNCATE. The /WRAP qualifier forces /NOTRUNCATE. If you specify both /NOWRAP and /NOTRUNCATE, the maximum characters for the current font are printed on a line. This combination of qualifiers is useful for some types of graphics output. » Note: LENGTH, MARGIN, TRUNCATE, PAGE_SETUP, WIDTH, and WRAP qualifiers are ignored if the job is not declared as LN03 Plus or HP PCL.
Device Control Libraries The print symbiont retrieves your set-up module and sends it, along with your file, to the printer when you use the /SETUP qualifier to the PRINT command. The following example uses the BORDER set-up module with the file MEMO.PS: $ PRINT/SETUP=BORDER MEMO.PS QMS Device Control Library Module for DECnet Interface (QMS$RESET) The QMS$RESET DECnet interface reset module contains commands which ensure proper file separation. It is used to return the system to a known state.
Device Control Libraries The following modules in the Device Control Library are used by the serial/parallel configured symbiont to change emulations on the serial interface of the printer: n QMS$POSDOC_S n QMS$LN0DOC_S n QMS$HPGDOC_S n QMS$HPPDOC_S n QMS$CCIDOC_S n QMS$ESPDOC_S n QMS$QUIC_S n QMS$LINEP_S The following modules in the Device Control Library are used by the serial/parallel configured symbiont to change emulations on the parallel interface of the printer: n QMS$POSDOC_P n Q
Device Control Libraries QMS Device Control Library Module for Serial/Parallel/DECnet Interfaces (QMS$HEADER) The QMS$HEADER module contains PostScript job and file flag, burst, and trailer pages code.
SymbiontGenerated Special Pages Symbiont-Generated Special Pages The job header page (also known as the job flag page generated by the symbiont) may contain the following information: n Selected language n Queue entry number n Job name n Host node name n User login n Print priority n Execution queue and generic queue, if used n A user-defined message (generated by the /NOTE qualifier) n Printer node name n Date and time job was queued n Printer name and product name n Account and rig
prtpost: A PostScript Text Formatter The file burst page prints immediately after the file flag and is identical to the file flag page except for a solid border. The file trailer page prints after each file in the print job. It contains all the information contained on the file flag page except the file size, and creation and modification information. The job trailer page prints after the last file trailer page in the job.
prtpost: A PostScript Text Formatter Bold displays the time and date of printing on the left, the filename centered in the middle, and the page number on the right. The header baseline is 0.5" from the top of the page, and has left and right margins of 0.5". The main body of text has a top margin 1" wide, a left margin 0.75" wide, and a bottom margin 0.5" wide. The right margin is determined by the right limit of the printer's imageable area.
prtpost: A PostScript Text Formatter Options Following is a list of all the options: This option . . . does this . . . -#copies Selects the number of copies. -2 Sets text in two columns. The default is one column. -4 Prints four half-size pages per sheet (in other words, 4-up). -Bmodulename Identifies the beginning-of-page module. You may create a PostScript module which will be executed before each page is formatted.
prtpost: A PostScript Text Formatter This option . . . does this . . . -Emodulename Identifies the end-of-page module. You may create a PostScript module which will be executed after each page is formatted. Because of PostScript’s opaque paint imaging model, marks laid down by this module may overwrite the page text. Possible uses might be to draw borders around each page, print a company logo, or print a custom page header.
prtpost: A PostScript Text Formatter This option . . . does this . . . -Ilpi Sets the number of lines per inch x 100. Line spacing defaults to the point size. Examples n Lines in a 12 pt. font are spaced 12/72" (1/6") apart, resulting in 6 lpi. n -I400 produces 4 lpi. n -I850 produces 8.5 lpi. -N Turns off the header. The default is to print a header for every page. -n Prefixes each line with a 5-digit line number. The default is no line numbers.
prtpost: A PostScript Text Formatter This option . . . does this . . . -X Does not separate columns with a rule line. In twocolumn mode, a vertical line normally separates the columns. -Z Does not separate 4-up pages with rule lines. Normally, two lines are drawn in a cross to separate the miniature pages. Notes to the Option Table n -2 Option—When the -2 option is selected in conjunction with landscape mode, the effect is similar to printing pages 2-up.
prtpost: A PostScript Text Formatter All of the fields are constant width, so the PostScript getinterval operator can be used to break up the string and rearrange the fields, if desired. The coordinate system inherited by the beginning- and end-of-page files is not quite the default coordinate system: the origin is still in the lower-left corner, but the units are scaled to decipoints (1/720") in both directions. If the -4 option is used, the whole page is scaled and repositioned.
6 Troubleshooting In This Chapter . . .
Error Messages Error Messages The following messages may occur during installation of the host software. Messages have the format %QMSSMBPSE-severity-identification, message Severity Identification The codes indicating the severity of messages are as follows: This severityidentification letter... means the message is... The installation... I Informational Is not affected W Warning Is not affected E Error Fails F Fatal error Fails Messages 6-2 This message... means...
Error Messages This message... means... Notes CLEANUP Exiting, VMSINSTAL cleaning up... Files are being restored after a terminated installation. DECNETREQ DECnet must be Start the DECnet network software running to install before installing the host software. To this product! start DECnet, use the command @SYS$MANAGER:STARTNET DSKSPACLOW This installation requires 20,000 blocks of free space! Your system does not have the required number of blocks available for installing the software.
Error Messages 6-4 This message... means... Notes NODNAMREQ A node name is required for the installation of the QMS printer. You didn’t supply a node name for the printer. The printer’s node name must be a unique identifier on your network, consisting of up to six characters (alphabetic or numeric) with at least one alphabetic character. NOPSEXEC PS Executive will You requested that the installation not be installed. program not automatically load the QMS PS Executive Series Utilities.
Troubleshooting Charts Troubleshooting Charts Use these charts for tracking down problems with the host software installation program. Print Test Page DECnet options appear on start-up page. No Reset DECnet interface card. Yes Correct DECnet address appears on the start-up page. Set DECnet address from printer control panel. No Yes Install VMS Host Software.
Troubleshooting Charts Installation completes successfully. B Installation completes successfully. No Yes IVP completes successfully. “Badge Kit” message displays. No Yes Yes Finish. 6-6 C Stop. Call your QMS representative.
Troubleshooting Charts C Queues have been started successfully. No Yes Printer responds to lookback test. Check Ethernet cable connections. Stop. Call your QMS representative. No Yes Check release notes for applicable solutions. Yes Troubleshooting Other files print correctly through DECnet. Yes Files print through other printer interfaces.
Disabling a Printer Interface Disabling a Printer Interface Each interface on the printer is active at all times. If you want to deactivate any interfaces that you do not use (preventing access to the printer from those interfaces), you may do so from the printer control panel. 1 If the printer is on line, press the Online/Offline key. Press the Menu key to open the printer Configuration menu. 2 Press the Next key until the message window displays ADMINISTRATION and press the Select key.
No HSL Messages from the Printer No HSL Messages from the Printer If no messages are sent from the printer even though HSL was installed, ensure that the HSL option is enabled (Administration/Emulations/DECnet-TCP/IP/DECnet HSL menu). If there is no process ID assigned to the HSL application, then HSL is not running. See chapter 2, “DECnet Host Software Installation,” for more information about the HSL application.
A QMS Customer Support In This Appendix. . .
Sources of Support Sources of Support Several sources of help and information are available, depending on the type of help you need: Your QMS Vendor Your local vendor (the one from whom you bought the printer) may be best equipped to help you. Your vendor has specially trained service technicians available to answer questions, and the equipment to analyze your printer problems. Your Application Vendor Often, “printing” problems have more to do with the application being used than with the printer.
Sources of Support The QMS Corporate Bulletin Board System The QMS Corporate Bulletin Board System (BBS) contains technical support notes, application notes, drivers, patches, and utilities, and you may leave technical questions not requiring an immediate response on electronic mail for the Sysop (System Operator). The bulletin board [(334) 633-3632] operates at 1200, 2400, 9600, and 14400 baud, 8 data bits, no parity, 1 stop bit, with XMODEM, YMODEM, and ZMODEM capabilities.
Sources of Support QMS Customer Response Center (CRC) You can contact the QMS Customer Response Center (CRC) in three different ways: n Telephone—You can call the CRC at (334) 633-4500 (US) Monday–Friday, 7:00 am–6:00 pm, Central Time.
QMS Worldwide Offices QMS World-wide Offices QMS United States and Latin America General Contact 1 (334) 633-4300 Fax 1 (334) 633-4866 Email info@qms.com Internet http://www.qms.com Customer Response Center (CRC) Technical Assistance 1 (334) 633-4500 7:00 am–6:00 pm Central Time Fax 1 (334) 633-3716 Internet http://www.qms.
QMS Worldwide Offices QMS in Japan General Contact (+81)- 3 3779-9600 Fax (+81)-3 3779-9650 nternet http://www.qmsj.co.jp QMS in Latin America General Contact Cra 43 DD#8-42 Officina 201 Medellin, Colombia (+57) (4) 312 13 70 Fax (+57) (4) 268 92 97 QMS Europe Australia Anitech Sydney Business & Tech.
QMS Worldwide Offices Italy Via della Repubblica 56 43100 Parma Italy (+39) 52–1231 998 Fax (+39) 52–1232 902 Nordic Arenavägen 41, 6th floor 121 77 Johanneshov Sweden, Finland, Sweden Norway, and (+46) 8–600 01 30 Denmark Fax (+46) 8–600 01 33 South Africa Spain UK United Kingdom and Ireland Saskay House Unit 24 Sunninghill Business Park Peltier Road, Sunninghill, Johannesburg Republic of South Africa (+27) 11–807 6957 Fax (+27) 11–807 6960 Josefa Valcárcel 8 28027 Madrid Spain (+34) 1– 742 5013 Fa
Index /FEED 5-9 /LENGTH 5-6 /MARGIN 5-6 /NOTE 5-13, 5-14 /PAGE_SETUP 5-7 /PARAMETER logical 4-3 /PARAMETER qualifiers Precedence 4-2 /SETUP 5-7 /TRUNCATE 5-8 /WIDTH 5-8 /WRAP 5-8 _CHAR logical 4-23 _CONTROL carriage 4-22 input 4-23 nodoc 4-22 parallel 4-22 SJS 4-22 _CONTROL logical 4-22 _NUP logical 4-24 _QUEUE logical 4-23 _SETUP logical 4-24 A Accounting 2-25 Address 2-17 DECnet 2-6 Printer 2-16 Alpha AXP 1-2 Application software, using 5-2 Area number, DECnet Address 2-7 B Backchannel messages 4-12 B
Bulletin board, QMS A-3 Burst page 5-13 C Characteristic file 1-3, 4-19 Characteristics 5-3 COLLATE 4-10 Configuring the interface 2-4 COPIES 4-16 Copies, duplex 4-17 Copies, multiple 4-16 Counters, printer 2-25 Customer Response Center (CRC), QMS A-4 Customer support, QMS A-2 D DATA_TYPE 4-11 DECnet address 2-6, 2-16 Area number 2-7 Node number 2-7 DECnet HSL 2-8 DECnet interface option 1-3 DECnet-OSI 2-16 DECnet-OSI, Phase V 2-2 DECnet-TCP/IP interface 2-4 Disabling 2-4, 6-8 Enabling 2-4 DECnet-VAX, Pha
Input tray/bin 4-12 Installation verification 2-20, 3-9 Installation verification program 2-16 Interface Serial/Parallel 1-4 Interface option DECnet 1-3 Internet A-3 IVP, Installation verification program 1-3, 2-15 NCP, Network control program 2-2 Node name 2-16, 2-17 Node number 2-7 Node number, DECnet address 2-7 NOFEED 5-9 NOTE 5-13 NOTRUNCATE 5-9 nstallation verification program 1-3 Number-up 4-15 N-UP printing 4-15 J O Job burst page 5-13 Job header page 5-13 Job trailer page 5-14 JOGGING 4-13 Off
Print queues, naming 2-18, 3-7 Printer counters 2-25 Printer defaults 2-24 Printer features, accessing 1-5 Printer interface Disabling 6-8 Printer setup 2-4 Printing from VMS 5-2 prtpost 5-14 PS Executive 1-3, 2-23, 6-4 PS Protocol 2-8 PS protocol advantages 2-11 PS protocol implementation 2-11 Q Q-FAX A-2 QMS Customer Response Center (CRC) A-4 World-wide offices A-5 Queues Characteristics 4-6 Creating 4-7 creating 2-19, 3-7 Example 4-7 Execution 4-8 Generic 2-5, 4-8 Managing 4-8 Merging 4-9 Naming 4-7 Pri