Trigger and Data Capture Guide
Copyright Information Copyright © 1994-2007 Objectif Lune Inc. All Rights Reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other language or computer language in whole or in part, in any form or by any means, whether it be electronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent of Objectif Lune Inc. Objectif Lune Inc.
OBJECTIF LUNE PLANETPRESS SUITE END USER LICENSE AGREEMENT AND LIMITED WARRANTY IMPORTANT - READ CAREFULLY 1. LICENSE AGREEMENT AND LIMITED WARRANTY AGREEMENT. - This End User License Agreement (“EULA”) and Limited Warranty (hereinafter collectively the “License Agreement”) constitute a legal agreement between you (either as a physical, legal person (e.g. corporation) or a partnership) and Objectif Lune Inc.
Objectif Lune’s and its suppliers’ liability and the exclusive remedy shall be, at Objectif Lune’s sole option, either (a) return of the price paid, or (b) repair or replacement of the Software if it does not meet Objectif Lune’s Limited Warranty and if returned to Objectif Lune with a copy of your receipt. No warranty is given by Objectif Lune for and in the name of any of its suppliers.
Table of Contents 1 Capturing Data 1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Key Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Detailed Directions . . . . . . . . . . . . . . . . . . . . . . . . . .
toc Appendix A: Special Printer Requirements 93 HP Printers with Flash Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Lexmark Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Printers with Automatic Emulation Switching . . . . . . . . . . . . . . . .
Capturing Data This chapter provides procedures for capturing data on different platforms.
1 Capturing Data • “What is a spool file?” (p. 2) Key Concepts Sample Data File What is a sample data file? The sample data file is a text file that contains a representative sample of the input data destined for the document, as that input data arrives at a printer or a PlanetPress Watch process. You use a data capture process to create a sample data file. You create your document based on the contents of this sample data file.
Detailed Directions Detailed Directions Capture Sample Data for a Document You Install on a Printer This procedure describes the general steps involved in capturing sample data for a document you intend to install on a printer. If you are using database emulation, you capture sample input data at the time you set up the emulation. An understanding of the general procedure for capturing a reliable sample data file can help you understand and navigate the platform-specific instructions.
1 Capturing Data • Retrieve the spool file. • Restart printing on the printer you paused. Things to Remember • As a rule you want to capture the data as close to the printer as possible since the data file may undergo several transformations as it makes its way through drivers, spoolers, or physical devices. If your printer is not yet connected, you will need to anticipate how it will fit into your network configuration.
Detailed Directions 4. Capture the sample of input data. What follows is a general outline of the procedure. Consult the specific data capture procedure for your platform, and the PlanetPress Watch User’s Guide for help setting up PlanetPress Watch processes. • Create a PlanetPress Watch process to accept the data through the input mode you specify and save the result as a file in a folder.
1 Capturing Data 9. In the Windows Start menu, choose Settings, then choose Printer. The Printers window appears. 10. Right-click on the printer you paused and choose Pause printing. The spooler sends the job to the printer. Capture Sample Data in Windows 2000/Server 2003/XP You perform this procedure on the machine that controls the printer, not on the workstation. 1. In the Windows Start menu, choose Settings, then choose Printer. The Printers window appears. 2.
Detailed Directions Capture Sample Data in Windows Host Using a Novell Print Server This procedure describes how to capture data for a document you intend to execute using a Novell print server. To capture data on a Windows host that uses a Novell print server: 1. Start the NetWare Administrator. 2. In the NetWare Administrator window, double-click the print server in the list of printers. For the purposes of this procedure, the print server is the optra1650s-nds.
1 Capturing Data Capture Sample Data in UNIX (Solaris) Create a Virtual Printer To create a virtual printer: 1. In the File Manager, choose File and then Open Terminal. 2. Use the following commands to open the Hosts file: cd /etc vi ./hosts 3. In the Hosts file, add the IP address of the printer, or the IP address of the workstation on which PlanetPress Watch is installed, and assign a name to that IP address. For example: 192.xxx.yyy.zzz printdestination 4. Save the Hosts file as follows: Press ESCAPE.
Detailed Directions Send Data to the Print Queue To send data to the print queue: • Use the command: lp -d queuename data_filename Note that you must create a PlanetPress Watch process before you send data from UNIX to the workstation running PlanetPress Watch. PlanetPress Watch Configuration To set up PlanetPress Watch to capture data sent using LPR: 1. In PlanetPress Watch Configuration, create a new PlanetPress Watch process by choosing Insert | New Process. 2.
1 Capturing Data Capture Sample Data using an AS/400 Systems Generic Output To create a generic output queue on an AS/400: 1. In the AS/400 main menu, enter the create output queue command CRTOUTQ and press F4.
Detailed Directions 2. In the Change Output screen, in the Output queue field, enter an output queue name. In this example, the name entered is OUTQ1. 3. Press F10 followed by F9 to display the Remote Printer Queue parameter. 4. Enter the following information: • In the Remote system field, enter the string *INTNETADR. • In the Remote printer queue field, enter the name of the remote printer queue, enclosed in single quotes.
1 Capturing Data 5. Press PAGE DOWN to display the Create Output Queue screen. 6. Complete the fields with the following values. Unless otherwise specified, you must enter these values exactly as they appear here. Writers to autostart: 1 Connection type: *IP Destination type: *OTHER Host print transform: *YES Manufacturer type and model: *WSCST WS customizing object: QWPDEFAULT Library: QSYS Internet address: The IP address of the workstation to which you will send the data.
Detailed Directions The next page of the Create Output Queue screen appears. 8. If you want to prevent a separator page from printing, enter *NO in the Print separator page field. Leave all other fields untouched. 9. Press ENTER to create the new generic output queue. A confirmation message appears at the bottom of the main menu.
1 Capturing Data Capture Sample Data From a Serial Port This procedure describes how to use Microsoft’s Hyperterminal to capture serial data. Refer to the PlanetPress Watch User’s Guide for information on capturing serial data using PlanetPress Watch’s Serial input. To set the serial data capture parameters: 1. In the Windows Start menu, choose Programs | Accessories | HyperTerminal. If necessary, install Windows HyperTerminal. The Connection Description dialog box appears. 2.
Detailed Directions The COM2 Properties dialog box appears. 4. Adjust the COM2 Properties and click OK. A HyperTerminal window for this connection appears. 5. In the menu for the HyperTerminal window, choose Transfer | Capture Text. The Capture Text dialog box appears. 6. The file name that appears in this dialog box is Capture.txt. If this file does not exist, you will need to create it (this is the text file that will be used as the capture file). 7. Click Start. 8.
1 Capturing Data 16
Creating Triggers This chapter describes platform-specific procedures for creating a trigger and inserting it at the head of a data stream. Overview A job consists of a document, a trigger, and data. If you are not using PlanetPress Watch, you must manually create the appropriate trigger, add it to the head of the data stream, and send the result to the printer on which the document resides. The procedure for creating the trigger and adding it to the head of the data stream is platform-dependent.
2 Creating Triggers • “Prepare SAP Device Type for PlanetPress Design” on page 85 • “Implement a Trigger under HP 3000” on page 91 In addition, you will be able to answer the following questions: • “What is a trigger?” (p. 18) • “What is the syntax of a trigger?” (p. 19) • “What are the common techniques for inserting a trigger?” (p.
Key Concepts As an example, the following trigger includes as an end of job character: %!PS-Adobe run INVOICE Trigger Syntax What is the syntax of a trigger? In all syntax descriptions in this section, italics denote a variable, square brackets indicate the element is optional, denotes a carriage return and denotes a line feed.
2 Creating Triggers Trigger Syntax for Documents Installed in RAM The general syntax of a trigger for a document that resides in the printer’s RAM is: [ printer-specific_commands ] %!PS-Adobe name_of_document An example of the trigger for a document named FORMLETTER that resides in the printer’s RAM: %!PS-Adobe FORMLETTER Trigger Syntax for Documents Installed in Flash Memory The general syntax of a trigger for a document that resides in the printer’s flash memory is: [ printe
Detailed Directions 3. Setting up the host to automatically insert triggers This is the same technique as setting up the print server to automatically insert triggers. The only difference here is that you set up the queues on the host on which the input data resides. The host inserts the trigger ahead of the spool file when it sends the print job to the printer. This technique does not work with all hosts. 4.
2 Creating Triggers 5. In the New Device Name dialog box, enter the name of the document you want to execute. For this example, enter Mailing. 6. In the Defined Print Devices dialog box, select Mailing and press ENTER. 7. In the Edit Device Options dialog box, select Device Functions. 8. Press INSERT. 9.
Detailed Directions 10. Press ESCAPE. In the Save Changes dialog box, select Yes and press ENTER to save the changes. 11. In the Mailing Functions dialog box, press INSERT. 12. In the Function Definition dialog box, enter the following information: • In the Name field, enter Force PostScript • In the Escape Sequence field, enter the following sequence: %-12345X@PJL enter language = PostScript 13. Press ESCAPE. In the Save Changes dialog box, select Yes and press ENTER to save the changes.
2 Creating Triggers • In the Escape Sequence field, enter the following sequence: (MAILING) run MAILING 15. Press ESCAPE. In the Save Changes dialog box, select Yes and press ENTER to save the changes. 16. Press ESCAPE again. In the Edit Device Options dialog box, select Device Modes. The Mailing Modes dialog box appears. 17. In the New Mode Name dialog box, press INSERT and enter Call Mailing. 18. In the Call Mailing Functions dialog box, press INSERT.
Detailed Directions 19. In the Additional Mailing Functions dialog box, select Force PostScript and press ENTER. 20. The Call Mailing Functions dialog box should display Force PostScript. 21. Press INSERT. 22. In the Additional Mailing Functions dialog box, select Call Mailing. 23. Press ENTER. 24. Press ESCAPE to return to the Mailing Modes dialog box.
2 Creating Triggers 25. In the Mailing Modes dialog box, select (Re-initialize). 26. In the (Re-initialize) Functions dialog box, press INSERT. 27. In the Additional Mailing Functions dialog box, select Reset and press ENTER. 28. The (Re-initialize) Functions dialog box displays Reset. 29. In the Exit PrintDef dialog box, select Yes to save the changes.
Detailed Directions 30. In the Exit Options dialog box, select Save Data Base, then EXIT. 31. Press ESCAPE several times to exit Printdef. 32. In DosPrompt, enter Printcon. 33. In the Available Options dialog box, select Edit Print Job Configurations. 34. Press INSERT. 35. In the Enter new name field, enter Mailing. 36. Press ENTER. 37. In the Edit Print Job Configuration "Mailing" dialog box, adjust only the following settings. Leave all others untouched.
2 Creating Triggers Print Banner: No 38. Press ESCAPE and save the changes. To test the trigger installation: 1. In DosPrompt, enter pconsole to access pconsole. 2. In the Available Options dialog box, select Print Queue Information and press INSERT. 3. In the New Print Queue Name field, enter MAILING. 4. In the Print Queues dialog box, select Mailing and press ENTER.
Detailed Directions 5. In the Print Queue Information dialog box, select Current Queue Status. 6. In the Current Queue Status dialog box, select No for the Servers can service entries in queue option. 7. Press ESCAPE several times to exit pconsole. 8. In the DOS prompt, enter the following line: /l=2 represents the LPT port to which the printer is connected. In this example, it is LPT2. 9. Return to pconsole. 10. In the Available Options dialog box, select Print Queue Information.
2 Creating Triggers 11. In the Print Queues dialog box, select Mailing. 12. In the Print Queue Information dialog box, select Print Queue ID. The following dialog box appears. 13. Make a note of the Object ID. 14. Press ESCAPE several times to exit pconsole. 15. In DOS, enter the following to create a sample spool file: c:\>dir>lpt2 16. In the drive on which the Sys Volume is mounted, enter the following lines: Y:\>cd system Y:\SYSTEM>dir *.
Detailed Directions The following appears. 18. Using the information located in the directory, enter the last line. In this case: Y:\SYSTEM\2F00000B.QDR>type oo2f0001.q :more 19. If no error occurs, the trigger and printer queue test is successful. The trigger appears at the start of the file. 20. In the pconsole > Print Queue Information > Current Queue Status dialog box, change Servers can service entries in queue to Yes. Implement a Trigger under Novell 4.x and 5.
2 Creating Triggers 2. Right-click Organizational Unit and choose Details. The Organizational Unit: Printers dialog box appears. 3. Click Print Devices (Non NDPS). 4. Click Create. The Create New Device dialog box appears. 5. In the Create New Device dialog box, enter a descriptive name for the printer on which you intend to print the document, then click OK or press ENTER. 6. Select the newly created print device and click Modify. 7. You must now create three functions and a mode.
Detailed Directions • In the Control sequence box, enter %-12345X 10. Click OK. CREATE THE SECOND FUNCTION 11. Return to the Create New Function dialog box. 12. In the Create New Function dialog box, enter the following information: • In the Function name box, enter Force Postscript. • In the Control sequence box, enter %-12345X@PJL enter language = PostScript 13. Click OK. CREATE THE THIRD FUNCTION 14. Return to the Create New Function dialog box. 15.
2 Creating Triggers • In the Control sequence box, enter (MAILING) run MAILING. 16. Click OK. DEFINE THE MODE 17. In the Modify Existing Device dialog box, click Create Mode. 18. In the Name box, enter a meaningful name. For this example, enter Mailing.
Detailed Directions 19. Select the three functions you just created, in the following order: reset, Force Postscript, call mailing. For each function, select it in the Device functions list, then click Add Below. The order in which you select the functions is important. 20. Click OK. The Print Device is created with its functions and mode. 21. Create the Print Job Definition. You must create the Print Job Definition in the Organizational Unit that contains the user's object or the object used by the user.
2 Creating Triggers The Organizational: ol dialog box appears. 22. Click Print Job Configuration (Non NDPS). 23. Click New. The Print Job Configuration dialog box appears. 24. In the Print Job Configuration dialog box, enter the following: • In the Print job name box, enter a descriptive name. For this example, enter Mailing. • Clear the Print banner and From feed boxes. • In the Printer/Queue box, enter the printer on which you intend to execute the document. The queue can be NDS or Bindery.
Detailed Directions • In the Mode box, select the name of the mode you created. 25. Close the Netware Administrator. 26. You must now configure the client's (user's) portion. First, use the Capture command to direct the network printer to a port such as LPT1. You must also use the J option in the command to include your "job definition". The following command works with the above example: CAPTURE Q=.OPTRA1650-NDS-PQ.PRINTERS.
2 Creating Triggers 27. Once you execute the Capture command (either locally or via Novell scripts), you must create a new printer in the user's Windows using the Generic Text pilot that points towards the local LPT1 port. You create the new printer as follows: Users that perform the capture (with the J option) and have a generic printer pointing towards the LPT1 port can use the document configured in the Print Job Configuration.
Detailed Directions Note that certain versions of Windows have Generic Text pilots that can cause a well known problem: text aligned vertically instead of horizontally. To solve this problem, access the printer's properties. In the Fonts tab, add a space in every Font codes section. Implement a Trigger under Windows NT 4.0 with TCP/IP Use this procedure when you print from a Windows NT 4.0 application or from Windows NT 4.0 itself. First determine the network protocol (TCP/IP, NetBios, or IPX/SPX).
2 Creating Triggers The Network dialog box appears. 3. In the Services tab, click Add. The Select Network Service dialog box appears. 4. In the Select Network Service dialog box, select Microsoft TCP/IP Printing and click OK. 5. Reboot your PC.
Detailed Directions Install a New LPR Printer To install a new LPR printer in Windows NT: 1. In the Windows Start menu, choose Settings | Printers. The Printers window appears. 2. In the Printers window, double-click Add Printer. The Add Printer Wizard dialog box appears. 3. Select My Computer and click Next. 4. In the next window, select Add Port.
2 Creating Triggers The Printer Ports dialog box appears. 5. In the Printer Ports dialog box, double-click LPR Port. The Add LPR Compatible Printer dialog box appears. 6. In the Name or address of server providing lpd box, enter the printer's TCP/IP address. 7. If the printer has multiple ports, add a queue name in the Name of printer or print queue on that server box. 8. Click OK.
Detailed Directions The Add Printer Wizard window appears. 9. Select the TCP/IP address you entered in the Add LPR Compatible Printer dialog box. Note that if you have several documents installed on the same printer, it is important to install a printer in Windows NT for each document. 10. Click Next. 11. In the Manufacturers list, select Generic, and in the Printers list, select Generic / Text Only. 12. Click Next.
2 Creating Triggers 13. In the Printer name box, enter the name given to the intelligent document. In this example, the printer's name is Mailing. 14. Click Next. 15. Select Shared and enter the document name in the Share Name box (Mailing for this example). 16. Select all applicable operating systems. Create a Trigger To create a trigger: 1. In the Windows NT System32 directory, double-click the Notepad application icon.
Detailed Directions The system32 window appears. 2. In a new Notepad file, enter the name of your document file immediately after the \F (no space). For this example, enter: \N \FMAILING.TRG. 3. Save this file in the system32 directory under the same name given to your document (with the suffix .sep (a Page separator under Windows NT)). For this example, MAILING.sep. 4. Open another file in Notepad and enter the trigger described in the Introduction section. %!PS-Adobe (MAILING) run MAILING 5.
2 Creating Triggers The Mailing Properties dialog box appears. 3. In the General tab, click Separator Page. The Separator Page dialog box appears. 4. Click Browse and select mailing.sep. 5. Click Open. The trigger is now installed for Windows NT.
Detailed Directions Implement a Trigger under BSD Printing Systems (BSDi, FreeBSD, Linux) The procedure here describes trigger implementation for UNIX systems using a BSD-like printing system (lpr, lpq, /etc/printcap). It assumes you are logged on as root. To install a BSD printing system: 1. Create a text-only print queue entry in /etc/printcap and a spool directory. If your system has a tool to create a print queue, use it to create a text-only queue. Make sure no input filter is used (i.e.
2 Creating Triggers 5. Set the permissions on the input filter file so that it can be executed from root. Use the chmod command as follows, replacing mailing.scr with the name of your input filter file: chmod 755 /var/spool/lpd/mailing.scr 6. Edit the printcap file to add the input filter to the queue definition. Your entry should now look like this: mailing:\ :sd=/var/spool/lpd/mailing:\ :mx#0:\ :sh:\ :lp=/dev/lp1:\ :if=/var/spool/lpd/mailing.
Detailed Directions If you want to send the print job to a remote LPD server, use rm= to specify the remote print server, and rp= to specify the remote queue name. You specify the remote print server in the rm field using either the IP address or host name. For example: mailing:\ :sd=/var/spool/lpd/mailing:\ :mx#0:\ :sh:\ :rm=192.168.100.147:\ :rp=default: To create a spool directory by hand: • Use the following command, replacing mailing with the name you want to use for the spool directory.
2 Creating Triggers exit Edit a Script File To edit a script file: 1. Issue the following commands: cd /etc/lp/interfaces vi ./myscriptfile 2. In the vi text editor, use the dG command to delete all default text inside the script file. 3. Enter the following text inside your script file: #!/bin/sh # options=$5 shift 5 for FILE in $* do cat /etc/lp/interfaces/mytrigger $FILE | lp -d queuename -t $FILE done exit 0 4. Save your script file and exit the editor (press ESCAPE, then enter :wq). 5.
Detailed Directions 3. Enter the following text inside your trigger file. It assumes your document resides on the hard drive of the printer. In this example, MYDOCUMENT is the name of the document. This name appears on the confirmation sheet that prints when you install the document on the printer's hard drive. %!PS-Adobe (MYDOCUMENT) run MYDOCUMENT 4. Save your script file and exit the editor (press ESCAPE, then enter :wq).
2 Creating Triggers 3. Select Print Spooling. 4. Select Add a Print Queue.
Detailed Directions 5. Select Local. 6. Select Other, regardless of the type of printer.
2 Creating Triggers 7. Select Generic, regardless of the type of printer. 8. Select parallel or rs232.
Detailed Directions 9. Select the appropriate adapter(s). . 10. Enter the following values: ASCII: Name of virtual printer that prints from operating systems. GL Emulation: Laser printer configured on a workstation and used for Windows printing. Port number: Number of ports on the serial communication card. Baud rate: Port speed. Parity: Parity type. Flow control: Printer's protocol type. Printer time out: Time a printer can time-out before being DOWN.
2 Creating Triggers State to be configured at boot time: Always be at AVAILABLE. To add a physical or virtual printer connected to a Jet Direct: 1. In the /etc/hosts file, enter the IP address and print server name.
Detailed Directions 2. Follow step 1. through step 5. in “To add a physical or virtual printer in series:” on page 51. In step 5. select hpJetDirect. 3. Select Other, regardless of the type of printer.
2 Creating Triggers 4. Select Generic, regardless of the type of printer. 5. Select Do NOT make this system a BOOT/TFTP server. 6. Enter the following values: ASCII: Name of printer for AIX, Basic and Informix printing.
Detailed Directions GL Emulation: Laser printer configured on a workstation and used for Windows printing. HOSTNAME: Name entered in the /etc/hosts file. Port number: For JetDirect: 9100. For a three-port: Port 1 = 9100, Port 2 = 9101, Port 3 = 9102. To add a physical or virtual printer configured on another server: 1. In the /etc/hosts file, enter the IP address and print server name. 2. Follow step 1. through step 5. in “To add a physical or virtual printer in series:” on page 51.
2 Creating Triggers 3. Select Remote. 4. Select Local Filtering.
Detailed Directions 5. Select Other. 6. Select Generic. 7. Enter the following values: ASCII: Name of printer for AIX, Basic and Informix printing.
2 Creating Triggers GL emulation: Laser printer configured on a workstation and used for Windows printing. HOSTNAME: Name entered in the /etc/hosts file. Queue name: Name of the printing queue on the other server. Backend time-out: Length of time, in seconds, the AIX server waits for information from the printer before disconnecting the printer. The recommended value is 30. To add a new print queue on an existing device: 1. Follow step 1. through step 8.
Detailed Directions Existing printer: To edit a new queue on the lp printer/device, select the appropriate printer. 3. Enter the name of the new printer.
2 Creating Triggers To modify the attributes of virtual printers: 1. Log in as dyaddm. 2. Execute Smit Printer. 3. Select Programming Tools.
Detailed Directions 4. Select Change / /Show Printer Attribute Database (Virtual Printers). 5. Select the virtual printer to modify. 6.
2 Creating Triggers Z: ! _j: ! _l: 0 _w: 255 cr: %Iac Implement a Trigger under VMS To create a text library: 1. The following is an example of a command used to create a text library.
Detailed Directions 2. The following displays the details of the text library. A A. VMS executable file (similar to a DOS batch file) 3. The following displays details of the information in the text library. A B A. Name of the text library (.TLB extension) B.
2 Creating Triggers 4. The following displays details of a port configuration for a LAT device: 5. The following displays details of a port configuration for type Decserver 90LT: Triggers for Systems 36 and 3270 You must execute this procedure from the application you use to process the data.
Detailed Directions To install a trigger: 1. Enter the following lines, substituting INVOICE for the name of your document. These lines initialize the printer in PostScript language and call the appropriate document (INVOICE in this example). They must precede the data stream.
2 Creating Triggers The following window appears. 3. Enter the following data: Manufacturer type and model: *NONE. Source member: Name of the source to retrieve. Source file: Location in which to store the source file member. Library: Location in which to store the source files. Type description: Short text description of the source file. This description should be unique. 4. Press ENTER.
Detailed Directions A confirmation message appears. Member SRCLUNE added to file QTXTSRC in OBJLUNE. To edit the WSCST source: 1. At the command line, enter STRSEU and press F4.
2 Creating Triggers The following window appears. 2. Enter the source file name. For this example, QTXTSRC. 3. Enter the library name. For this example, OBJLUNE. 4. Press ENTER.
Detailed Directions The following window appears. 5. In the Opt column, enter 2 and press ENTER. The following window appears.
2 Creating Triggers 6. Replace INITPRT DATA = ' 00 ' X. by the following INIT string: :INITPRT DATA = '1B252D31323334355840504A4C20656E746572206C616E67756167'X '65203D20506F73747363726970740D0A'X '28464F524D292072756E20464F524D0D0A'X. The INITPRT string is the hexadecimal representation of the trigger. In the example, the trigger is: %-12345X@PJL ENTER LANGUAGE=POSTSCRIPT (FORM) run FORM In the example, the name of the document is FORM.
Detailed Directions (FORM) run FORM 8. Press ENTER. The following confirmation message appears: Member SRCLUNE in file OBJLUNE/QTXTSRC changed with 19 records. 9. Press F3 to save the new WSCST.
2 Creating Triggers The following window appears. 10. In the Change/create member line, enter Y, and press ENTER to confirm the save.
Detailed Directions The following confirmation message appears. Member SRCLUNE in file OBJLUNE/QTXTSRC changed with 19 records. To create the WSCST: 1. At the command line, enter CRTWSCST and press F4.
2 Creating Triggers The following window appears. 2. Press F10 to display additional parameters. 3. Enter the name of the workstation customizing object that you want to create, and the library name for the customizing object (the one previously changed). 4. In the Additional Parameters section, enter the following: Source file: Enter the name of the source QTXTSRC. Library: Enter the name of the library containing the source file.
Detailed Directions The following confirmation message appears. The object LUNE customization has successfully been created. If the creation of the WSCST was not successful, verify that the hexadecimal code for the INITPRT and RESETPRT strings is correct. Once you create the WSCST, you can use it in an output queue. Use the WSCST in an Output Queue Note that the following procedure is the same as the one described in the Capturing Data section of this guide, except for 3 information lines.
2 Creating Triggers 2. In the first screen, do not change anything. 3. In the second screen, enter the following: Manufacturer type and model: *WSCST WS customizing object: Name of the WSCST that you have just created (LUNE in our example).
Detailed Directions Library: *LIBL 4. In the third screen, enter the following: Text description: Short text describing the WSCST used with the output queue.
2 Creating Triggers You can now use the output queue with the new WSCST to trigger execution of your document. The next step is to create an LPD queue in PlanetPress Watch. Twinax Printing This section explains how to configure your system to print with a Twinax connection.
Detailed Directions 2. Create a permanent file (one file per document, each with a unique name). This name must be WATCHWORK in the OBJLUNE library. WATCHWORK is hard coded in the CL program included in this guide. CRTPF FILE(OBJLUNE/WATCHWORK) RCDLEN(132) 3.
2 Creating Triggers *** &outputqslb: Library of the print queue (source). *** &outputqd: Final print queue (destination after the spool file has been modified). *** &outputqdlb: Library of the final print queue (destination after the spool file has been modified). *** &triggerfn: Physical file, which contains the string used for the trigger. *** &triggerlib: Library or file where the trigger is located.
Detailed Directions Prepare SAP Device Type for PlanetPress Design PlanetPress Design is a PC-based software that merges output data from the source system. In order for PlanetPress Design to work with SAP, you must make changes to the spool device type. To modify the spool device type in SAP: 1. Run SPAD and select Full Administration. The Spool Administration: Initial Screen window appears. 2. Click the red pencil icon to change to edit mode. 3. In the Device types section, click Page formats. 4.
2 Creating Triggers 9. Click the left-pointing checkmark in the toolbar to return to the previous window. 10. Click Formats and create a new format. 11. Enter the name ZLETTER again. 12. In the Spool Administration: Format Type (Change) window, assign the LETTER page format created in step 4. to the new format ZLETTER. 13. Click the left-pointing checkmark in the toolbar to return to the previous window. 14. Click Device types to display the list of device types. 15. Select For dev.
Detailed Directions 18. Double-click the ZASCIIxx device type to display the corresponding window. 19. Click Formats.
2 Creating Triggers The Spool Admin.: List of Formats for Device Types (Change) window appears. 20. Click the paper icon to add a new format to the list. The Spool Admin.: List of Formats for Device Types (Change) dialog box appears. 21. In the Format box, select ZLETTER. 22. Click the checkmark and close the window.
Detailed Directions The Spool Administration: Maintain Format for Device Type window appears. 23. Double-click Printer initialization. The Print init. window appears.
2 Creating Triggers 24. Enter the following PJL codes provided byPlanetPress Design. 25. Save changes. 26. Assign the device type to the output device that you use to print documents. PJL codes are now set up in SAP to control the output from SAP and merge it with the document created and installed in the printer's memory using PlanetPress Design.
Detailed Directions Implement a Trigger under HP 3000 To create a trigger on an HP 3000: 1. Enter the required information in the appropriate fields. 2. Click Save Data. 3. Enter ENVPP01.HPENV.SYS (for environment PlanetPress Design 01) for the environment file. Be careful with the special characters. 4. Enter a name for the document. For example, ARRANGL.
2 Creating Triggers !FILE OUT=TAXEANG;DEV=402,1;ENV=ENVPP05.HPENV.
Special Printer Requirements This appendix describes requirements specific to individual printers. HP Printers with Flash Memory If an HP printer has only flash memory, the storing command in the flash memory is the same as if the document was stored on a hard drive (with this type of printer, the default is the hard drive). If the HP printer has both flash memory and a hard drive, you can use either one or the other storing command, according to your needs.
A To set a parallel or INA port for binary data: 1. To switch to binary mode, enter the following (ASCII off): %!PS true 0 startjob currentsystemparams /CurInputDevice get << /Filtering /None >> setdevparams 2. To switch to ASCII mode, enter the following (Binary off): %!PS true 0 startjob currentsystemparams /CurInputDevice get << /Filtering /InterpreterBased >> setdevparams Note that these files are port specific.
ASCII Conversion Table This appendix provides a table for converting among ASCII, hexadecimal, decimal and octal values.
B Dec 96 Hx Oct Char 13 0D 015 CR (carriage return) 14 0E 016 SO (shift out) 15 0F 017 SI (shift in) 16 10 020 DLE (data link escape) 17 11 021 DC1 (device control 1) 18 12 022 DC2 (device control 2) 19 13 023 DC3 (device control 3) 20 14 024 DC4 (device control 4) 21 15 025 NAK (negative acknowledge) 22 16 026 SYN (synchronous idle) 23 17 027 ETB (end of trans.
ASCII Conversion Table Dec Hx Oct Char 46 2E 056 .
B 98 Dec Hx Oct Char 79 4F 117 O 80 50 120 P 81 51 121 Q 82 52 122 R 83 53 123 S 84 54 124 T 85 55 125 U 86 56 126 V 87 57 127 W 88 58 130 X 89 59 131 Y 90 5A 132 Z 91 5B 133 [ 92 5C 134 \ 93 5D 135 ] 94 5E 136 ^ 95 5F 137 _ 96 60 140 ` 97 61 141 a 98 62 142 b 99 63 143 c 100 64 144 d 101 65 145 e 102 66 146 f 103 67 147 g 104 68 150 h 105 69 151 i 106 6A 152 j 107 6B 153 k 108 6C 154
ASCII Conversion Table Dec Hx Oct Char 112 70 160 p 113 71 161 q 114 72 162 r 115 73 163 s 116 74 164 t 117 75 165 u 118 76 166 v 119 77 167 w 120 78 170 x 121 79 171 y 122 7A 172 z 123 7B 173 { 124 7C 174 | 125 7D 175 } 126 7E 176 ~ 127 7F 177 DEL 99
B 100
CL Program for AS/400 Systems This appendix provides the CL program you use with AS/400 systems. CL Program for AS/400 Systems PGM PARM(&WATCHPRTFN &WATCHPRTFL &OUTPUTQS + &OUTPUTQSLB &OUTPUTQD &OUTPUTQDLB + &TRIGGERFN &TRIGGERLIB) / ************************************************************* ************/ / * WATCH */ /* THIS PROGRAM IS USED TO INTERCEPT SPOOLFILES FROM AN OUTPUT QUEUE AND */ /* TO INSERT A TRIGGER.
C /* TRANSFERRED TO THE DESTINATION OUPTUT QUEUE. */ /* */ /* AUTEUR : STEVE FLEURY /* CIE INC.
CL Program for AS/400 Systems /* &SPLFNAME SPOOLFILE : NAME ATTRIBUTE OF /* &SPLFUSER SPOOLFILE : USER ATTRIBUTE OF /* &SPLFSTS SPOOLFILE : STATUS ATTRIBUTE OF /* &SPLFJOB SPOOLFILE : JOB ATTRIBUTE OF /* &SPLFNB SPOOLFILE : NUMBER ATTRIBUTE OF */ */ */ */ */ /* &WATCHPRTFN: NAME OF PRINTER FILE USED TO CREATE THE NEW SPOOLFILE */ /* &WATCHPRTFL: NAME OF THE LIBRARY OF PRTFILE */ /* */ / ************************************************************* ************/ DCL VAR(&OUTPUTQS) TYPE(*CHAR) L
C DCLF FILE(OBJLUNE/WATCHWORK) / ************************************************************* ************/ /* CREATE THE TEMPORARY FILE NEEDED DURING THE PROGRAM */ / ************************************************************* ************/ CRTPF FILE(QTEMP/TRANSITF) RCDLEN(200) + TEXT('file to build the new spoolfile') MONMSG MSGID(CPF7302) /* file already exists */ / ************************************************************* ************/ /* TAKE A SNAPSHOT OF THE OUTPUT QUEUE IN A FILE AND
CL Program for AS/400 Systems /* READ THE CONTENT OF THE WORKFILE TO DETERMINE IF THERE ARE SPOOLFILES */ /* TO BE TREATED. IF THE SPOOLFILE STATUS IS NOT RDY THIS IS BECAUSE */ /* WE ARE IN THE HEATHER LINES OR THE STATUS IS HLD OR SAV, ETC...
C /* SPOOLFILE IN TRANSIT. THE PROCEDURE IS THE FOLLOWING: */ /* - COPY THE TRIGGER INTO A TEMP FILE.
CL Program for AS/400 Systems DLTSPLF SELECT(*CURRENT + FILE(QSYSPRT) SPLNBR(*LAST) *OUTQ) GOTO BEGIN END 107
C 108
Index Symbols *INTNETADR 11 A AIX 4.3 51 AS/400 69, 101 Twinax Printing 82 AS/400 Systems 10 B BSDi 47 C Capture Sample Data AS/400 10 Novell Print Server 7 PlanetPress Watch 4 Printer 3 Serial Port 14 Unix (Solaris) 8 CL Program 101 Control Characters 18 CRTOUTQ 10 D Direct Connection 3 E Emulation Switching 94 F Flash Memory 20, 93 FreeBSD 47 H Hard Disk 19 Hosts file (Solaris) 8 HP Printers 93 HyperTerminal 14 I Inserting Triggers 20 L Lexmark Printers 93 Linux 47 N NetWare Administrator 7 Novell 4.
Index Print server 3 R RAM 20 S Sample data file 2 SAP Device Type 85 Script File (Solaris) 49 Serial Connection 3 Serial Data Capture 14 Spool File 2 T Trigger 18 Trigger File (Solaris) 50 Trigger Syntax 19, 20 Triggers AIX 4.3 51 AS/400 Systems 69 BSD Printing Systems 47 110 Novell 3.x 21 Novell 4.x and 5.x with NDS or Bindery Printers 31 UNIX System V (Solaris) 49 VMS 66 Windows NT 4.
