PlanetPress iWatch User 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 Objec-
tif Lune Inc.
Objectif Lune Inc. disclaims all warranties as to this software, whether expressed or implied, including without limitation any implied warranties of merchantability,
fitness for a particular purpose, functionality, data integrity or protection.
PlanetPress is a registered trademark of Objectif Lune Inc.
PostScript and Acrobat are registered trademarks of Adobe Systems Inc.
Pentium is a registered trademark of Intel Corporation.
Windows is a registered trademark of Microsoft Corporation.
Trademarks of other companies mentioned in this documentation appear for identification purposes only and are the property of their respective companies.
Title PlanetPress iWatch User Guide
Revision 6.1 8/17/07
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”) for the software product identified as PlanetPress® Suite, including all companion products, components, patches, updates and upgrades, and also
including any computer software, PostScript® programs, media and all accompanying on-line or printed documentation (collectively the “Software”). The Software
also includes Adobe® Technology and related documentation, and any upgrades, modified versions, additions and copies thereof.
2. BINDING EFFECT. - BY INSTALLING, COPYING, OR OTHERWISE USING THE SOFTWARE, YOU, AS NON-EXCLUSIVE SUB LICENSEE, ACCEPT TO BE AND YOU ARE BOUND BY
ALL OF THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT. IF YOU ARE THE ORIGINAL PURCHASER OF THE SOFTWARE AND DO NOT AGREE WITH THE TERMS
AND CONDITIONS OF THE LICENSE AGREEMENT, PROMPTLY RETURN THE UNUSED SOFTWARE TO THE PLACE FROM WHICH YOU OBTAINED IT FOR A FULL REFUND. BY
YOUR ACCEPTANCE OF THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT AS MENTIONED ABOVE, OBJECTIF LUNE GRANTS YOU THE RIGHT TO USE THE SOFT-
WARE IN THE MANNER HEREIN PROVIDED.
3. COPYRIGHTS. - This Software is owned by Objectif Lune or its suppliers and is protected by the Copyright Act (Canada), any copyright law and international copy-
right treaties. Therefore, you must treat this Software like any other copyrighted material (e.g., a book), except that you may, for example, make one copy of the
Software solely a) for backup or archival purposes or b) if it is essential for the compatibility of the computer program, or transfer the Software to a single hard disk,
provided you keep the original solely for backup or archival purposes and that such copy is not installed or used on any other computer.
4. PROPERTY AND INTELLECTUAL PROPERTY RIGHTS. - All Objectif Lune’s libraries, source code, byte code executables and any other files (collectively the “files”)
remain Objectif Lune’s exclusive property. Regardless of any modifications that you make, you may not distribute any files (particularly but not limited to Objectif
Lune source code and other non-executable files) except those that Objectif Lune has expressly designated. Nothing in this License Agreement permits you to derive
the source code of files provided to you in executable form only, or to reproduce, modify, use or distribute the source code of such files. This License Agreement does
not grant you any intellectual property rights in the Software.
5. TRANSFER. - You may transfer the Software only on a permanent basis, provided you retain no copies except as provided in Section 3 and the recipient or trans-
feree shall be bound by the terms of this License Agreement. Except as provided in this License Agreement, you may not transfer, rent, lease, lend, copy, modify,
adapt, translate, sublicense or time-share in any manner the Software or any part hereof.
6. TRADE SECRET. - You acknowledge that the Software in source code, its structure and organization form remains a confidential valuable trade secret of Objectif
Lune or its suppliers and therefore you agree not to modify the Software or attempt to reverse engineer, decompile or disassemble or otherwise attempt to discover
the source code of the Software.
7. UPGRADED VERSION. - If you have purchased an upgrade version of the Software, this version constitutes a single product with and forms part of the Software.
Any transfer of an upgrade version of the Software can be made only in accordance with this License Agreement.
8. SCOPE OF USE. - You agree to use the Software for your own customary business or personal purposes on only one device (physical or virtual computer system). If
you need to use the Software on more than one device, you must purchase additional licenses. Contact Objectif Lune for applicable royalties payable and licensing
terms. Please refer to the appropriate following sections 9 or 10 “ADDITIONAL LICENSE TERMS” for “Variable Content Documents” or - for “Optimized PostScript and
Windows Printing outputs”.
9. ADDITIONAL LICENSE TERMS FOR VARIABLE CONTENT DOCUMENTS. - If the Software can or will generate or create or modify Postscript programs called “Variable
Content Documents” (VCD), any VCD generated by the Software is licensed on a per “licensed output device” basis (including, without limitation, printers, Adobe
Acrobat Distiller, Aladdin Ghostscript, etc.). This means that any VCD generated by the Software can be used by any number of users as long as they use the VCD on
only that single licensed output device. If you need to use the VCD on more than one output device, you must purchase additional licenses. In case of cluster printing
systems (multiple print engines attached to a single Raster Image Processor (RIP), each print engine needs to be licensed individually. Contact Objectif Lune for the
applicable royalties payable and licensing terms for distribution of any VCD.
10. ADDITIONAL LICENSE TERMS FOR OPTIMIZED POSTSCRIPT AND WINDOWS PRINTING OUTPUTS.- Section 9 does not apply for PlanetPress Server’s “Optimized Post-
script” or “Windows Printing”.
11. TERM. - This license is effective until terminated. Objectif Lune has the right to terminate your license immediately if yo
u fail to comply with any one of the terms
of this Agreement. Upon termination, you must destroy the original and any copy of the Software and cease all use of all the trademarks mentioned herein.
12. LIMITED WARRANTY. - Objectif Lune warrants that the Software media will be free from defects in materials and workmanship, for a period of ninety (90) days
from the date of its purchase.
You must report all errors and return the Software to the location where you bought it with a copy of your receipt within such period to be eligible for warranty ser-
vice.
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 replace-
ment 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 Objec-
tif Lune for and in the name of any of its suppliers.
DO NOT RETURN ANY PRODUCT UNTIL YOU HAVE CALLED THE OBJECTIF LUNE CUSTOMER CARE DEPARTMENT AND PREVIOUSLY OBTAINED A RETURN AUTHORIZATION
NUMBER.
This Limited Warranty is void if failure of the Software results from accident, abuse or misapplication. Any replacement of the Software media will be warranted for
the remainder of the original warranty period or thirty (30) days, whichever is longer. Outside Canada, neither these remedies nor any product support services
offered by Objectif Lune are available without proof of purchase from a duly authorized non-Canadian source.
OBJECTIF LUNE DOES NOT AND CANNOT WARRANT THE PERFORMANCE OR RESULTS YOU MAY OBTAIN BY USING THE SOFTWARE. THIS LICENSE AGREEMENT STATES THE
SOLE AND EXCLUSIVE REMEDIES FOR OBJECTIF LUNE’S BREACH OF WARRANTY, EXPRESS OR IMPLIED, AS TO MERCHANTABILITY, NON-INFRINGEMENT OF THIRD PARTY
RIGHTS, OR FITNESS FOR A PARTICULAR PURPOSE.
For further warranty information, you may contact your nearest Objectif Lune representative. Contact information can be found at www.objectiflune.com.
13. LIMITATION OF LIABILITY. - IN NO EVENT SHALL OBJECTIF LUNE OR ITS SUPPLIERS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAM-
AGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS, LOSS OF PROFITS OR SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSI-
NESS INFORMATION OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE OR THE PROVISION OF OR THE FAILURE TO
PROVIDE SUPPORT SERVICES, EVEN IF OBJECTIF LUNE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN ANY CASE, OBJECTIF LUNE’S ENTIRE LIABILITY
UNDER ANY PROVISION OF THIS LICENSE AGREEMENT SHALL BE LIMITED TO THE GREATER OF: A) THE AMOUNT PAID FOR THE PURCHASE OF THE SOFTWARE OR B)
CAD $25.
14. WARNING ? HIGH RISK ACTIVITIES. - THE SOFTWARE IS NOT FAULT-TOLERANT AND IS NOT DESIGNED, MANUFACTURED OR INTENDED FOR USE OR RESALE AS ON-
LINE CONTROL EQUIPMENT IN HAZARDOUS ENVIRONMENTS REQUIRING FAIL-SAFE PERFORMANCE, SUCH AS, WITHOUT LIMITATION, IN THE OPERATION OF NUCLEAR
FACILITIES, AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, DIRECT LIFE SUPPORT MACHINES OR WEAPONS SYSTEMS, IN WHICH THE
FAILURE OF THE SOFTWARE COULD LEAD DIRECTLY TO DEATH, PERSONAL INJURY, OR SEVERE PHYSICAL OR ENVIRONMENTAL DAMAGE (“HIGH RISK ACTIVITIES”).
OBJECTIF LUNE AND ITS SUPPLIERS SPECIFICALLY DISCLAIM ANY EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR HIGH RISK ACTIVITIES.
15. GENERAL PROVISIONS. - This License Agreement may only be modified in writing by a duly authorized officer of Objectif Lune. If any or part of any provision of
this License Agreement is, by final judgment, found void or unenforceable, the remainder shall remain valid and enforceable according to its terms. Even if any rem-
edy provided is determined to have failed for its essential purpose, all limitations of liability and exclusions of damages herein set forth shall remain in full force and
effect.
16. GOVERNING LAW. This License Agreement is governed by the laws in force in the Province of Québec (Canada) and parties hereby elect domicile in judicial district
of Montréal, Québec, Canada. This Agreement is not governed by the United Nations Convention on Contracts for the International Sale of Goods (CISG), the applica-
tion of which being expressly excluded.
17. U.S. GOVERNMENT RESTRICTED RIGHTS. - If a Licensed Application is acquired under the terms of a proposal or agreement with the United States Government or
any contractor therefor, the Licensed Application is subject to the following restricted rights notice: “This Software is commercial computer software provided with
RESTRICTED RIGHTS. Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical
Data and Computer Software clause at DFARS 252.227-7013, FAR 52.227-17 Alternate III (g)(3), or subparagraphs (c)(1) and (2) of the Commercial Computer Soft-
ware -- Restricted Rights at 48 CFR 52.227-19, as applicable, and their successor provisions. Contractor/Manufacturer is Objectif Lune Inc., Montréal, Québec, Can-
ada, H1V 2C8.
18. U.S. EXPORT RULES. - You agree that the Software will not be shipped, transferred or exported into any country or used in any manner prohibited by the United
States Export Administration Act or any other export laws, restrictions or regulations (collectively the “Export Laws”). In add
ition, if the Software is identified as
export controlled items under the Export Laws, you represent and warrant that you are not a citizen of or otherwise located within an embargoed nation (including,
without limitation, Iran, Iraq, Syria, Sudan, Libya, Cuba, North Korea and Serbia) and that you are not otherwise prohibited under the Export Laws from receiving the
Software. All rights to use the Software are granted on condition that such rights are forfeited if you fail to comply with the terms of this paragraph.
i
Table of Contents
1 Using PlanetPress iWatch 1
Accessing the PlanetPress Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Main Menu Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1. Start PlanetPress subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Start PlanetPress monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Work with PlanetPress monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4. Display active source/target queue associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
5. Define PlanetPress documents/iSeries spooled file associations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
6. Define PlanetPress source output queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
7. Define PlanetPress target output queue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
8. Check PlanetPress output queue definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
9. Print PlanetPress test document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Index 13
ii
toc
1
Using PlanetPress iWatch
PlanetPress
®
iWatch is a software suite that allows a client to manage the printing of
PlanetPress documents on the IBM iSeries.
Summary
Accessing the PlanetPress Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Main Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Overview
With PlanetPress iWatch, the documents are automatically merged with the spooled file data, ready to be
processed by a Postscript printer. Setting up iWatch is easy and straightforward. All the necessary steps are
menu driven and no application programming changes are necessary.
Accessing the PlanetPress Main Menu
To access the PlanetPress main menu:
• Sign on to the system using the PPRESS user profile or type the command:
<GO PPRESS>
2
Using PlanetPress iWatch
1
To start using PlanetPress documents, the following is required:
1. Define a source output queue (Option 6).
A source output queue is where you will send the spooled files that you want to merge with
PlanetPress documents. The source output queue is not associated with a printer writer.
2. Define the target output queue (Option 7).
A target output queue is associated with a Postscript printer.
3. Define PlanetPress/iSeries spooled file associations (Option 5).
This allows you to define how an iS e r i e s spooled f i l e w i l l be assoc i ated to a Plane t Press document.
4. Start the PlanetPress subsystem (Option 1).
The PPRESS subsystem is where all the PlanetPress monitors run.
5. Start a PlanetPress monitor (Option 2).
A monitor is a program that processes spooled files in the source output queue, merges the spooled file
with the PlanetPress document based on the association defined in step 3 and redirects the loaded
document to the target queue for printing.
The following diagram illustrates the Planet iWatch process.
Main Menu Options
3
PlanetPress iWatch functional diagram.
Main Menu Options
1. Start PlanetPress subsystem
This option will start the PPRESS subsystem. Since all monitor jobs run in this subsystem, you might want
to include the
STRSBS PPRESS/PPRESS
command in your system startup program.
2. Start PlanetPress monitor
The Start PlanetPress Monitor command starts a spool monitor program for the specified source output
queue.
iSeries spooled files
PlanetPress
monitor
loaded forms
Source
output queue
output queue
Targ et
PlanetPress
forms & triggers
Postscript printer
loaded forms
4
Using PlanetPress iWatch
1
The program intercepts spooled files in the RDY status, merges the spooled file with the proper PlanetPress
document and sends the loaded document to the target output queue for printing. The monitor job is
named the same as the source output queue and runs in the PPRESS subsystem.
The following parameter integrity checks are performed upon executing the command:
1. The source and target queues cannot be the same and they must exist.
2. The source output queue must have an associated data queue in its definition. This task is performed
via the PPSSRCOUTQ command.
3. The source output queue cannot be attached to an active printer writer.
4. The target output queue must be associated with the PPRESS customizing object (*WSCST). This task
is performed via the PPSTGTOUTQ command.
Parameter Descriptions
<SRCOUTQ>Source output queue
Specifies the qualified name of the output queue that will be monitored by the PlanetPress monitor
program.
This is the queue where spooled files must be sent to be merged with a corresponding PlanetPress
document.
The possible library values are:
*LIBL
: The library list is used to locate the source output queue. This is the default value.
*CURLIB: The current library for the job is used to locate the source output queue.
Library-name: Specify the name of the library where the source output queue is located.
<TGTOUTQ>Target output queue
Specifies the qualified name of the target output queue where the PlanetPress spooled file will be sent.
This queue must be associated with a Postscript printer.
The possible library values are:
*LIBL
: The library list is used to locate the source output queue. This is the default value.
*CURLIB: The current library for the job is used to locate the source output queue.
Library-name: Specify the name of the library where the source output queue is located.
Main Menu Options
5
<PRTSETUP>Printer setup
Specifies the control language used by the Postscript printer associated with the target output queue. This
will determine the initialization and reset code that will be sent to the printer before and after the loaded
PlanetPress document.
The possible values are:
PJL
: The printer is an HP-type device that supports Printer Job Language. This is the default value.
ADOBE: The printer is an ADOBE type device.
printer-type: Specify the printer type associated with the target output queue.
<PRTDEVICE>Printer device
Specify a printer device if you want to start a printer writer associated with the target output queue. The
device must be available before the writer can be started.
The possible values are:
*NONE
: No printer is to be started. This is the default value.
printer-Monitor: Specify a printer device name to start a monitor associated with the target output
queue.
<LINK>PlanetPress document link
Specifies how the monitor will associate a corresponding PlanetPress document.
The possible values are:
*FORMTYPE
: The form type attribute of the spooled file will be used to determine the PlanetPress
document to use.
*USRDTA: The user data attribute of the spooled file will be used to determine the PlanetPress document
to use.
*BOTH: Both the form type and user data attributes will be used to associate a PlanetPress document.
<ORIGIN>PlanetPress document origin
Specifies where the PlanetPress documents are stored.
The possible values are:
*HOST
: The PlanetPress documents are stored on the iSeries and will be downloaded as requested to the
target printer.
*PRINTER: The PlanetPress documents are stored on the target printer. The documents can be stored on
the printer's hard disk, flash memory or any other means of printer storage.
6
Using PlanetPress iWatch
1
<NOTIFY>Notify if no PlanetPress document found for spooled file
Specifies if an informational message should be sent to the *SYSOPR queue if a spooled file is encountered
that does not have a corresponding PlanetPress document. Such spooled files are put on hold.
The possible values are:
*YES
: An informational message will be sent to the *SYSOPR queue. The spooled file will be put on hold.
This is the default value.
*NO: No message will be sent. The spooled file will be put on hold.
3. Work with PlanetPress monitors
This option runs command
WRKSBSJOB PPRESS
. It displays the list of monitor jobs running in the PPRESS
subsystem. You can end a monitor by specifying option 4 in front of the job.
4. Display active source/target queue associations
An active source/target queue association refers to the queues used by an active PlanetPress monitor. This
option is useful if you want to list the output queues in use by the monitors.
5. Define PlanetPress documents/iSeries spooled file associations
Option 5 allows you to define how PlanetPress documents will be associated with an iSeries spooled file.
PlanetPress iWatch uses the
FORMTYPE
and/or
USRDTA
attributes of the spooled file to link with its
corresponding document. The following display allows you to control the associations.
In field <PPS Form>, you enter the name of the PlanetPress documents. Documents are stored in file
PPRESS/PPSFORMS, one member per document.
Main Menu Options
7
In field <iSeries 400 Form Type> you enter the value of the FORMTYPE attribute for the spooled file if you
wish to use this attribute to link to a document.
In field <iSeries 400 User Data> you enter the value of the USRDTA attribute for the spooled file if you wish
to use this attribute to link to a document.
You can be generic in your associations or you can define the associations on a document basis. For
example, to tell iWatch that you wish to use the FORMTYPE attribute to link all your spooled files, enter
"*FORMTYPE" in the <PPS Form> field. This will indicate to the monitor, started with LINK(*FORMTYPE),
that the value in the FORMTYPE attribute of the spooled file is the name of the PlanetPress document to
use. However, you could also associate a document that has a different name than the value in the
FORMTYPE attribute. For example, to associate document "INVOICE" with a spooled file that has "INV" in
its FORMTYPE attribute, you would enter "INVOICE" in the <PPS Form field> and "INV" in the <iSeries 400
Form Type> field. The same logic applies to the USRDTA attribute.
If "*BOTH" is specified in the LINK parameter of the STRPPSMON command, then both FORMTYPE and
USRDTA attributes of the spooled file must match the <iSeries Form Type> and <iSeries User Data> field
is the entry. The following pseudocode outlines the logic used by the monitor to associate a PlanetPress
document:
If STRPPSMON LINK(*FORMTYPE)
If *FORMTYPE found in PPS Form field
PlanetPress form = FORMTYPE attribute of the spooled file
Else
PlanetPress form = PPS Form field specified
EndIf
Else
If STRPPSMON LINK(*USRDTA)
If *USRDTA found in PPS Form field
PlanetPress form = USRDTA attribute of the spooled file
Else
PlanetPress form = PPS Form field specified
EndIf
EndIf
Else
If STRPPSMON LINK(*BOTH)
PlanetPress form = PPS Form field specified
8
Using PlanetPress iWatch
1
EndIf
EndIf
6. Define PlanetPress source output queue
The PlanetPress Source Output Queue command allows the user to create the specified source output
queue if the queue does not already exist. If the queue exists, then it will be associated to the specified data
queue.
A PlanetPress Source Queue is used to trigger the process of associating a pre-defined PlanetPress
document with a spooled file. A data queue associated to the source output queue is necessary to
accomplish this process. Entries are logged in the data queue when spooled files are in ready (RDY) status
on the source output queue. The monitor program checks this data queue to determine when a spooled
file has arrived.
Parameter descriptions
<SRCOUTQ>Source output queue
Specifies the qualified name of the output queue that will be associated with the data queue. If the queue
does not exist, you will be prompted to create one.
The possible library values are:
*LIBL
: The library list is used to locate the source output queue. This is the default value.
*CURLIB: The current library for the job is used to locate the source output queue.
Library-name: Specify the name of the library where the source output queue is located.
<DTAQ>Data queue
Specifies the qualified name of the data queue that will be created and associated to the specified output
queue. The data queue must not already exist.
The possible values are:
*OUTQ
: The name of the data queue will be the same as the name of the specified source output queue.
This is the default value.
Main Menu Options
9
data-queue-name: Enter the qualified name of the data queue that is to be created and associated to the
specified source output queue.
The possible library values are:
*CURLIB
: The data queue will be created in the current library for the job.
library name: Specify the name of the library where the data queue is to be created.
7. Define PlanetPress target output queue
The PlanetPress Target Queue command allows the user to create a Planet Press Target output queue if the
queue does not already exist. If the queue exists, it will be associated with the appropriate PlanetPress
workstation customizing object (*WSCST).
A PlanetPress Target Queue is used to print a PlanetPress document that was merged with the spooled file
data. The spooled file originated from the source output queue. The target output queue must be
associated with a Postscript printer.
Parameter descriptions
<TGTOUTQ>Target output queue
Specifies the qualified name of the Target output queue that is to be created or associated with the
PlanetPress *WSCST. If the target output queue does not exist, you will be prompted to create one.
The possible library values are:
*CURLIB: The current library for the job is used to locate or create the Target output queue.
*LIBL: The library list is used to locate the existing Target output queue.
library name
: Specify the name of the library where the Target output queue is located or to be created.
8. Check PlanetPress output queue definition
The Check PlanetPress output queue command allows the user to determine if the specified source or
target output queue is properly configured to process PlanetPress document printing requests.
A source output queue is defined as a queue which receives the spooled files to be merged with
PlanetPress documents. This output queue has to be associated with a data queue.
10
Using PlanetPress iWatch
1
A target output queue is defined as a queue which receives the loaded PlanetPress documents
(document+spooled data). This queue must be associated with the PPRESS workstation customizing
object (*WSCST).
The following information message <
Source/target *OUTQ properly configured for PlanetPress printing
>
will be displayed if the queue was found to be properly configured.
Parameter descriptions
<OUTQ>Output queue
Specifies the qualified name of the output queue that will be checked. The queue must exist.
The possible library values are:
*CURLIB: The current library for the job is used to locate the output queue.
*LIBL: The library list is used to locate the output queue.
library name: Specify the name of the library where the output queue is located.
<Type>Output queue type
S pe ci f ie s th e ty p e o f o u tp ut qu e ue th at wi l l b e c h ec ke d fo r P l an et Pre s s d oc u me nt pr in ti n g.
The possible type values are:
*SOURCE: This is a source output queue. A source output queue is defined as a queue which receives the
spooled files to be merged with PlanetPress documents. The source output queue cannot be connected to
a printer writer.
*TARGET: This is a target output queue. A target output queue is defined as a queue which receives the
loaded document. This queue must be connected to a writer for printing to take place.
9. Print PlanetPress test document
The Print PlanetPress test document command can be used to test the entire process of printing a
PlanetPress document on the iSeries. This command will send a pre-defined test document to the
designated source output queue. The monitor will then, in turn, deliver the test document to the
associated target output queue. The target output queue must be associated to a Postscript printer.
Check PlanetPress Outq (CHKPPSOUTQ)
Type choices, press Enter.
Output Queue . . . . . . . . . . OUTQ
Library . . . . . . . . . . . *LIBL
Output queue type . . . . . . . TYPE
Main Menu Options
11
Parameter descriptions
<OUTQ>Output queue
Specifies the qualified name of the output queue to which the PlanetPress test document will be sent. The
queue must exist and have a data queue associated to it. The output queue must not be associated to an
active printer writer.
The possible library values are:
*CURLIB: The current library for the job is used to locate the output queue.
*LIBL: The library list is used to locate the output queue.
library name: Specify the name of the library where the output queue is located.
12
Using PlanetPress iWatch
1
Page is loading ...
Page is loading ...
/
