Downloading the PrintKit Savesets ------------------------------------------------------------------------- The downloadable PrintKit software is a VMSINSTAL kit consisting of a set of BACKUP savesets. The kit is provided as a self-extracting executable, in Digital's FTSV format: PRINTKIT022-6.A-DCX_AXPEXE Executables for AXP systems PRINTKIT022-6.B-DCX_AXPEXE PRINTKIT022-6.C-DCX_AXPEXE (don't download unless installing on VAX) PRINTKIT022-6.D-DCX_AXPEXE PRINTKIT022-6.E-DCX_AXPEXE PRINTKIT022-6.A-DCX_VAXEXE Executables for VAX systems PRINTKIT022-6.B-DCX_VAXEXE PRINTKIT022-6.C-DCX_VAXEXE PRINTKIT022-6.D-DCX_VAXEXE (don't download unless installing on AXP) PRINTKIT022-6.E-DCX_VAXEXE These are binary files. Be sure to keep this in mind if you need to transfer them between systems. (For instance, use TYPE IMAGE with FTP.) Retrieve the appropriate files for your system, then execute the files to create the files PRINTKIT022-6.%, which form the VMSINSTAL kit. For example: $ RUN PRINTKIT022-6.A-DCX_AXPEXE $ RUN PRINTKIT022-6.B-DCX_AXPEXE $ RUN PRINTKIT022-6.D-DCX_AXPEXE $ RUN PRINTKIT022-6.E-DCX_AXPEXE If you have any questions, send email to PRINTKIT@NLS.COM. Quick Start Installation ------------------------------------------------------------------------- Here are the steps required to install and configure the PrintKit software. You perform the installation using the VMSLICENSE and VMSINSTAL commands. After installing the software, you use the KITCP command, supplied with PrintKit, to configure the software for the printers on your system. Once installation and configuration are complete, PrintKit queues are available to all users on the system. If you are familiar with typical OpenVMS installation procedures, these instructions will give you a "quick start" with the PrintKit software. If you need additional information about installing or configuring the software, or you encounter problems, these instructions will direct you to additional information in later chapters. Installing PrintKit ------------------------------------------------------------------------- To install PrintKit you must be logged in to the SYSTEM account, or another account with privileges to create and modify files in the system directories. You can install the software on an active OpenVMS system without disturbing other operations. * The PrintKit VMSINSTAL kit verifies that your system configuration allows the software to operate successfully, or tells you how to make any required changes. Changing your system's SYSGEN parameters may require a reboot. If you prefer to check your configuration before performing the installation, refer to page 5-3 of the PrintKit User Manual. * Before installing PrintKit you should back up your system disk. Step 1. Register and Load License PAK Before installing PrintKit, use the VMSLICENSE command to register and load the license Product Authorization Key (PAK) supplied with your distribution kit. To load your new PrintKit license PAK, use the VMSLICENSE command: $ @SYS$UPDATE:VMSLICENSE When the license procedure prompts you, select option 1 and respond to the questions using the information from your PAK. Step 2. Install the PrintKit Software The VMSINSTAL command prompts you for the information needed to install PrintKit on your system. The installation displays progress messages, and upon completion it lists the files it has created or modified. To start VMSINSTAL, enter the following command. Make the appropriate substitution for the DEVICE and DIRECTORY when you enter the VMSINSTAL command. Specify OPTIONS N to review the release notes before performing the installation. $ @SYS$UPDATE:VMSINSTAL PRINTKIT022-6 DEVICE:[DIRECTORY] Example: $ SYS$UPDATE:VMSINSTAL PRINTKIT022-6 BERT$DKA200:[ERIK.TEMP] Here are some tips to remember during the installation: - Enter a question mark (?) after any prompt to display help information. - Most prompts display a default response, enclosed in brackets ([]), which you can select by pressing RETURN. - You may cancel the installation at any time by pressing CTRL-Y. The system will do some cleanup, which may take some time. Do not type CTRL-Y during the cleanup - this may stop the cleanup before it has removed all files from the installation, leaving an unusable combination of new and old files. VMSINSTAL asks you a series of questions as it installs the PrintKit software: - Are you logged in to the SYSTEM account? - Have you backed up your system disk? - Have you registered and loaded your license PAKs? - Do you want to purge old PrintKit files? - Do you want to run the Installation Verification Procedure? For more information on the VMSINSTAL utility, refer to the "OpenVMS System Manager's Manual: Essentials." For PrintKit's system requirements and a list of the files created or modified by the installation, refer to Chapter 5 of the PrintKit User Manual, Troubleshooting PrintKit. If you answered YES when asked if you wanted to run the Installation Verification Procedure (IVP), your installation will be verified immediately after the installation process is complete. Step 3. Review Results of Installation Verification Procedure The Installation Verification Procedure (IVP) creates a test queue (directed to a null output, so it can be used without a printer connected), prints jobs to it, and then removes it. You should see messages announcing the startup of the test queue, and submit and completion messages for each test job. You can run the IVP at any time using the PRINTKIT_IVP command: $ @SYS$TEST:PRINTKIT_IVP For help with any problems during the IVP, refer to Chapter 5, Troubleshooting PrintKit. This completes the installation of the software. To configure PrintKit queues, proceed to the next section. Configuring PrintKit Queues ----------------------------------------------------------------------------- To configure PrintKit queues, you must be logged in to the SYSTEM account, or another account with privileges to perform operator functions. You can configure queues on an active OpenVMS system without disturbing other operations. If you need more information on managing OpenVMS print queues, refer to the "OpenVMS System Manager's Manual: Essentials." Step 1. Get Ready To Configure Make sure you have done the following before starting to configure a PrintKit queue: - Enable operator messages. The PrintKit software reports configuration and printer communications problems using operator messages. These messages are an important source of information when troubleshooting problems, particularly when configuring a new queue. Enter the following command to enable delivery of operator messages to your terminal: $ REPLY/ENABLE=PRINTER - Define the KITCP command. The KITCP administration utility, provided with the PrintKit software, lets you create, display, and modify PrintKit queues. Define the KITCP command as follows: $ KITCP:==$KITCP Step 2. Collect Configuration Information Your printer should be configured and connected to your network before you configure its PrintKit queue. Once your printer is configured and connected, generate a configuration page on the printer. You will use it in creating the PrintKit queue. Consult your printer's User Manual for instructions on producing the configuration page. Step 3. Start KITCP If you enter the KITCP command with no arguments, it responds with a KITCP> prompt. You can then enter the commands you need to configure PrintKit queues. $ KITCP KITCP> You can also enter a command directly on the KITCP command line. When the command is finished, KITCP returns you directly to the system prompt. $ KITCP ADD QUEUE /INTERACTIVE queue_name KITCP accepts normal DCL command qualifiers, but it can also be told to prompt interactively for the information it needs. If you are configuring your PrintKit queues for the first time, you will probably find it much easier to use the /INTERACTIVE option when entering KITCP commands. Adding a queue interactively, you'll be shown the default setting for each prompt. PrintKit selects these defaults based on your printer model, so, for a typical configuration, you don't need to change them. You can enter a "?" at any prompt to get more information. If the answer is one of a list of choices, you can browse through the list using the up and down arrows. Step 4. Complete Checklist Complete the appropriate configuration checklist for the communications interface you will be using. Checklists appear at the end of this document, along with actual configuration examples. Most of the information needed to complete the checklist can be copied directly from your printer's configuration page. For some of the communications options you have choices - there are additional notes on those items in page 4-6 of the PrintKit User Manual. The checklists themselves also refer you to additional information. Step 5. Create Print Queue Create a print queue for your printer using KITCP's ADD QUEUE command, where queue_name is the name you have chosen for this print queue: KITCP> ADD QUEUE /INTERACTIVE queue_name KITCP asks you a series of questions; the exact questions asked vary depending on the type of printer and interface being configured. Type a "?" at any prompt for more information, and use the up and down arrows to browse through available choices. * You should complete the appropriate checklist for your printer's communications interface before answering KITCP's questions. Checklists are found at the end of this document. When all the questions are answered, KITCP returns you to the KITCP> prompt (you return to the system prompt if you entered the ADD QUEUE command on the KITCP command line. Step 6. Adjust Queue Settings The KITCP ADD QUEUE /INTERACTIVE command prompts you for the most important queue settings; certain others are left with their default values. If you make a mistake when adding a new queue, or simply wish to make changes, use the KITCP MODIFY QUEUE command. Like ADD QUEUE, MODIFY QUEUE also has an /INTERACTIVE option, and all of your orignal queue settings will be prompted as the default value. This should be enough to get you started with a typical configuration. However, there is more to KITCP. For details on configuring PrintKit, refer to Chapter 4 of the PrintKit User Manual. For descriptions of all the KITCP commands, refer to Appendix B of the PrintKit User Manual. Step 7. Check Queue Configuration and Operation You can check the settings of the queues you have configured using KITCP's SHOW QUEUE command: $ KITCP SHOW QUEUE /FULL queue-name Compare the displayed information with your checklist configuration. The /FULL option displays all configuration settings, not just those you were prompted for by the /INTERACTIVE option. Step 8. Start the Queue To start the queue: $ START/QUEUE queue-name Step 9. Verify Queue Operation You can run the Installation Verification Procedure on the queue to verify its operation. The IVP prints test files to verify the correct operation of the queue: $ @SYS$TEST:PrintKit_IVP queue-name Step 10. Make It Automatic The final step in configuring a new queue is to ensure that it starts correctly when your OpenVMS system is restarted. You can configure PrintKit queues as autostart queues, so they are started automatically by the ENABLE AUTOSTART command, or you can start them individually using START/QUEUE commands. To start the queue explicitly during system startup, add a START/QUEUE command to your System Startup File, SYS$MANAGER:SYSTARTUP_VMS.COM. To autostart the queue, use KITCP to set the autostart attribute for the queue. $ KITCP MODIFY QUEUE queue-name /AUTOSTART_ON=node::device: See the "OpenVMS System Manager's Manual: Essentials" for more information on setting up autostart queues. * Make sure your system startup procedure initializes any communications interfaces required by PrintKit queues before the queues are autostarted or started by individual START/QUEUE commands. The PrintKit software attempts to verify its printer connection when a queue is started, and it will fail if the communications interface is not yet initialized. * For a print queue using a LAT interface, make sure you add the LATCP CREATE PORT for the queue's LAT device to the system startup procedure. This completes the queue configuration. TCP/IP Socket Configuration Checklist --------------------------------------------------------------------------- OpenVMS Print Queue Configuration: ________________ Node Name - the name of the node where the queue will run. ________________ Queue Description String - A description to help you identify this queue (Text String). Printer Configuration: ________________ Printer Model - Type KITCP SHOW MODEL to display a list of known models, and select the one that matches your printer. ________________ Printer Emulations - Is the printer capable of printing PostScript jobs? PCL jobs? Communications Protocol Configuration: ________________ Printer IP Address - As indicated on the printer's configuration page. See page 4-7 of the PrintKit User Manual for information on assigning IP addresses. ________________ Local Node IP Address - The IP address of the system where PrintKit is installed. **Used with PrintKit's built-in TCP/IP ONLY** If you are running a Layered TCP/IP product on your VMS machine (eg UCX, Multinet, etc), you should leave this setting blank. TCP/IP Socket Example Configuration: $ KITCP ADD QUEUE /INTERATIVE PRINTKIT_TEST KITCP interactive configuration. Press '?' at any time for help on a query. Use arrow keys to browse through available options. Queue description string: Queue for HP 5SI in Room 302 EXECUTION, GENERIC or LOGICAL queue? EXECUTION Node on which queue will run: BERT Printer model name: HP LaserJet 5SI Printer emulations separated by commas: TRANSPARENT,POSTSCRIPT,PCL Job control languages separated by commas: PJL Communications protocol: TCP_SOCKET Printer IP address: 204.242.123.207 TCP/IP port number: 9100 Status returned by printer (YES/NO)? YES Synchronization: SYNCH Use the Printer Ethernet Protocol (PEP) (YES/NO)? NO TCP/IP lpr/lpd Configuration Checklist --------------------------------------------------------------------------- OpenVMS Print Queue Configuration: ________________ Node Name - the name of the node where the queue will run. ________________ Queue Description String - A description to help you identify this queue (Text String). Printer Configuration: ________________ Printer Model - Type KITCP SHOW MODEL to display a list of known models, and select the one that matches your printer. ________________ Printer Emulations - Is the printer capable of printing PostScript jobs? PCL jobs? Communications Protocol Configuration: ________________ (Default is PS) What lpr/lpd queue name is indicated on the printer configuration page? ________________ Printer IP Address - As indicated on the printer's configuration page. See page 4-7 of the PrintKit User Manual for information on assigning IP addresses. ________________ Local Node IP Address - The IP address of the system where PrintKit is installed. **Used with PrintKit's built-in TCP/IP ONLY** If you are running a Layered TCP/IP product on your VMS machine (eg UCX, Multinet, etc), you should leave this setting blank. TCP/IP lpr/lpd Example: $ KITCP ADD QUEUE /INTERACTIVE PRINTKIT_TEST KITCP interactive configuration. Press '?' at any time for help on a query. Use arrow keys to browse through available options. Queue description string: Apple Color LaserWriter 12/600 in Printing Room EXECUTION, GENERIC or LOGICAL queue? EXECUTION Node on which queue will run: BERT Printer model name: Apple Color LaserWriter 12/600 Printer emulations separated by commas: TRANSPARENT,POSTSCRIPT,PCL Job control languages separated by commas: AIS Communications protocol: TCP_LPR Remote lpr queue name: LaserWriter2 Printer IP address: 204.242.123.207 Lpr queue requires an accurate byte count (YES/NO)? YES Spool directory: SYS$COMMON:[SYSMGR] Use the Printer Ethernet Protocol (PEP) (YES/NO)? NO LAT Configuration Checklist: ----------------------------------------------------------------------------- OpenVMS Print Queue Configuration: ________________ Node Name - the name of the node where the queue will run. ________________ Queue Description String - A description to help you identify this queue (Text String). Printer Configuration: ________________ Printer Model - Type KITCP SHOW MODEL to display a list of known models, and select the one that matches your printer. ________________ Printer Emulations - Is the printer capable of printing PostScript jobs? PCL jobs? Communications Protocol Configuration: ________________ Printer LAT Port Name - Which interface of server LAT port is the printer connected to? ________________ Printer LAT Node Name - What is the printer network interface or network print server LAT Node Name? Example LAT Queue: $ KITCP ADD QUEUE /INTERACTIVE PRINTKIT_TEST KITCP interactive configuration. Press '?' at any time for help on a query. Use arrow keys to browse through available options. Queue description string: HP LaserJet 3Si w/ XCD Xjet card EXECUTION, GENERIC or LOGICAL queue? EXECUTION Node on which queue will run: BERT Printer model name: HP LaserJet IIISI Printer emulations separated by commas: TRANSPARENT,POSTSCRIPT,PCL Job control languages separated by commas: PJL Communications protocol: LAT Printer LAT port name: P1 Printer LAT node name: XCD_00069C Device to which the queue will connect: LTA100: Status returned by printer (YES/NO)? YES Synchronization: SYNCH