Jet Form

JetForm Central Reference Manual
for
AS/400
JetForm Central Reference Manual for AS/400 Edition 1.0, June 1998 Copyright 1998 JetForm Corporation All rights reserved. Technical information contained herein is subject to change without notice. The use and copying of this product are subject to a license agreement. Any other use is prohibited. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any language in any form by any means without the prior written consent of JetForm Corporation. Information in this manual is subject to change without notice and does not represent a commitment on the part of the vendor. Companies, names and data used in examples are fictitious unless otherwise indicated. JetForm Corporation does not warrant that JetForm Central will function properly in every hardware/software environment.
Trademarks
JetForm is a registered trademark and JetForm Central, JetForm Design and JetForm Filler are trademarks of JetForm Corporation. AS/400 and OS/2 are registered trademarks of International Business Machines Corporation. Microsoft, Windows and Windows NT are registered trademarks of Microsoft Corporation. NetManage and NS/Router are registered trademarks and NS/Administrator is a trademark of NetManage, Inc. OpenVMS is a trademark of Digital Equipment Corporation. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. All other product names are trademarks or registered trademarks of their respective trademark holders.
Contents
1 About JetForm Central ..................................................................................... 5
JetForm Central Components ...........................................................................................7 Outque Sentry .............................................................................................................7 Transformation Agent..................................................................................................8 Transformation Builder .........................................................................................8 Print Agent ..................................................................................................................8 JetForm Central Job Management Database....................................................................9
Installing JetForm Central ............................................................................. 10

Installing From a Tape..................................................................................................... 12 Installing From a CD........................................................................................................ 13
3 4
JetForm Central Main Menu........................................................................... 18 Defining JetForm Central Tasks.................................................................... 20

Outque Sentry Capabilities.............................................................................................. 20 Defining Outque Sentry ................................................................................................... 21 Cluster/Decluster....................................................................................................... 30 Outque Sentry Execution.................................................................................... 34
Running JetForm Central............................................................................... 35

Starting Outque Sentry .................................................................................................... 35 Stopping Outque Sentry .................................................................................................. 38 Using Outque Sentry ....................................................................................................... 40
6 7 8 9
Running Transformation Agent..................................................................... 43

Defining Transformation Agent Parameters .................................................................... 44
Running Print Agent ....................................................................................... 47

Defining Print Agent Parameters ..................................................................................... 48
Working with Output Queues ........................................................................ 59 Creating Outque Registries ........................................................................... 63
JetForm Central Reference Manual for AS/400
Contents
10 File Transfer .................................................................................................... 68

AS/400 Client Access ...................................................................................................... 68 NetManage NS/Folders Access ...................................................................................... 71 Transferring Files............................................................................................................. 73 Definition File (.TDF) .................................................................................................. 73 Form File (.MDF) ........................................................................................................ 74
11 Getting Help .................................................................................................... 75

Registering Your JetForm Software ................................................................................ 75 Contacting JetForm Customer Support ........................................................................... 75 Electronic Support..................................................................................................... 77 JetForm Information Center ...................................................................................... 77 Using JetForm Product Services............................................................................... 78
JetForm Control Language Commands ....................................................... 79

EDTF ............................................................................................................................... 79 JFAUTH........................................................................................................................... 79 JFCHGSPL...................................................................................................................... 80 JFCPYSPLF .................................................................................................................... 80 JFCVTSPLF .................................................................................................................... 81 JFDEMO.......................................................................................................................... 82 JFDWNLOD..................................................................................................................... 82 JFENDSNT...................................................................................................................... 83 JFGETSPLF .................................................................................................................... 83 JFLIBL ............................................................................................................................. 84 JFMAIN............................................................................................................................ 84 JFMERGE ....................................................................................................................... 84 JFPRTFRM...................................................................................................................... 90 JFPUTSPLF .................................................................................................................... 91 JFRELEASE .................................................................................................................... 91 JFSAVSPLF .................................................................................................................... 91 JFSBS ............................................................................................................................. 92 JFSTRSNT ...................................................................................................................... 92 JFTRANS ........................................................................................................................ 94 JFWRKOUTQ.................................................................................................................. 95 JFWRKREG .................................................................................................................... 95 JFWRKSNT ..................................................................................................................... 95
B C
Printer Diagnostics......................................................................................... 96 Product Authorization .................................................................................... 98 Index .............................................................................................................. 102
1
About JetForm Central
JetForm Central is a powerful server-based forms application that enables you to manage and administer your electronic forms in a networked or host-based environment. JetForm Central is part of the JetForm family of electronic forms products that includes:
q q
JetForm Design, for designing electronic forms JetForm Filler, for forms fill-in and sending forms-based messages throughout an organization JetForm Central, for providing client/server-based electronic forms processing services for printing forms and for converting transaction files (spooled files) from one file format to another. JetForm Central Processing
Print Agent
JetForm Design
JetForm Filler (Cross-platform)
JetForm Central and Outque Sentry
DATA
D A T A
Transformation Agent
Transformation Builder
JetForm Central enables you to print and merge forms on your IBM AS/400. You can create forms, labels and checks for all your business needs. Developed to take advantage of many of the advanced features of PCL or PostScript printers, JetForm Central also brings the best of Personal Computer (PC) graphics capabilities to the AS/400. Create your forms for use on the AS/400 using JetForm Design. Use the form and your spooled file to map data between the fields on the form and the spooled file, using the Transformation Builder. The Transformation Builder saves this mapping in a Definition File (.TDF). After you upload the form and the Definition File to the AS/400, the Transformation Agent uses this Definition File to convert a spooled or data file to a JetForm field-nominated format data file. The Print Agent then merges the form and data and prints the output.
For moving Definition and Form Files to the AS/400, see File Transfer on page 68.
The Definition Files are stored on the AS/400 as physical source files with a record length of 240. Each Definition File is stored in EBCDIC format, as a member of the file TDF, in the Library JFTDF. The TDF file is pre-loaded with the Definition Files (members) that the JFDEMO menu uses. Form files created in JetForm Design can be compiled directly to the AS/400. They are stored as ASCII binary images, and as members of the file MDF, in the library JFMDF. The MDF file is a multi-member physical data file, with a record length of 100. This file is pre-loaded with the form files (members) that the JFDEMO menu uses. JetForm Central for AS/400 is shipped with the JFTDF and JFMDF libraries and with the TDF and MDF files. You can choose to use these default values, or create your own.
Client PC
AS/400
Spooled Files
Transformation Agent (JFTRANS)
FILE TRANSFER
.MDF
Spooled Files .TDF (Definition Files)
Definition Files
Field Nominated Data
JetForm Design
.MDF (Form Files) Form Files Print Agent (JFMERGE)
Printed Output
Note: The Print Agent can handle data in formats other than field-nominated, such as overlay with and without carriage control and comma-delimited. However, the field-nominated format is the most flexible way of using the Print Agent. All of the JetForm Central capabilities are explained in detail in this manual and in the three companion manuals, JetForm Central Reference Manual for Transformation Builder, JetForm Central Reference Manual for Transformation Agent and JetForm Central Reference Manual for Print Agent.
JetForm Central Components

JetForm Central provides three components that orchestrate the flow of forms in an organization. The components:
q q q
define tasks and control the operations within a task convert transactions files from one file format to another provide print services.
Outque Sentry
Outque Sentry monitors your output queues, waiting for specific spooled files to appear. Outque Sentry processes spooled files in the output queues and performs the tasks you define. For example, you can:
q q q q
move the spooled file to another output queue merge the spooled file with a form and distribute copies to multiple locations transform the spooled file delete the spooled file.
One task can involve multiple operations. In fact, one Outque Sentry can contain multiple tasks with multiple operations within each task. Tasks which perform more than one operation in Outque Sentry are called clusters. All of the capabilities of Outque Sentry, including clustering, are explained in this manual. It also contains examples of ways you can use Outque Sentry. In addition to the manual, the software contains Help Text (F1=Help) and prompt screens (F4=Prompt or ?), which guide you through the application and make using the software easier.
Transformation Agent
For details about the Transformation Agent, refer to the JetForm Central Reference Manual for Transformation Agent.
The Transformation Agent (JFTRANS) is the file conversion module of JetForm Central. It is a powerful and flexible tool that converts a transaction file from one file format to another. The Transformation Agent easily integrates JetForm technology into your existing computer systems. It provides a bridge between a legacy application and JetForm or another legacy system, without requiring changes to your existing application. The Transformation Agent converts data created in several formats, including fixed length, character-delimited, overlay and JetForm field-nominated format. The Transformation Agent converts files from:
q q q
non-JetForm format to non-JetForm format non-JetForm format to JetForm format JetForm format to non-JetForm format.
For details about the Transformation Builder, refer to the JetForm Central Reference Manual for Transformation Builder.
The Transformation Builder is a tool that lets you easily create a Transformation Agent Definition File. In the production environment, the Transformation Agent uses this Definition File, along with the transaction file, to create a data file in JetForm field-nominated format. The graphical user interface of the Transformation Builder features a point-and-click method for associating data with fields on a form. The Transformation Builder also includes a facility that uses the newly created Definition File to verify the conversion of a transaction file to JetForm field-nominated format. The Transformation Builder runs on Microsoft Windows 95 or Windows NT.
Print Agent
For details about the Print Agent, refer to the JetForm Central Reference Manual for Print Agent.
The Print Agent (JFMERGE) is the print module of JetForm Central. The Print Agent enables applications to use laser printers to print data merged with electronic forms designed in JetForm Design. JetForm Central initiates the Print Agent when a transaction file with a print task appears in the output queue monitored by Outque Sentry. You can also invoke the Print Agent directly from an application program, such as a Control Language (CL) program, a command line, or directly from the JetForm Central for AS/400 Main Menu. For print tasks, JetForm Central provides very powerful and flexible job management facilities to control the assigned printers, the compiled forms to use, and the downloaded forms and fonts. JetForm Central enables you to:
q q
merge data in various formats with electronic forms for printing take information from a single transaction file and present the information in different views on different printers print multiple copies of electronic forms

q
download frequently used forms as macros for later printing, rather than sending the form for each print task load and unload macros in printers to make the most effective use of printer memory in printers that support managed memory.
JetForm Central Job Management Database

JetForm Central is available on a wide variety of platforms, including Microsoft Windows, Microsoft Windows 95, Microsoft Windows NT, OS/2, UNIX and OpenVMS. Because of this, the JetForm Central Reference Manuals for Transformation Agent and Print Agent are designed as generic manuals, to be used regardless of the platform. These manuals make reference to the JetForm Central Job Management Database and its graphical user interface, JetForm Control. As yet, these features are not implemented for the AS/400 platform. Their functions are performed by Outque Sentry.
2
Installing JetForm Central
Before installing JetForm Central on the AS/400, there are a number of considerations to bear in mind:
The AS/400 limits the number of libraries in the user portion of the library list. Refer to your AS/400 documentation for details.
q q q
the library QTEMP must be in your library list there must be at least two entries available in your library list all objects are owned by JFSERVER when JetForm Central is installed. The installation program creates the user profile for you. all objects have PUBLIC ACCESS=*ALL when installed.
Caution: If you have an existing version of JetForm Central, the installation program overwrites all existing data. (Existing libraries JFCENTRAL, JFPTF, JFMDF and JFTDF are deleted, then restored.) Backup any required data, especially Outque Sentry definitions, MDFs and TDFs, prior to running the installation program. Your AS/400 must be using OS/400 Version 3 Release 1 or later, and you must have PC connectivity, such as AS/400 Client Access or TCP/IP. For Version 3 Release 1, the CPA toolkit, PRPQ 5799-XDB must be installed. You require at least 30 Megabytes of free auxiliary storage on your system for use during the installation process. The actual run time auxiliary storage used by JetForm Central varies, depending on your AS/400 system configuration. The time required to complete the installation process varies, depending on the system, the media device type, and your AS/400 configuration. The average time for installation is 20 minutes, but the actual time can range from approximately 10 minutes to over an hour.
Refer to the appropriate IBM reference manual for more details about AS/400 system objects.
The CPA toolkit, PRPQ 5799-XDB, can be ordered at no charge through your normal IBM support channel.
JetForm Central utilizes several of the IBM APIs to maximize performance. Therefore, when you run applications interfacing with JetForm Central, you must have authorization to call these AS/400 system objects. They all reside in QSYS as object type *PGM.
q q
QSPCLOSP QSPGETF
10

q q q q q q q q
11
QSPGETSP QSPOPNSP QSPPUTF QUSCRTUS QUSDLTUS QUSLSPL QUSRSPLA QUSRTVUS
The installation process creates these objects: Object JFSERVER JFCENTRAL JFPTF JFDATA JFINSTALL JFJOB JFJOB1 JFLIBL JFLIBLC JFMAIN JFMAINC JFMDF JFSENTRY JFSENTRY JFSUBSYS JFTDF LPT1 QDLS/JFPCD QDLS/JFMDF QDLS/JFTDF JFCENTRAL JFCENTRAL QGPL JFCENTRAL QGPL QGPL JFCENTRAL JFCENTRAL QGPL QGPL QGPL QGPL Library Type *USRPRF *LIB *LIB *DTAARA *MSGQ *JOBQ *JOBQ *CMD *PGM *CMD *PGM *LIB *MSGQ *JOBD *SBSD *LIB *FILE FOLDER FOLDER FOLDER Description User Profile Object Library PTF Library List of JetForm Central Library names and installation status Installation message queue Job queue for Outque Sentry (maximum 10 jobs) Job queue for Outque Sentry (maximum 2 jobs) Library list command Library list program Main Menu command Main Menu program MDF Library Outque Sentry message queue Job Description Subsystem TDF Library Printer file with DEVTYPE (*USERASCII) used by JFMERGE JetForm Collector Directory JetForm MDF Directory JetForm TDF Directory
12
This document lists two procedures for installing JetForm Central for AS/400:
q q
installing to a RISC or CISC machine from a tape installing to a RISC or CISC machine from a CD
For the CD installation, the JetForm Central for AS/400 software is saved to a PC disk file as an AS/400 save file (*SAVF) using the FTP facilities in OS/400. The CD installation procedure allows you to install JetForm Central by transferring the installation files from the CD to the AS/400.
Installing From a Tape

To install to a RISC or CISC machine from a tape 1. Sign on to the AS/400 with Security Officer level authority. Note: You must have *SAVSYS, *ALLOBJ, and *SECADM special authorities to run the Installation program. 2. Insert the tape in the tape drive and, at the command line, enter
LODRUN DEV(tape-device)
where:
tape-device is the tape drive or cartridge drive name from which you are loading the JetForm Central software. For example, TAP01 or CART01.
The installation program interrogates your system and if an existing version of JetForm Central is found, an inquiry message displays allowing you continue or to abort the installation:
See Product Authorization on page 98.
3. After the product libraries are restored, JetForm Central for AS/400 is installed but still needs to be authorized. The installation program will prompt for an authorization code. This is the 24 digit code on the label attached to the tape case. If you do not have a code, or it is invalid/expired, press F3 to continue. The authorization code may by entered later by using the JFAUTH command. Note: JetForm Central menus and options can be accessed without a valid authorization code. However, key elements of the system will not operate properly unless a valid code is entered.
13
When the installation program completes, it displays this menu:
Installing From a CD
To install to a RISC or CISC machine from a CD The prerequisites for installing to a RISC or CISC machine are:
q q
For RISC, OS/400 V3R6 or higher, and for CISC, OS/400 V3R1 or higher TCP/IP installed on the AS/400 (you can use the IBM shipped default configuration as is) Shared folders accessible from a PC QSECOFR user ID and password.
q q
For accessing the shared folder directory of the AS/400, see File Transfer on page 68.
1. Access the shared folders directory of the AS/400 on which you will be installing JetForm Central. Take note of the name of an existing folder that you want to use.
Or...
Create a new folder/obtain a folder name from an AS/400 session by using the WRKFLR command. Note: For AS/400 Client Access for Windows or the 32 bit NS/Router, the folders are subdirectories of directory QDLS.
14
Folder names should be no longer than 8 characters. For example, JFINSTAL is valid and JFINSTALL is not valid. 2. Copy the JetForm Central save file to the shared folder by either:
q
in My Computer or Network Neighborhood, select and drag it from the CD to the applicable subfolder of QDLS.
Or...,
q
from a DOS prompt, enter the following copy command:
for RISC
COPY X:\J510INSR.SAV I:\QDLS\dddddddd\J510INSR.SAV
for CISC
COPY X:\J510INSC.SAV I:\QDLS\dddddddd\J510INSC.SAV
where:
dddddddd is the folder you selected/created in Step 1. X: is the CD-ROM drive. I: is the shared folder drive.
3. Start an AS/400 5250 session and sign on as QSECOFR. 4. Create a save file in a library other than QTEMP as follows: for RISC
CRTSAVF FILE(xxxxxxxxxx/J510INSR)
for CISC
CRTSAVF FILE(xxxxxxxxxx/J510INSC)
where:
xxxxxxxxxx is the library name other than QTEMP. Library names should be no longer than 10 characters.
5. If not already started, start the TCP/IP network server from an AS/400 command line with:
STRTCP
15
6. Start an FTP session to copy the save file from your PC to the AS/400 with:
FTP LOOPBACK
Log in using QSECOFR profile and password, then enter the following FTP subcommands: for RISC
NA 1 BIN PUT /qdls/dddddddd/J510INSR.SAV /qsys.lib/xxxxxxxxxx.lib/J510INSR.FILE QUIT
for CISC
NA 1 BIN PUT /qdls/dddddddd/J510INSC.SAV /qsys.lib/xxxxxxxxxx.lib/J510INSC.FILE QUIT
where:
NA 1 is the name format. BIN is the binary transfer.
The PUT command copies the PC File created in Step 2 to the save file created in Step 4. dddddddd is the folder/subdirectory selected in Step 1. xxxxxxxxxx is the library name from Step 4.
QUIT exits FTP.
7. Restore the installation program and JetForm Central library save files into QTEMP: for RISC
RSTOBJ OBJ(*ALL) SAVLIB(J510INSR) DEV(*SAVF) SAVF(xxxxxxxxxx/J510INSR) RSTLIB(QTEMP)
for CISC
RSTOBJ OBJ(*ALL) SAVLIB(J510INSC) DEV(*SAVF) SAVF(xxxxxxxxxx/J510INSC) RSTLIB(QTEMP)
where:
xxxxxxxxxx is the library selected in Step 4.
16
For example: for RISC:
for CISC:
This step restores the following objects into QTEMP: Object J510INST J510CENR or... J510CENC J510PTFR or... J510PTFC J510MDF J510TDF 8. Run the installation program:
CALL PGM(QTEMP/J510INST) PARM('JFPCCD')
Description Installation Program Product Library Save File (RISC) or... Product Library Save File (CISC) PTF Library Save File (RISC) or... PTF Library Save File (CISC) MDF Library Save File TDF Library Save File
Note: The parameter JFPCCD must be in capital letters.
17
The installation program will interrogate your system and if an existing version of JetForm Central is found, an inquiry message will display allowing you continue or to abort the installation:
9. After the product libraries are restored, JetForm Central for AS/400 is installed but still needs to be authorized. The installation program will prompt for an authorization code. This is the 24 digit code on the label attached to the CD case. If you do not have a code, or it is invalid/expired, press F3 to continue. The authorization code may by entered later by using the JFAUTH command. Note: JetForm Central menus and options can be accessed without a valid authorization code. However, key elements of the system will not operate properly unless a valid code is entered. When the installation program completes, it displays this menu:
10. Delete the document or folder created in Steps 1 and 2 as well as the save file created in Step 4. Temporary objects created in Step 7 will be automatically deleted once you sign off your AS/400 session.
3
JetForm Central Main Menu
The JetForm Central Main Menu is the gateway to all the features of JetForm Central for AS/400. To access this menu, from the AS/400 Main Menu, type JFMAIN and then press ENTER.
A brief description of each of the selections follows. Where noted, selections are discussed in greater detail later in this manual.
Selection 1. Load Form in Printer

This selection allows you to download a form to a specific printer. The form must be compiled with JetForm Design and must be in the .MDF format, with or without an embedded .JTP. The download can be to printer memory as a permanent or temporary macro, or to the printer hard disk or nonvolatile (flash) memory.
Selection 2. Print Form

This selection allows you to print a blank form to a specified printer.
18
JetForm Central Main Menu
19
Selection 3. Run Transformation Agent

See Running Transformation Agent on page 43.
This selection allows you to run the Transformation Agent (JFTRANS) as a stand alone executable.
Selection 4. Run Print Agent

See Running Print Agent on page 47.
This selection allows you to run the Print Agent (JFMERGE) as a stand alone executable.
Selection 10. Work with Outque Sentry

For Outque Sentry, see Defining JetForm Central Tasks on page 20.
This selection allows you to create and define an Outque Sentry. An Outque Sentry monitors your output queues, waiting for specific spooled files to appear.
Selection 11. Work with Outque Registries

See Creating Outque Registries on page 63.
This selection allows you to create an outque registry. With an outque registry, you can group output queues, thereby allowing one Outque Sentry to monitor the group.
Selection 12. Work with Output Queues

See Working with Output Queues on page 59.
This selection allows you to display all the files in a specified output queue, for a specified user and form type. You can then perform a number of functions against the files.
Selection 20. Work with JetForm Subsystem

This selection allows you to work with the JetForm Subsystem, JFSUBSYS. All Outque Sentries and associated jobs are run in the JetForm Subsystem. You can start or stop the JetForm Subsystem, as well as specify the maximum number of jobs that can run in the subsystem. The subsystem must be active for Outque Sentry to process jobs. Prior to stopping the subsystem, end all active Outque Sentries, using selection 10. Work with Outque Sentry. Failure to do so could cause loss of jobs.
Selection 30. Printer Diagnostic Tests

See Printer Diagnostics on page 96.
This selection allows you to print three test pages to a specified output queue. Test page 1 simulates standard output for any printer, test page 2 simulates PCL5 output and test page 3 simulates PostScript output.
Selection 90. Signoff

This selection allows you to sign off the AS/400 and return to the sign on screen.
4
Defining JetForm Central Tasks
An Outque Sentry monitors your output queues, waiting for specific spooled files to appear. Based on a time interval you set or a data queue trigger, Outque Sentry processes the spooled files and performs the tasks you define. For example, you can:
q q q q
move the spooled file to another output queue merge the spooled file with a form and distribute copies to multiple locations transform the spooled file delete the spooled file.
One task can involve multiple operations. In fact, one Outque Sentry can contain multiple tasks with multiple operations within each task. Performing more than one operation on a spooled file in Outque Sentry is called clustering. This is useful because you can run only one Outque Sentry on an output queue at a time. The capabilities of Outque Sentry, including clustering, are explained in this chapter.
Outque Sentry Capabilities

The capabilities of Outque Sentry include: Distributed Printing Print Agent Distribute copies of a spooled file to multiple locations. Automatically execute JFMERGE with any application without modifying the source code.
Transformation Agent Automatically execute JFTRANS without modifying any source code. Execute Commands Copy Operation Move Operations Automatically execute AS/400 commands based on spooled file conditions. Copy an existing spooled file to the same or a different output queue, maintaining all spooled file attributes. Move an existing spooled file to a different output queue, maintaining all spooled file attributes.
20
21
Multiple Conditions Delete Spooled Files Audit Log
Define up to three selection criteria to be tested for a set of Outque Sentry instructions. Automatically delete unwanted spooled files. Maintain a log of all Outque Sentry activities.
Important Notes about Outque Sentry

At a Selection or Operation prompt field, just type a ? (question mark) character for all available options. When the Options Window appears, type in your selection or choice and press ENTER.
Defining Outque Sentry

To define an Outque Sentry 1. Access the JetForm Central Main Menu, JFMAIN.
22
2. Select 10. Work with Outque Sentry. The Work with Outque Sentry screen appears.
3. Press F6 to add a new Outque Sentry. The Output Queue Sentry Attributes screen appears.
23
4. Complete the fields on this screen: Field Name Sentry ID Description Generate Audit Log Field Description Enter the name you want to give your Outque Sentry (up to 10 characters). Enter a descriptive name for your Outque Sentry (up to 25 characters). The default value is N (No). This value can be set to Y (Yes). When set to Yes, Outque Sentry creates a log to detail all jobs it processes. The audit log is placed in a database file, JFLOGFP, in the library, JFCENTRAL. The file is a standard AS/400 externally described database physical file. You can use any availabe tool to view/query the contents of the file. This is the period, in seconds, in which Outque Sentry waits before checking its output queue. When the value is set to 0, Outque Sentry begins immediately and runs one time only. The maximum sleep time is 99,999 seconds. Provide a specific start time for Outque Sentry. Provide a time in the format HH:MM:SS. Attach a data queue to an output queue. Caution: Outque Sentry creates a data queue in library JFCENTRAL. The data queue name is the same as the Outque Sentry name. When an Outque Sentry is started, the system will change the data queue attached to all the output queues being monitored. When the Outque Sentry is ended, the original data queues, those previously attached to the output queues, will not be reset. Ignore Spool files with RDY spool file status of HLD SAV Submit to Jobq Default Registry ID Ready - The default is No. Held - The default is Yes. Saved - The default is Yes.
Sentry Sleep Time
--Or-- Delay --Or-- DataQueue
Enter a job queue name. By default, the Library is JFCENTRAL. Provide the name of the Outque Registry this Outque Sentry will monitor. If left blank, provide an Output Queue and Library. If Default Registry ID is blank, provide the name of the single Output Queue and Library this Outque Sentry will monitor.
Output Queue
24
5. Once you complete the fields on the Output Queue Sentry Attributes screen, press ENTER. The Define Sentry Detail screen appears. You use this screen to list the operations that Outque Sentry performs.
6. Enter 1 in the Opt column to create a new task. Press ENTER. A sequence number of 10 appears in the Seq column and the cursor moves to the Operation column. 7. Enter the operation you want Outque Sentry to perform. To do so, either enter ? in the Operation column to view the operations and select one from the list, or enter the access letter to select the operation directly. The choices are: Operation *COPY Access Letter Description C Copies an existing spooled file to the same output queue or to a different output queue. The COPY operation maintains all spooled file attributes. Deletes the spooled file from the output queue. Executes a command or calls a program, for example, ADDLIBLE, CALL. Moves the spooled file to a different output queue. Converts a spooled file. Takes a spooled file and saves it as a data file. Merges the form and spooled file data using the Print Agent. Transforms data formats using the Transformation Agent.
*DELETE *EXECUTE *MOVE JFCVTSPLF JFMERGE JFTRANS
D X M S P T
25
8. When you select an operation, the Define Sentry Selection screen appears. You use this screen to add selections to define the operation. You can define up to five selections per operation. The default selection is *NONE, which means process the operation unconditionally.
9. The Sentry ID, Sequence and Operation fields are populated. Complete the rest of the fields on this screen, as necessary: Field Name Field Description
Output Queue Required if your operation is either *COPY or *MOVE. and Library Selection The selections define the attribute of the spooled file you want to target. You can have up to five attributes considered, by entering up to five selections. To view all the selection options, type a ? (question mark) character in the field. The default is *NONE, which means process the operation unconditionally. The Selection type choices are: *CPI *DATE *FILE Characters per inch Spooled file creation date Spooled file name
*FORMTYPE Spooled file form ID *JOBNAME *LPI *OUTQ *PAGECNT *PAGELNTH Job that created spooled file Lines per inch Spooled file output queue Total pages in spooled file Spooled file page length
26
Field Name
Field Description *PAGEWDTH Spooled file page width *SPLNBR *SPLSTS *USERID *USRDATA Spooled file number Spooled file status User that created spooled file Spooled file user data
Cnd
The Logical Operators for conditions are EQ, GE, GT, LE, LT, NE and RANGE. Note that EQ, GE, GT, LE, LT and NE are string comparisons, not numerical comparisons. The default is EQ. The logical operators cause the conditions to be true as follows: EQ GE GT LE LT NE RG If field equals value. If field is greater than or equal to value. If field is greater than value. If field is less than or equal to value. If field is less than value. If field does not equal value. Range can only be used with *DATE. You must enter a Start Date and an End Date. The correct format is: YYMMDD YYMMDD (YearMonthDay YearMonthDay).
Value
Value of the field being tested, which can be a special keyword or a constant value. If your selection parameter is *CPI, the value parameter can be one of 5, 10, 12, 13.3, 13,3 (thirteen comma three), 15, 16.7, 16,7 (sixteen comma seven), 18 or 20. If your selection parameter is *LPI, the value parameter can be one of 3, 4, 6, 7.5, 7,5 (seven comma five), 8, 9 or 12. If your selection parameter is *PAGELNTH, the value parameter can be less than or equal to 255, with leading zeros. If your selection parameter is *PAGEWDTH, the value parameter can be less than or equal to 378, with leading zeros. If your selection parameter is *SPLNBR, the value parameter can be *ODD or *EVEN, as well as a numeric value, with leading zeros. If your selection is *SPLSTS, the value parameter can be RDY, HLD, or SAV.
27
For the Operation values *EXECUTE, JFCVTSPL, JFMERGE and JFTRANS, you are presented with the Sentry Command Entry screen. If your Operation is *EXECUTE, the screen is blank. Use the F4=Prompt function key to display the available commands. Select a command and type the command you want to execute automatically. You can enter up to 320 characters.
The screen contains the command if your Operation is JFCVTSPLF, JFMERGE or JFTRANS, such as this example for the JFTRANS command. The command string shown reflects the default values for the command. Use the F4=Prompt function key to further define the command string.
28
10. Once all tasks are added, the Define Sentry Detail screen displays, showing the tasks you want Outque Sentry to perform.
11. You can change or delete any of the tasks on the Define Sentry Detail screen at any time, as long as Outque Sentry is not active.
q
To make changes, enter 2 in the Opt column opposite the task and press ENTER. The Define Sentry Selection screen appears, allowing you to update the task. To copy a task, enter 3 in the Opt column opposite the task and press ENTER. The copied task is added to the end of the list, with a sequence number which equals the last sequence number plus ten. For example, a copied task on the list above will be added as sequence #80. To delete a task, enter 4 in the Opt column opposite the task and press ENTER. You are asked to confirm the deletion. To view the command for this operation, enter 5 in the Opt column opposite the task and press ENTER. Note that this option works only in inquiry mode. To cluster tasks, enter 7 in the Opt column opposite the task and press ENTER. To decluster tasks, enter 8 in the Opt column opposite the task and press ENTER.
See Cluster/Decluster on page 30.
q q
12. Outque Sentry performs its tasks in the order they appear on the Define Sentry Detail Screen. You can reorder the tasks at any time, by changing the sequence number. To do so, enter 2 in the Opt column opposite the task and press ENTER. The Define Sentry Selection screen appears, allowing you to change the sequence
29
number of the task. Once you change the sequence number, the tasks shown on the Define Sentry Detail screen automatically resequence, in numerical order, to reflect your change.
13. If desired, you can change the sequence numbers to again reflect increments of 10. To do so, press the F10=Resequence function key. The order of the tasks remains the same, but the sequence numbers change.
30
Cluster/Decluster
Every Outque Sentry operation you define has at least one condition. If the conditions are met, Outque Sentry executes the operation and then processes the next spooled file. Even if there are more operations defined, they do not get executed. Outque Sentry stops or sleeps after executing the first valid operation. If you want Outque Sentry to execute more than one operation at a time on a spooled file, you must use clustering. For example, to print checks you can use clustering to execute a program, transform the output, copy to a different output queue and then delete the original. You cluster/decluster operation statements on the Define Sentry Detail screen. To create a cluster 1. To cluster an operation, put a 7 (7=Cluster) next to its statement in the Opt column of the Define Sentry Detail screen. Do this for all statements you want to cluster.
In the above example, the 7 next to the statements shows that you want to cluster *EXECUTE, JFTRANS, JFMERGE, and *DELETE.
31
2. Press ENTER. Only the clustered statements are displayed. The Cluster column shows 1 to the left of each of the clustered statements and the Position to Cluster field shows the cluster number.
Use the F5=Refresh function key to show all statements. To add entries to an existing cluster 1. Place a 7 in the Opt column, next to one of the statements in the existing cluster. This identifies the existing cluster. 2. Place a 7 in the Opt column next to the statements you want to add to that cluster. 3. Press ENTER. On the Define Sentry Detail screen, the identifying number appears in the Cluster column to the left of the statements you added to the cluster. To delete entries from an existing cluster 1. Place an 8 in the Opt column next to the statements you want to remove. 2. Press ENTER. Outque Sentry takes the statements out of the cluster; it does not delete your whole cluster or the statements. On the Define Sentry Detail screen, the identifying numbers are removed from the Cluster column for the declustered statements.
32
To remove an entire cluster 1. Place an 8 in the Opt column by all of the statements in the cluster. 2. Press ENTER. On the Define Sentry Detail screen, the identifying numbers are removed from the declustered statements. To create multiple clusters You can have more than one cluster at a time. If the output queue you are watching is used for more than one purpose, you may want to perform another task within the same Outque Sentry. In our example, the first task is to print checks. The second task is to print invoices. You need another cluster to complete this task. 1. Place a 7 in the Opt column opposite the JFMERGE, JFMERGE and *MOVE statements to create a second cluster.
33
2. Press ENTER. Only the clustered statements for the second cluster are displayed . The Cluster column shows 002 to the left of each of the clustered statements and the Position to Cluster field shows the cluster number.
Use the F5=Refresh function key to show all statements.
In the second cluster, the first JFMERGE merges data with an invoice form; the second, with a packing slip. The *MOVE command moves the spooled file to a different location. Thus, this cluster handles your shipping related tasks.
34
Outque Sentry Execution

It is important to understand the execution process when you are clustering Outque Sentry operations. An Outque Sentry is driven by the output queue or registry it is monitoring. When an Outque Sentry starts or is awakened, it takes a snapshot of the output queues it is monitoring and this snapshot becomes the driver of the Outque Sentry. Note: If Outque Sentry is monitoring a busy output queue, you can reduce its work by reducing the snapshot it captures. You do this by entering values other than *ALL for the Process User, Process form type and Process user data parameters. See page 37 for details. Beginning with the first spooled file in the snapshot, Outque Sentry compares it against each of the operations, starting with the lowest sequence number, until it finds a match. Then it performs that operation and any operations in that cluster. It is then finished with that spooled file. It retrieves the next spooled file from its snapshot and begins its comparison again, starting with the lowest sequence numbered operation. When Outque Sentry is started and a data queue is attached to the output queue that it is monitoring, Outque Sentry processes the data queue as soon as a spool file shows a Ready status. Caution: Outque Sentry creates a data queue in library JFCENTRAL. The data queue name is the same as the Outque Sentry name. When an Outque Sentry is started, the system will change the data queue attached to all the output queues being monitored. When the Outque Sentry is ended, the original data queues, those previously attached to the output queues, will not be reset.
5
Running JetForm Central
JetForm Central on the AS/400 consists of three components:
q q q
Outque Sentry Transformation Agent Print Agent.
You define tasks for JetForm Central using Outque Sentry. When a spooled file is placed in an output queue, Outque Sentry processes the file. It calls Transformation Agent and Print Agent as necessary to complete the task. Transformation Agent and Print Agent can also be called as stand alone executables from the JetForm Central Main Menu, or included within existing Control Language (CL) routines.
Starting Outque Sentry

There are three ways to start Outque Sentry:
q q q
from the JetForm Central Main Menu entering JFSTRSNT at a command line adding the JFSTRSNT command to your Autostart subsystem.
Once started, Outque Sentry either continues to run until stopped, or it runs only once if the Sentry Sleep Time is set to 0, there is no Delay set and there is no DataQueue request.
35
36
To start Outque Sentry from the JetForm Central Main Menu 1. From the JetForm Central Main Menu, select 10. Work with Outque Sentry and press ENTER. The Work with Outque Sentry screen appears.
When you access this screen, each defined Outque Sentry is displayed and the cursor is in the positioning fields at the top of the screen. The positioning fields allow you the flexibility of displaying only a subset of your Outque Sentries.
q
Use the Sentry ID field to display all Outque Sentries with a name starting with a letter equal to or greater than a positioning letter. For example, entering the letter S displays all Outque Sentries starting with the letters S to Z. Use the Description field to display all Outque Sentries with a description containing a given alphanumeric string. For example, entering the string #2 displays only Outque Sentries with a description containing this string.
Use the F5=Refresh function key to redisplay all Outque Sentries.
37
2. Enter 8 in the Opt column next to the Outque Sentry you want to start and press ENTER. The Output Queue Sentry Attributes screen appears.
3. Use this screen to enter the run time values to start Outque Sentry. With the exception of the last three fields on the screen, the fields are the same as those presented when adding a new Outque Sentry. See page 22 for a description of those fields. The other fields are: Field Name Process User Field Description Use this field to enter a user profile, if you are only processing a spooled file created by a specific user. The default is *ALL. Use this field to enter a specific form type (such as *INV, *purchase, *STD). The default is *ALL. Use this field to enter specific user data. The default is *ALL.
Process form type Process user data
Note: The Process User, Process form type, and Process user data parameters allow you to restrict Outque Sentry from processing spooled files other than those specified. The Outque Sentry is submitted to the job queue.
38
To start Outque Sentry from the command line 1. From a command line, enter JFSTRSNT and then press F4. The Start Sentry (JFSTRSNT) screen appears.
2. Provide the name of the Outque Sentry you want to start and any required run time values. The fields on the screen are the same as those presented when starting Outque Sentry from selection 10. Work with Outque Sentry on the JetForm Central Main Menu. 3. Use the F10=Additional parameters function key to see the Process User, Process form type and Process user data fields. 4. To start the Outque Sentry, press ENTER. The Outque Sentry is submitted to the job queue. To start Outque Sentry automatically Add the JFSTRSNT command to your Autostart subsystem. For instructions, refer to your AS/400 System Administrator Manual.
Stopping Outque Sentry

There are three ways to stop an Outque Sentry:
q q q
from the JetForm Central Main Menu entering JFENDSNT at a command line from WRKACTJOB.
39
To stop Outque Sentry from the JetForm Central Main Menu 1. From the JetForm Central Main Menu, select 10. Work with Outque Sentry and press ENTER. The Work with Outque Sentry screen appears.
2. Place a 9 in the Opt column next to the Outque Sentry you want to stop, and press ENTER. Outque Sentry ends immediately and the status control files are reset. To stop Outque Sentry at the command line 1. From a command line, enter JFENDSNT and then press F4. The End Sentry (JFENDSNT) screen appears.
Enter the name of the Outque Sentry you want to stop, and press ENTER. Outque Sentry ends immediately and the status control files are reset.
40
To stop Outque Sentry from WRKACTJOB From a command line, enter WRKACTJOB. Refer to the appropriate IBM manual for information. Caution: It is not recommended that you stop Outque Sentry from WRKACTJOB. Stopping Outque Sentry in this manner leaves database files in busy status.
Using Outque Sentry

As you use Outque Sentry, remember that one Outque Sentry can contain multiple tasks with multiple operations within each task. Here are a few examples of ways you can use Outque Sentry:
For an example of this, see the sample Outque Sentry, SENTRY01 included with your JetForm Central for AS/400 software.
q
You can use Outque Sentry to work with a JetForm Central running on a non-AS/400 platform. With the *EXECUTE operation, use the JFCVTSPLF command to attach a job card to a spooled file, and then copy the file to a JetForm Central collector directory on an non-AS/400 platform. The spooled file can then be processed using the ^job command and the Job Management Database. You can use Outque Sentry to automate your month-end reports. When the month-end report application runs, Outque Sentry recognizes the spooled file generated. You can use JFTRANS to improve the look of your reports and JFMERGE to print them. At the same time, using a *MOVE or *COPY statement, you can print them at different locations within your office. Using one set of data, you can create three different spooled files for Invoices, Purchase Orders, and Packing Slips. When the spooled files are found, Outque Sentry can use JFTRANS or JFMERGE, which adds a form to your data. You can archive your spooled file to Computer Optical Laser Disk (COLD) Storage at the end of the day. If you have an output queue set up for archive, *MOVE a spooled file using Outque Sentry to this output queue. When a spooled file enters the output queue, Outque Sentry looks through the instructions and tests for conditions. Once a condition is found true, it carries out that instruction, as well as all other instructions within that cluster. Then Outque Sentry sleeps for its allotted time.

q
41
You can execute most AS/400 commands automatically based on output in an output queue. The operation for this function is *EXECUTE. You can enter up to 512 characters. This screen shows an informational message sent to the user who generated a spooled file, indicating that the spooled file was processed.
In addition to AS/400 commands, you can use the following substitution variables within the *EXECUTE operation. The true value for these variables is substituted into the command entered. Variable Variable Name Length Variable Description &COPY &FORM &GENF &JNAM &JNUM &QLIB &QNAM &SENT &SNAM &SNUM &TQLB &TQNM &UDTA &USER 3 10 8 10 6 10 10 10 10 4 10 10 10 10 Number of copies. The forms type of the selected spooled file. A system generated unique file name of the form Jnnnnnnn, where nnnnnnn equals 0000000-9999999. The job name of the original job that created the spooled file. The job number of the original job that created the spooled file. The name of the current output queue library. The name of the current output queue. The name of the Outque Sentry. The file name of the selected spooled file. The file number of the selected spooled file. The name of the To output queue library (*MOVE and *COPY). The name of the To output queue (*MOVE and *COPY). The user data specified for the selected spooled file. The user profile of the user that created the spooled file.
42
In the example above, the command is:

SNDMSG MSG ('Spooled file &SNAM being processed') TOUSR (&USER)
If the USER is Chris and the SNAM is QSYSPRT, then the command executed is:
SNDMSG MSG ('Spooled file QSYSPRT being processed') TOUSR(Chris).
6
Running Transformation Agent
The Transformation Agent, the file conversion component of JetForm Central, is one of the Agent modules of JetForm Central for AS/400. It is a powerful and flexible tool that converts a transaction file from one file format to another. This Agent provides a bridge between your existing applications and JetForm or another system, without requiring changes to your existing application. The Transformation Agent is automatically launched when Outque Sentry performs a task that includes a transformation operation. The Transformation Agent can also be run as a single executable from the JetForm Central Main Menu, or invoked directly from an application program, such as a Control Language (CL) program. In any case, you need to define parameters that tell the Transformation Agent how to transform the data.
See Defining Outque Sentry on page 21 and JetForm Control Language Commands on page 79.
This chapter describes the screens presented when you select 3. Run Transformation Agent from the JetForm Central Main Menu. The parameters required on these screens are the same parameters presented when defining a transformation operation through Outque Sentry or required using CL commands. Note: This chapter gives a brief description of the parameters used when running the Transformation Agent. For a complete description of these parameters, refer to the JetForm Central Reference Manual for Transformation Agent. This manual accompanies your JetForm Central software.
43
44
Defining Transformation Agent Parameters

To define Transformation Agent parameters 1. Access the JetForm Central Main Menu, JFMAIN and select 3. Run Transformation Agent. The Run Transformation Agent (JFTRANS) screen appears.
2. Use the F24 and the F9 function keys to display All parameters.
45
The F11 function key toggles between Keywords and Choices. F11=Keywords displays the keywords associated with the parameters of the command. The keywords are listed to the left of the entry line. F11=Choices displays the descriptions associated with the parameters of the command. They are listed to the right of the entry line. Some of the fields for the Transformation Agent parameters contain default values. These default values are maintained in the Transformation Agent configuration file, JFCENTRAL/INI/JFTRANS. This configuration file is shipped with the Transformation Agent. 3. Complete the fields on this screen as required: Field Name TDF file format Field Description This field is mandatory. Use it to specify the .TDF file format. The choices are: *DBF The input is a member in a source file. This is the default. The source member must be in EBCDIC format. You are prompted for TDF member name. The input is a stream file, for example, a PC document in a folder. The stream file must be in ASCII format. You are prompted for Stream file containing TDF.
*STMF
TDF member name
This field is mandatory if TDF file format is *DBF. Use it to identify the Definition File, which provides the details of the conversion to the Transformation Agent. Enter values for TDF member name, File name and Library. The default Library is JFTDF. This field is mandatory if TDF file format is *STMF. Use it to identify the Definition File, which provides the details of the conversion to the Transformation Agent. Enter values for the folder path and document name. For example, QDLS/JFTDF/SAMPLE.TDF. This field is mandatory. Use it to specify the type of input the Transformation Agent will use. The choices are: *SPOOL The input is a spooled file. This is the default. You are prompted for Spooled File, Job Name and Spooled File Number. *FILE The input is a data file. You are prompted for Input member name.
Stream file containing TDF
Input option
*FORM The input is a form file. You are prompted for Form type and From Output Queue. Input member name This field is mandatory if the value specified for Input option is *FILE. Use it to identify the data file the Transformation Agent will transform. Enter values for Input member name, File name and Library. The default Library is *LIBL.
46
Field Name
For spooled file attributes, see the Attributes option on page 62.
Field Description This field is mandatory if the value specified for Input option is *SPOOL. Use it to specify the name of the spooled file. You can obtain the spooled file name by displaying the spooled file attributes. This field is mandatory if the value specified for Input option is *SPOOL. Use it to specify the Job Name, User and Number of the job that generated the spooled file. You can obtain this job information by displaying the spooled file attributes.
Spooled File
Job Name
Spooled File Number This field is mandatory if the value specified for Input option is *SPOOL. Use it to specify the number of the spooled file. You can obtain the spooled file number by displaying the spooled file attributes. Form type This field is mandatory if the value specified for Input option is *FORM. Use it to specify the form type of the spooled file. You can verify the form type by checking the spooled file attributes.
4. Page down to display more entries:
5. Complete the fields as required: Field Name From output queue Field Description This field is mandatory if the value specified for Input option is *FORM. Use it to provide a value for From Output Queue and Library. The default Library is *LIBL.
Output member name This field is mandatory. Use it to specify the location of the file to which the Transformation Agent writes the transformed data. Enter values for Output member name, File name and Library. The default Library is *CURLIB.
7
Running Print Agent
The Print Agent, the merge component of JetForm Central, is one of the Agent modules of JetForm Central for AS/400. Using intelligent merge technology, the Print Agent enables you to use laser printers to print data merged with electronic forms, designed and compiled in JetForm Design. The Print Agent is automatically launched when Outque Sentry performs a task that includes a print operation. The Print Agent can also be run as a single executable from the JetForm Central Main Menu, or invoked directly from an application program, such as a Control Language (CL) program. In any case, you need to define parameters that tell the Print Agent how to process and print the data.
See Defining Outque Sentry on page 21 and JetForm Control Language Commands on page 79.
This chapter describes the screens presented when you select 4. Run Print Agent from the JetForm Central Main Menu. The parameters required on these screens are the same parameters presented when defining a print operation through Outque Sentry or required using CL commands. Note: This chapter gives a brief description of the parameters used when running the Print Agent. Where a name appears in parenthesis following the parameter name, it is the equivalent Print Agent option name. For example, for the OUTPUT parameter, the Print Agent option name is -z. For a complete description of the Print Agent options, refer to the JetForm Central Reference Manual for Print Agent. This manual accompanies your JetForm Central software.
47
Running Print Agent
48
Defining Print Agent Parameters

To define Print Agent parameters 1. Access the JetForm Central Main Menu, JFMAIN and select 4. Run Print Agent. The Run Print Agent (JFMERGE) screen appears.
2. Use the F10 function key to display Additional parameters and the F24 and F9 function keys to display All parameters.
Running Print Agent
49
The F11 function key toggles between Keywords and Choices. F11=Keywords displays the keywords associated with the parameters of the command. The keywords are listed to the left of the entry line. F11=Choices displays the descriptions associated with the parameters of the command. They are listed to the right of the entry line. Some of the fields for the Print Agent parameters contain default values. In the absence of further input, the Print Agent runs with these default values, which it maintains in its configuration file, JFCENTRAL/INI/JFMERGE. This configuration file is shipped with the Print Agent. The only mandatory field is MDF member name (form name). 3. Complete the fields on this screen as required: Field Name Field Description
MDF member name This field is mandatory. Use it to identify the form file that the (form name) Print Agent merges with the data file. Enter values for MDF member name, File name and Library. The default Library is JFMDF. It is recommended that you use the form name of the form from JetForm Design as the member name. Input option Use this field to specify the type of input the Print Agent will use. The choices are: *SPOOL The input is a spooled file. This is the default. You are prompted for Spooled File name and number, and Job Name. The input is a data file. You are prompted for Input member name. The input is a form file. You are prompted for Form type and From Output Queue.
*FILE *FORM
Input member name This field is mandatory if the value specified for Input option is *FILE. Use it to specify the location of the input file. Provide values for Input member name, Input file name and Library. The default Library is *LIBL.
Spooled File
This field is mandatory if the value specified for Input option is *SPOOL. Use it to specify the Spooled File and Spooled File Number of the spooled file. You can obtain the spooled file name and number by displaying the spooled file attributes. This field is mandatory if the value specified for Input option is *SPOOL. Use it to specify the Job Name, User and Number of the job that generated the spooled file. You can obtain this job information by displaying the spooled file attributes. This field is mandatory if the value specified for Input option is *FORM. Use it to specify the form type of the spooled file. You can verify the form type by checking the spooled file attributes.
Job Name
Form type
Running Print Agent
50
Field Name From output queue
Field Description This field is mandatory if the value specified for Input option is *FORM. Use it to specify the output queue where the spooled file exists. Provide a value for From output queue and Library. The default Library is *LIBL. Use this field to specify the direction of the resulting output from the Print Agent. The choices are: *PRINT *FILE *CFGFILE Direct the output to an output queue. This is the default. Direct the output to a file on the AS/400. Direct the output to the destination specified in the Print Agent configuration file, *LIBL/INI/JFMERGE.
Output (-z)
4. Page down to display more entries:
5. Complete the fields as required: Field Name Output member name Output queue Field Description If the value specified for Output is *FILE, specify the file location. Provide values for Output member name, File name and Library. The default Library is *LIBL. If the value specified for Output is *PRINT, specify the output queue location. Provide values for Output queue and Library. The default Library is *LIBL.
Running Print Agent
51
Field Name Mode (-d, -b, -o)
Field Description Use this field to specify the format of the input data. The choices are: *COMDEL *OVRCAR Comma-delimited mode. Overlay mode with carriage control. This is the preferred format if Input option is *SPOOL or *FORM.
*OVRNCAR Overlay mode without carriage control. *FLDNOM Field-nominated mode. This is the default, and the preferred format if Input option is *FILE.
Number of lines
When you select either of the overlay modes, the system prompts you with this field. Specify the number of lines per page that you want printed. The largest number you should enter is ONE LESS than the maximum that the printer can physically fit on the page. If not specified, the default value is 58 lines. When you select comma-delimited mode, the system prompts you with this field. Enter the character used in your data stream to enclose text strings containing a comma. This ensures that the Print Agent prints these commas literally, and does not treat them as delimiters. If not specified, the default character is a (quotation mark) character. The next three fields govern the handling of macros. Downloading a form as a macro allows for much faster printing, as the Print Agent does not send the form template to the printer each time the form prints. Use this field to specify how macros are handled. The choices are: *NO *PERM *TEMP *FLASH *DISK Do not download a macro. This is the default. Download as a permanent macro. Download as a temporary macro. Download to the printer nonvolatile (flash) memory. Download to the printer hard disk drive.
Enclosed text character
Download macro to printer (-m)
Macro method
Macro number
Use this field to download a form as a specific macro number, by entering that number. When you do not enter a value, the default is the macro number compiled into the form in JetForm Design.
Quiet Download (-q) Use this field to download the form as a macro without printing it, by entering *YES. The default is *NO. Input paper tray (-ati) Use this field to print from a specific input paper tray. Enter either the number of the input paper tray, or the printer command string for the input paper tray. Both are set by the printer manufacturer.
Running Print Agent
52
6. Page down again to display more entries:
7. Complete the fields on this screen as required: Field Name Output paper tray (-ato) Field Description Use this field to print to a specific output paper tray. Enter either the number of the output paper tray, or the printer command string for the output paper tray. Both are set by the printer manufacturer.
Duplex method (-adu) Use this field to specify two-sided printing. The choices specify the binding edge. The choices are: *NO *LONG Do not duplex the output. This is the default. Print the form for binding along the long edge, whether portrait or landscape.
Binding edge
Binding edge
Running Print Agent
53
Field Name
Field Description *SHORT Print the form for binding along the short edge, whether portrait or landscape.
Binding edge
Binding edge
*LEFT
Print the form for binding along the left edge. This option is for portrait orientation only.
Binding edge
*TOP
Print the form for binding along the top edge. This option is for portrait orientation only.
Binding edge
Number of copies (-c) Use this field to specify the number of copies to print. The default is 01. Form already loaded (-l) Event trace level (-n) Use this field to tell the Print Agent that the form is already downloaded as a macro to the printer, by entering *YES. The default is *NO. Use this field to specify an event trace level. Setting the number to 0 returns all event trace messages and setting the number to 100 sets event trace messaging off. The default is 100. Use this field to specify the unit of measure for offsetting data on a page. The choices are: *INCH *CM *MM Offset down Indicate inches as the unit of measure. This is the default. Indicate centimeters as the unit of measure. Indicate millimeters as the unit of measure.
Printer offset (-p)
Use this field to specify the number of the units of measure to move the data vertically on the page. The number can be a decimal to specify an offset of less than a whole number of units. For example, if you specify 1.5 and the unit of measure is *INCH, the Print Agent moves the data down the page one and one half inches. The default is 00.
Running Print Agent
54
Field Name Offset across
Field Description Use this field to specify the number of the units of measure to move the data horizontally on the page. The number can be a decimal to specify an offset of less than a whole number of units. For example, if you specify 2.3 and the unit of measure is *CM, the Print Agent moves the data across the page 2.3 centimeters. The default is 00. Use this field to determine how the Print Agent handles new line characters when processing multiline fields. The choices are: *YES Discard all new line characters, word-wrap data within field boundaries and, when there is more data than a field can hold, overflow it to the next field and the next, until it finishes. For fill justified fields, retain all new line characters, word-wrap data between new line characters and, when there is more data than the field can hold, truncate data at the end of the last word that fits in the field. For all other fields, retain all new line characters, do not word-wrap data between new line characters and, when there is more data than the field can hold, extend the data outside the left and right boundaries of the field. *FOLD Retain all new line characters, word-wrap data within the field boundaries and, when there is more data than the field can hold:
q
Reformat data (-r)
*NO
for fields with a height of one line, overflow data outside the field boundaries. for fields with a height of more than one line, truncate data at the end of the last word that fits in the field.
*OFF
For fill justified fields, discard new line characters, word-wrap data within the field boundaries and, when there is more data than the field can hold, truncate data at the end of the last word that fits in the field. For all other fields, retain new line characters, do not word-wrap data and, when there is more data than the field can hold, extend the data outside the boundaries of the field. *OFF is the default.
Running Print Agent
55
Field Name
Field Description *CLIP Discard all new line characters, word-wrap data within the field boundaries and, when there is more data than the field can hold, truncate data at the end of the last word that fits in the field.
*TRUNCAT Retain all new line characters, word-wrap data within the field boundaries, keep vertical and horizontal placement of data and, when there is more data than the field can hold, truncate data at the end of the last character that fits in the field. Print all form pages (-aap) Extended bar code (-aeb) Use this field to tell the Print Agent to print all pages of a form, by entering *YES. The default is *NO. Use this field to tell the Print Agent to use extended bar code processing, by entering *YES. Extended bar code processing allows the Print Agent to use special extended codes, as well as some non-printable function codes, in Code 128, Subsets CodeB and CodeC. The default is *NO. Use this field to cause the resetting of all field attributes when the Print Agent encounters a new field, by entering *ON. This is the default. Entering *OFF causes the Print Agent to ignore the resetting of field attributes. Use this field to start printing at a specified page number within the form file. Enter the number of the first page to print. The default is *START.
Set field attribute (-afr)
Start page number (-aip)
8. Page down again to display more entries.
Running Print Agent
56
9. Complete the fields as required: Field Name Page range to print (-apg) Field Description Use this field to specify a range of pages to print. To specify more than one range, enter + in the + for more values field. You can print up to 5 page ranges. In any range, the end page must be at least as big as the start page. Ranges can overlap. A page prints if it is covered by any range. A page covered by more than one range only prints once. Use this field to skip characters at the start of the data file. Enter the number of characters to skip. The default is *NONE. Use this field to skip lines at the start of the data file. Enter the number of lines to skip. The default is *NONE.
Skip characters (-asc) Skip lines (-asl)
Note: When you provide a value for both Skip characters and Skip lines, the Print Agent processes the value for Skip lines first, then the value for Skip characters. Override page number (-s) Use this field to override the starting page number for $PAGE fields. $PAGE is a JetForm Design special field name that is filled automatically at print time. Enter the starting page number. The default is 1. Use this field to specify the log file to use for processing messages. Enter values for Log member name, File name and Library. The default Library is JFCENTRAL.
Log member name (-all)
Parameter member Use this field to direct the Print Agent to read its name (@parm) command line options from a file. Create the parameter file with any text editor that produces a plain text file. Separate the options with spaces, or place the options on separate lines. When one of the options includes (quotation mark) characters, the entire option must be on one line. Enter values for Parameter member name, File name and Library. The default Library is JFCENTRAL. Discard unknown fields (-afx) Use this field to tell the Print Agent how to handle data for unknown fields. Entering *ON causes the Print Agent to discard data for unknown fields. Entering *OFF causes the Print Agent to place data for an unknown field in the next field on the form. The default is *OFF. Use this field to tell the Print Agent to use picture formatting, by entering *ON. The Print Agent formats the data for each field according to the picture, if any, assigned to the field by the forms designer. Entering *OFF tells the Print Agent to ignore picture formatting. The default is *OFF.
Picture formatting (-apf)
Running Print Agent
57
Field Name Select field symbol set (-ass)
Field Description Use this field to select a field symbol set. The choices are: 0 2 5 8 10 20 30 35 36 37 40 *CFGFILE Roman-8 extended IBM/PC850 Windows ANSI/ISO Latin 1 Dec Supplemental Shift-Jis KSC5601-87 Big-Five GB2312-80 GBK ANSI CP 950 (Taiwan) EBCDIC translation table - US/Canada English to Roman-8 Use the field symbol set specified in the configuration file. This is the default.
10. Page down again to display the final screen of entries.
Running Print Agent
58
11. Complete the fields as required: Field Name Preamble member name (-apr) Field Description Use this field to inform the Print Agent of the existence of a preamble file. Enter values for Preamble member name, File name and Library. The default Library is JFCENTRAL. The preamble file is an optional file of commands or data that the Print Agent reads before the contents of the data stream. Preamble processing Use this field to have the Print Agent process a (-axps/f) JFPREAMBLE document variable. The choices are: *OFF *ON *FRM Display message level (-v) Do not process a JFPREAMBLE document variable. This is the default. Process a JFPREAMBLE document variable at start-up. Process a JFPREAMBLE document variable associated with a ^form command.
Use this field to set the level of status and information messages that the Print Agent writes to the log file. The choices are: -10 *ALL Write trace messages produced as a result of a ^trace command in the data stream. Write all messages . This includes informational, warning, error and severe messages. Write warning, error and severe messages. This is the default. Write only error and severe messages. Write only severe messages. Suppress all messages.
10 20 30 40
8
Working with Output Queues
JetForm Central for AS/400 allows you to display all the spooled files in a specified output queue for a specified user and form type. You can then perform a number of functions against the files. To view the files in an output queue 1. Access the JetForm Central Main Menu, JFMAIN.
59
60
2. Select 12. Work with Output Queues.
3. Specify the name of the output queue for which you want detailed status information. and the the library where the output queue is located. The possible library values are:
q
*LIBL - all libraries in the jobs library list are searched until the first match is found. *CURLIB - the current library is used to locate the output queue. library-name - specify the library where the output queue is located.
q q
4. Press ENTER to display the Work with Output Queue screen. The name of the output queue, the library containing it and the status of the output queue are shown at the top of the screen. You can use the F4=Select Outq function key to select a different output queue.
61
The columns across the middle of the screen display a list of all spooled files in the output queue, with information about each. Use the F11=View function key to toggle the display to see more columns. The list of spooled files in the output queue is based on parameters defined in the User and Form Type fields at the top of the screen. If desired, you can refine the list by changing the parameters in these two fields. When the screen is first accessed, these fields show their default value of *ALL. The information displayed for each spooled file is: Column File User User Data Status Pages Copies Form Type Pty File Nbr Job User Number Date Time Description The file name that was specified by the user program when the file was created, or the name of the device file used to create the file. The name of the user who owns the spooled file. The 10 characters of user-specified data that describes the file. The status of the spooled file. The total number of pages in the file. The number of copies remaining to print for files processed by a printer writer. The type of forms which should be loaded on the printer. The output priority assigned to the file. The values range from 1 (highest) to 9 (lowest). The number of the spooled file, from the job which created it. The name of the job which produced the spooled file. The name of the user who owns the spooled file. The number of the job which produced the spooled file. The creation date of the spooled file. The creation time of the spooled file.
5. To perform functions against any of the spooled files, type the option number of the function in the Opt column to the right of the spooled file and press ENTER. If you place numbers in the Opt column of several files before pressing ENTER, the specified functions are performed on the files in the order in which the files are displayed. Use the F6=Batch function key to perform functions 10 - 14 as batch jobs, rather than interactively.
62
The available options numbers and the corresponding functions are: Option=Function 2=Change Description Use this option to run the Change Spooled File Attributes (CHGSPLFA) command to change the attributes of the spooled file. Use this option to hold the spooled file. Use this option to delete the spooled file. Use this option to display the data in the spooled file. Use this option to release the spooled file from a hold status. Use this option to display messages related to the printing status of a spooled file. Use this option to display the attributes of the spooled file.
3=Hold 4=Delete 5=Display 6=Release 7=Messages 8=Attributes
9=Work with printing status Use this option to display the printing status of the spooled file. 10=Save Use this option to save the spooled file. Choosing this option runs the Save Spooled File (JFSAVSPLF) command. Use this option to copy the spooled file. Choosing this option runs the Copy Spooled File (JFCPYSPLF) command. Use this option to convert the spooled file. Choosing this option runs the Convert Spooled File (JFCVTSPLF) command. Use this option to run the Transformation Agent. Use this option to run the Print Agent
11=Copy
12=Convert
13=JFTRANS 14=JFMERGE
9
Creating Outque Registries
JetForm Central for AS/400 allows you to create outque registries. An outque registry lets you group output queues, so that Outque Sentry can be more efficient. This allows you to run one Outque Sentry over several output queues, eliminating extra overhead. To create an outque registry 1. Access the JetForm Central Main Menu, JFMAIN.
63
64
2. Select 11. Work with Outque Registries. The Work with Output Queue Registries screen appears.
When you access this screen, all defined registries are displayed and the cursor is in the positioning fields at the top of the screen. The positioning fields allow you the flexibility of displaying only a subset of your registries.
q
Use the Registry ID field to display all registries with a name starting with a letter equal to or greater than a positioning letter. For example, entering the letter S displays all registries starting with the letters S to Z. Use the Registry Description field to display all registries with a description containing a given alphanumeric string. For example, entering the string invoice displays all registries with a description containing this string.
Use the F5=Refresh function key to redisplay all registries. 3. Move the cursor to the Opt column of the input line, the blank line above the previously defined registries. Enter 1 in the Opt column to create a new registry. The cursor moves to the Registry column. 4. Provide a name and description for the new registry in the Registry and Description columns. The name can be up to 10 characters and the description can be up to 40 characters.
65
5. Press ENTER to add output queues to the new registry. The Work with Outques in a Registry screen appears.
6. Move the cursor to the Opt column of the input line and enter 1 to add an output queue. The cursor moves to the OUTQ column. 7. Press ENTER to display the System Outque List, the list of all defined output queues.
66
8. Select the output queues to add to the registry by entering 1 in the OPT column. Added output queue names appear on the Work with Outques in a Registry screen.
Status and Sentry show the status and name of any Outque Sentry that is currently acting on that output queue. In Other Registries shows the number of other registries which contain the output queue. You use the Work with Outques in a Registry screen to delete an output queue from your registry. To do so, enter 4 in the Opt column opposite the output queue and press ENTER. You can also use this screen to show all registries containing a particular output queue. To do this, enter 5 in the Opt column opposite the output queue and press ENTER. The system displays the name and description of all registries containing this output queue. The positioning fields at the top of the screen allow you the flexibility of displaying only a subset of your output queues.
q
Use the Output Queue field to display all output queues with a name starting with a letter equal to or greater than a positioning letter. For example, entering the letter S displays all output queues starting with the letters S to Z. Use the Output Queue Library field to display all output queue libraries with a description matching the search string. For example, entering the string QUSRSYS displays all libraries with this description.
Use the F5=Refresh function key to redisplay all output queues.
67
When you exit the Work with Outques in a Registry screen, the Work with Output Queue Registries screen appears again. This screen now shows all the registries defined, along with the number of output queues in each registry. The input line text is not cleared until you exit the screen.
You use the Work with Output Queue Registries screen to make updates, such as changes or deletions, to your defined registries. Enter the appropriate option in the Opt column opposite the registry you want to update. Note: You cannot use options 2 or 4 to change or delete a registry while it is being monitored by an Outque Sentry.
10
File Transfer
For downloading spooled files, see the Convert option on page 62.
Two files created on the PC, a Definition File (.TDF) and a form file (.MDF), are used by JetForm Central for AS/400. This files must be transferred from the PC to the AS/400 before use. JetForm supports file transfer between the PC and the AS/400 with either AS/400 Client Access or NetManage NS/Folders. In either case, your PC requires access to a shared folder and the AS/400 file system in order to facilitate file transfer.
AS/400 Client Access

These instructions detail how to access a shared folder, QDLS, and the AS/400 file system, QSYS.LIB, using AS/400 Client Access. Before completing these instructions, ensure you have your OS/400 software and the AS/400 Client Access software installed. To access a shared folder on the AS/400 1. On your PC, from Network Neighborhood, access your AS/400 system.
68
File Transfer
69
2. Click QDLS, then use the right mouse button to click Map Network Drive.
3. Assign a drive letter.
File Transfer
70
To access the AS/400 file system 1. On your PC, from Network Neighborhood, access your AS/400 system.
2. Click QSYS.LIB, then use the right mouse button to click Map Network Drive.
File Transfer
71
3. Assign a drive letter.
NetManage NS/Folders Access

These instructions detail how to access a shared folder, QDLS, and the AS/400 file system, QSYS.LIB, on the AS/400, using NetManage NS/Folders. Before completing these instructions, ensure you have your OS/400 software and the NetManage NS/Router and NS/Folders software installed, and the NS/Router AS/400 connection configured and functioning. To access a shared folder on the AS/400 1. From the NS Elite program group, click NS Administrator.
2. Double click the configured router and connect.
File Transfer
72
3. From the NS Elite program group, click NS Folders.
4. On the Tools menu, click Map Network Drive. 5. To map the shared folder, QDLS, to a drive letter, select a drive letter and provide the path information for the folder.
File Transfer
73
6. To map the AS/400 file system, QSYS.LIB, to a drive letter, select a drive letter and provide the path information for the file system.
Note: When saving files to the network, you must have NS/Folders active.
Transferring Files
File transfer to the AS/400 is simply a matter of saving files to the shared folder or the AS/400 file system.
Definition File (.TDF)

You create a Definition File (.TDF) using the Transformation Builder on the PC. The file is then transferred to the AS/400 for use by the Transformation Agent. To transfer a .TDF to the AS/400 1. From Transformation Builder, save the .TDF to the shared folder on the AS/400. For example:
S:\TDF\FORM.TDF
where:
S is the drive letter mapped to the shared folder QDLS. TDF is the shared folder name. FORM.TDF is the file name.
File Transfer
74
2. When running the Transformation Agent, identify the TDF file format as *STMF and complete the Stream file containing TDF field.
Of course, you always have the option of using the AS/400 CPYFRMSTMF command to copy the .TDF file from the shared folder to the AS/400 file system. In that case, when running the Transformation Agent, identify the TDF file format as *DBF and complete the screen prompts for TDF member name, File name and Library.
Form File (.MDF)

You create a form file (.MDF) using JetForm Design on the PC. To transfer it to the AS/400, use the AS/400 file system as the destination address when compiling the form. For example, for the destination address:
Q:\JFMDF.LIB\MDF.FIL\FORM.MBR Q is the drive letter mapped to the AS/400 file system, QSYS.LIB. JFMDF.LIB is the library containing .MDF files. MDF.FIL is the file name. FORM.MBR is the member name.
11
Getting Help
All JetForm products include documentation that describes the product features and functionality. The documentation may take the form of printed manuals, online manuals on the installation media or online help to assist you while you work. For questions about using JetForm software, refer to your product documentation and online help first. Should you require further assistance, our Customer Support representatives are available to answer your questions or help you solve problems. As well, JetForm Corporation offers its customers many other valuable products and services to assist in the implementation of their JetForm solutions.
Registering Your JetForm Software

To register your JetForm product, complete the registration card in your product package. Fax the registration card to the JetForm Information Center at (613) 751-4852 or mail it to: JetForm Information Center JetForm Corporation 560 Rochester Street Ottawa, Ontario K1S 5K2 Canada Forward any change of address to the JetForm Information Center.
Contacting JetForm Customer Support

JetForm Corporation is committed to excellent service. Our goal is to provide you with professional assistance in the use of our software. Customer Support is available to help you get the most out of your JetForm products.
75
Getting Help
76
Before You Call

Take a few minutes to gather the information that the Customer Support staff may need to diagnose and solve your problem. Be prepared to provide a clear, step-by-step description of the issue, and some of the following information:
q
the name, version and serial number of your JetForm product, available by clicking About on the Help menu the operating system/platform and version the mail system, post office and client version the database, middleware and ODBC driver the computer brand and model name, CPU type and clock speed, the amount of hard disk space and total RAM the printer brand and model number, and the printer driver type, either JetForm or Windows the exact error or other status messages that appear onscreen when the problem occurs whether the product is installed locally or on the network whether the problem occurs only on one form or on all forms whether you can reproduce the problem on other computers or with a sample file.
q q q q
q q q
If possible, have the application running when you call. You may be asked to provide the Customer Support representative with all the necessary files to reproduce the problem.
When You Can Call

The JetForm Technical Support Program consists of a set of technical support services tailored to fit a range of customer requirements. Based on your location, telephone support is available according to the following schedule. Telephone Support Schedule Support Plan Within North America
q q q q
Hours of Availability1 Telephone Number
Event-based2 Standard Premium Custom
09:00-20:00 EST 09:00-20:00 EST 07:00-20:00 EST 07:00-20:00 EST
1-900-733-3676 (613) 230-4700 Use your toll free number Use your toll free number
Getting Help
77
Support Plan Within Europe

q
Hours of Availability1 Telephone Number
Universal Freephone (UIFN)
09:00-17:30 GMT
+800 1 689 3676 Contact your local JetForm office.
Outside North America Hours may vary. and Europe

1 2
Times are subject to notified change. Charges apply on a per-call basis, $100.00 US / $125.00 CDN.
For information about the JetForm Technical Support Program, contact your sales representative or the JetForm Information Center in North America at 1-800-JETFORM (538-3676) or in Europe at +353 (1) 819 0088. On the World Wide Web, access the JetForm web site at http://www.jetform.com.
Electronic Support
JetForm Corporation provides electronic support services that are always accessible.
E-mail
For questions, comments or issues directed at Customer Support staff, use the Customer Support mailbox. Support staff monitor this mailbox daily from Monday to Friday, and reply to all messages. Provide your name, company name and product name in the body of your message. Contact Customer Support by e-mail at: support@jetform.com
Internet
Use the JetForm corporate web site to find technical information, provide feedback on our support offering, or to investigate technical solutions. Access the JetForm web site at: http://www.jetform.com or access the Customer Support web site directly at http://jetwizard.jetform.com.
JetForm Information Center

The JetForm Information Center provides friendly, professional assistance. The staff will take care of your request or find the right person to assist you, in matters such as:
q q q q
ordering a product upgrade requesting information about customer support plans requesting product literature finding out about distributors in your area

q
Getting Help
78
replacing missing or defective media or manuals in your package.
Contact the JetForm Information Center by telephone at: 1-800-JETFORM (538-3676).
Replacing Installation Media

To replace a defective installation tape or CD-ROM that is still under warranty, customers in North American can contact the JetForm Information Center. Customers outside North America should contact their authorized dealer.
Returning a Product
To receive a refund for a product purchased through a reseller, please contact the authorized dealer. To exchange or refund a product or upgrade ordered directly from JetForm Corporation, that is covered by our own 60-day money back guarantee, return (by traceable means, such as courier service) the installation tape or CD-ROM and a brief letter of explanation to: JetForm Information Center JetForm Corporation 560 Rochester Street Ottawa, Ontario K1S 5K2 Canada
Using JetForm Product Services

JetForm Corporation offers a variety of services and products to assist you with JetForm-based solutions. If you require a complex custom solution or assistance in implementing JetForm technology, the JetForm Solution Delivery Group can offer a team of professionals to assist you. JetForm Solution Delivery consultants are always available to discuss your particular forms automation requirements. Some of the services provided are:
q
assistance in planning and installing JetForm software on workstations or in network or web environments workflow analysis and change management to help you move from paper forms to electronic forms migration of existing applications to operate in conjunction with or be replaced by JetForm products customization of JetForm products for integration with your existing operating environment. This may include printer driver development, integration with your electronic mail systems, or any custom functionality you require. conversion of your existing paper or electronic forms into JetForm electronic format.
Contact the JetForm Information Center or a Customer Support representative about your request. They will put you in touch with a JetForm Solutions consultant.
A
JetForm Control Language Commands
JetForm Central provides you with JetForm Control Language (CL) commands to embed in your CL programs. The JetForm CL commands are:
EDTF
The EDTF command is an IBM routine from QUSRTOOL. It allows you to edit a database or stream file. It is exactly as provided by IBM, with no modifications of any sort, other than that it has been compiled for your convenience and is available for use. The parameters for the EDTF command are:
q
STMF - Stream File to edit. This field is mandatory. Specify the path name of the stream file you wish to edit, or enter *DBFILE to edit an AS/400 database file. The default is *DBFILE. FILE - DataBase file to edit and Library. If the STMF value is *DBFILE, values for the database file and library must be provided. The database file and library must be valid and created previously. The default Library is *LIBL. MBR - Member to be edited. Specify the database member name you wish to edit. The default is *FIRST.
JFAUTH
The JFAUTH command allows you to input your product authority code into the AS/400 system.
79
80
JFCHGSPL
The JFCHGSPL command allows you to change a spooled file to a data file. The parameters for the JFCHGSPL command are:
q
PRCTYP - Process type. The process type of the spooled file. *EXT is the default and requires the parameters OUTQ and FRMTYPE. *INT requires the parameters INTJOBID and INTSPLID. OUTFILE - Output file name and Library. Destination to receive the output from JFCHGSPL. The default Library is QTEMP. FRMTYPE - Form type. The form type of the spooled file to process. This is a required value if PRCTYP is *EXT. OUTQ - From output queue and Library. The output queue and library of the output queue where the spooled file exists. This is a required value if PRCTYP is *EXT. The default Library is *LIBL. INTJOBID - Internal job ID. The Internal job ID that identifies the job that created the spooled file. Only use this parameter in conjunction with a program that utilizes the IBM APIs, in which case this parameter is passed as a variable. This is a required value if PRCTYP is *INT. INTSPLID - Internal spool ID. The internal spool ID assigned at the time the spooled file was created. This is a required value if PRCTYP is *INT. INCPAGEJC - Include page eject. Specify *YES if you want the output to include the page eject instruction (Hex 0C) in the data stream. Specify *NO to indicate that page ejects should not be included.
JFCPYSPLF
The JFCPYSPLF command allows you to copy a spooled file to an output queue, maintaining all spooled file attributes. The parameters for the JFCPYSPLF command are:
q q
FILE - Spooled File. The name of the spooled file to be copied. TOOUTQ - To Output Queue and Library. The output queue and library to which the spooled file is to be copied. The default Library is *LIBL. JOB - Job Name, User and Number. The name of the job that created the spooled file whose data records are to be copied. For Job Name, specify the name of the job that created the spooled file. For User, specify the user name that identifies the user profile under which the job is run. For Number, specify the system assigned job number. SPLNBR - Spooled File Number. The number of the spooled file, from the job whose data records are to be copied.
81
JFCVTSPLF
The JFCVTSPLF command allows you to convert a single spooled file or a number of spooled files, based on a specific form type and output queue. The files can be converted to either a PC file in a shared folder, or to an AS/400 database file. The parameters for the JFCVTSPLF command are:
q
INPOPT - Input option. The source from which the command will get its data. The choices are either *SPOOL for a specific AS/400 spooled file or *FORM for a single form type in an output queue. SPLFIL - Spooled File. This value is required if INPOPT is *SPOOL. Specify the name of the spooled file to be converted. JOB - Job Name, User and Number. This value is required if INPOPT is *SPOOL. The name of the job that created the spooled file whose data records are to be converted. For Job Name, specify the name of the job that created the spooled file. For User, specify the user name that identifies the user profile under which the job is run. For Number, specify the system assigned job number. SPLNUM - Spooled File Number. This value is required if INPOPT is *SPOOL. Specify the number of the spooled file from the job whose data records are to be copied. FRMTYP - Form type. This value is required if INPOPT is *FORM. Specify the form type to convert from the specified output queue. OUTQ - From Output Queue and Library. This value is required if INPOPT is *FORM. Specify the output queue and library of the output queue where the spooled files with the specified form type are to be converted from. The default Library is *LIBL. OUTFMT - Output File Format. Specify the output option for the conversion. *DBF converts the spooled file to an AS/400 database file. *PCD converts the spooled file to a PC file contained in a shared folder. TOFILE - To data base file and Library. Specify a user-defined physical database file to which the spooled records are copied. If this file does not exist at the time of the copy, the copy creates one in the specified library. MEMBER - To Member. Specify the number of the file member that receives the converted records. MBROPT - Replace or add records. Specify whether the new records replace or are added to the existing records. When the value is *REPLACE, the system clears the existing member and adds the new records. When the value is *ADD, the system adds the new records to the end of the existing records. PCD - To folder. Specify the name of the folder containing the PC document being copied to. The path name can be up to 63 characters in length. All folders in the path must exist.

q
82
TODOC - To document. Specify the name of the PC document in the folder to contain the converted spooled file. If the document does not exist, it is created. Specify a valid document name which has the form filename.extension, such as myfile.ext. filename can be from 1 to 8 characters and extension can be from 1 to 3 characters. REPLACE - Replace document. Specify if an existing document is replaced by the copy operation. When the value is *NO and a document of this name already exists in the folder specified by PCD, the copy is not performed. When the value is *YES and a document of this name already exists in the folder specified by PCD, the document is replaced by the spooled file that is converted. JFJOBNAME - JetForm Central job name. Specify the job name (^job) that identifies the transaction to JetForm Central. JFJOBINFO - Other job card data. Specify additional job card information to be included as part of the job name (^job) command.
JFDEMO
The JFDEMO command launches the JetForm Central Demonstration application environment.
JFDWNLOD
The JFDWNLOD command allows you to download a form or image to a specific printer. The form must be compiled with JetForm Design and be in the .MDF format. Typing the command on the command line accesses selection 3. Load Form in Printer, on the JetForm Central Main Menu. The parameters for the JFDWNLOD command are:
q
MDFNM - MDF member name (form name), File name and Library. This field is mandatory. Use it to identify the form file that the Print Agent merges with the data file. Enter values for MDF member name, File name and Library. The default Library is *LIBL. It is recommended that you use the form name of the form from JetForm Design as the member name. OUTQ - Output queue and Library. Provide values for Output queue and Library. The default Library is *LIBL. DWLOPT - Download Option. Downloading the form as a macro allows for much faster printing, as the Print Agent does not send the form template to the printer each time the form prints. DWLOPT specifies how macros are handled. The choices are:
q q
*PERM - download the macro as a permanent macro. This is the default. *TEMP - download the form as a temporary macro.

q q
83
*FLASH - download the form to the printer nonvolatile (flash) memory. *HDISK - download the form to the printer hard disk drive.
MACRID - Override Macro Id number. The macro Id may be changed by placing a new Id number here. If this is not specified, the macro Id will default to the one within the .MDF.
JFENDSNT
The JFENDSNT command allows you to control the completion of an active Outque Sentry. The JFENDSNT command has one parameter:
q
SENTRY - Sentry Name. The name of the sentry you want to end.
See Stopping Outque Sentry on page 38.
You can also stop Outque Sentry by selecting 10. Work with Outque Sentry on the JetForm Central Main Menu or by ending the job from WRKACTJOB.
JFGETSPLF
See JFPUTSPLF on page 91.
The JFGETSPLF command allows you to copy a spooled file to a database file. The format of the data is such that the contents of the data basefile can then be saved or copied to another output queue using the JFPUTSPLF command. The parameters for the JFGETSPLF command are:
q q
FILE - Spooled File. Specify the name of the spooled file to be copied. TOFILE - To data base file and Library. This is a required parameter. Specify a user-defined physical database file to which the spooled records are copied. If this file does not exist at the time of the get, the get fails. The possible Library values are:
q
*LIBL - all libraries in the jobs library list are searched until the first match is found. *CURLIB - the current library for the job is used to locate the file. QGPL - used if no current library entry exists in the library list. library-name - the name of the actual library where the file is located.
q q q
JOB - Job Name, User and Number. Specify the name of the job that created the spooled file whose data records are to be copied. For Job Name, specify the name of the job that created the spooled file. For User, specify the user name that identifies the user profile under which the job is run. For Number, specify the system assigned job number.

q
84
SPLNBR - Spooled File Number. Specify the number of the spooled file from the job whose data records are to be copied. TOMBR - To member. Specify the name of the file member that receives the copied records. The default is *FIRST.
JFLIBL
The JFLIBL command sets up your library list correctly for JetForm Central. It positions the JFCENTRAL and JFDEMO libraries after the QTEMP and QGPL libraries. It has no parameters to pass.
JFMAIN
The JFMAIN command sets up your library list and calls the JetForm Central Main Menu.
JFMERGE
See Running Print Agent on page 47 and Defining Outque Sentry on page 21.
The JFMERGE command calls the Print Agent. The command parameters are the same as those presented when calling the Print Agent as a single executable from the JetForm Central Main Menu or defining a print operation through Outque Sentry. Note: Where a name appears in parenthesis following the parameter, it is the equivalent Print Agent option name. For example, for the OUTPUT parameter, the Print Agent option name is -z. For a complete description of the Print Agent options, refer to the JetForm Central Reference Manual for Print Agent. This manual accompanies your JetForm Central software. The parameters for the JFMERGE command are:
q
MDFNM - MDF member name (form name), File name and Library. This field is mandatory. Use it to identify the form file that the Print Agent merges with the data file. Enter values for MDF member name, File name and Library. The default Library is JFMDF. It is recommended that you use the form name of the form from JetForm Design as the member name. INPOPT - Input option. Use this field to specify the type of input the Print Agent will use. The choices are:
q
*SPOOL - the input is a spooled file. This is the default. You are prompted for SPLFIL and JOB.

q q
85
*FILE - the input is a data file. You are prompted for INP. *FORM - the input is all the spooled files for a given forms type. You are prompted for FRMTYP and SPOUTQ.
INP - Input member name, Input file name and Library. This field is mandatory if the value specified for INPOPT is *FILE. Use it to specify the location of the input file. Provide values for Input member name, Input file name and Library. The default Library is *LIBL. SPLFIL - Spooled File and Spooled File Number. This field is mandatory if the value specified for INPOPT is *SPOOL. Use it to specify the Spooled File and Spooled File Number of the spooled file. You can obtain the spooled file name and number by displaying the spooled file attributes. JOB - Job Name, User and Number. This field is mandatory if the value specified in INPOPT is *SPOOL. Use it to specify the Job Name, User and Number of the job that generated the spooled file. You can obtain this information by displaying the spooled file attributes. FRMTYP - Form type. This field is mandatory if the value specified for INPOPT is *FORM. Use it to specify the form type of the spooled file. You can verify the form type by checking the spooled file attributes. SPOUTQ - From output queue and Library. This field is mandatory if the value specified for INPOPT is *FORM. Use it to specify the output queue where the spooled file exists. Provide a value for From output queue and Library. The default Library is *LIBL. OUTPUT - Output (-z). Use this field to specify the direction of the resulting output from the Print Agent. The choices are:
q q q
*PRINT - direct the output to an output queue. This is the default. *FILE - direct the output to a file on the AS/400. *CFGFILE - direct the output to the destination specified in the Print Agent configuration file, *LIBL/INI/JFMERGE.
OUTF - Output member name, File name and Library. If the value specified for OUTPUT is *FILE, specify the file location. Provide values for the Output member name, File name and Library. The default Library is *LIBL. OUTQ - Output queue and Library. If the value specified for OUTPUT is *PRINT, specify the output queue location. Provide values for Output queue and Library. The default Library is *LIBL. PRINTMODE - Mode (-d, -b, -o). Use this field to specify the format of the input date. The choices are:
q q
*COMDEL - comma-delimited mode. *FLDNOM - field-nominated mode. This is the default, and the preferred format if INPOPT is *FILE. *OVRCAR - overlay mode with carriage control. This is the preferred format if INPOPT is *SPOOL or *FORM. *OVRNCAR - overlay mode without carriage control.

q
86
PRINTNBR - Number of lines. When you select either of the overlay modes, the system prompts you with this field. Enter the number of lines per page that you want printed. The largest number you should specify is ONE LESS than the maximum that the printer can physically fit on the page. If not specified, the default value is 58 lines. PRINTCHA - Enclosed text character. When you select comma-delimited mode, the system prompts you with this field. Enter the character used in your data stream to enclose text strings containing a comma. This ensures that the Print Agent prints these commas literally, and does not treat them as delimiters. If not specified, the default character is a (quotation mark) character. DWNMTH - Download macro to printer (-m). The next three fields govern the handling of macros. Downloading a form as a macro allows for much faster printing, as the Print Agent does not send the form template to the printer each time the form prints.
q
Macro method - use this field to specify how macros are handled. The choices are:
q q q q q
*NO - Do not download a macro. This is the default. *PERM - Download as a permanent macro. *TEMP - Download as a temporary macro. *FLASH - Download to the printer nonvolatile (flash) memory. *DISK - Download to the printer hard disk drive.
Macro number - use this field to download a form as a specific macro number, by entering that number. When you do not enter a value, the default is the macro number compiled into the form in JetForm Design. Quiet Download (-q) - use this field to download the form as a macro without printing it, by entering *YES. The default is *NO.
TRAYIN - Input paper tray (-ati). Use this field to print from a specific input paper tray. Enter either the number of the input paper tray, or the printer command string for the input paper tray. Both are set by the printer manufacturer. TRAYOT - Output paper tray (-ato). Use this field to print to a specific output paper tray. Enter either the number of the output paper tray, or the printer command string for the output paper tray. Both are set by the printer manufacturer. DUPMTH - Duplex method (-adu). Use this field to specify two-sided printing. The choices specify the binding edge. The choices are:
q q
*NO - do not duplex the output. This is the default. *LONG - print the form for binding along the long edge, whether portrait or landscape. *SHORT - print the form for binding along the short edge, whether portrait or landscape. *LEFT - print the form for binding along the left edge. This option is for portrait orientation only.

q
87
*TOP - print the form for binding along the top edge. This option is for portrait orientation only.
COPIES - Number of copies (-c). Use this field to specify the number of copies to print. The default is 01. FRMLOD - Form already loaded (-l). Use this field to tell the Print Agent that the form is already downloaded as a macro to the printer, by entering *YES. The default is *NO. EVTNBR - Event trace level (-n). Use this field to specify an event trace level. Setting the number to 0 returns all event trace messages and setting the number to 100 sets event trace messaging off. The default is 100. PRTOFF - Printer Offset (-p). Use this field to specify the unit of measure for offsetting data on a page. The choices are:
q q q
*INCH - indicate inches as the unit of measure. This is the default. *CM - indicate centimeters as the unit of measure. *MM - indicate millimeters as the unit of measure.
DOWN - Offset down. Use this field to specify the number of the units of measure to move the data vertically on the page. The number can be a decimal to specify an offset of less than a whole number of units. For example, if you specify 1.5 and the unit of measure is *INCH, the Print Agent moves the data down one and one half inches on the page. The default is 00. ACROSS - Offset across. Use this field to specify the number of the units of measure to move the data horizontally on the page. The number can be a decimal to specify an offset of less than a whole number of units. For example, if you specify 2.3 and the unit of measure is *CM, the Print Agent moves the data 2.3 centimeters across the page. The default is 00. RFMDAT - Reformat data (-r). Use this field to determine how the Print Agent handles new line characters when processing multiline fields. The choices are:
q
*YES - discard all new line characters, word-wrap data within field boundaries and, when there is more data than a field can hold, overflow it to the next field and the next, until it finishes. *NO - For fill justified fields, retain all new line characters, word-wrap data between new line characters and, when there is more data than the field can hold, truncate data at the end of the last word that fits in the field. For all other fields, retain all new line characters, do not word-wrap data between new line characters and, when there is more data than the field can hold, extend the data outside the left and right boundaries of the field.
*FOLD - retain all new line characters, word-wrap data within the field boundaries and, when there is more data than the field can hold:
q q
for fields with a height of one line, overflow data outside the field boundaries. for fields with a height of more than one line, truncate data at the end of the last word that fits in the field.

q
88
*OFF - For fill justified fields, discard new line characters, word-wrap data within the field boundaries and, when there is more data than the field can hold, truncate data at the end of the last word that fits in the field. For all other fields, retain new line characters, do not word-wrap data and, when there is more data than the field can hold, extend the data outside the boundaries of the field. *OFF is the default.
*CLIP - discard all new line characters, word-wrap data within the field boundaries and, when there is more data than the field can hold, truncate data at the end of the last word that fits in the field. *TRUNCAT - retain all new line characters, word-wrap data within the field boundaries, keep vertical and horizontal placement of data and, when there is more data than the field can hold, truncate data at the end of the last character that fits in the field.
ALLFRM - Print all form pages (-aap). Use this field to tell the Print Agent to print all pages of a form, by entering *YES. The default is *NO. EXTBAR - Extended bar code (-aeb). Use this field to tell the Print Agent to use extended bar code processing, by entering *YES. Extended bar code processing allows the Print Agent to use special extended codes, as well as some non-printable function codes, in Code 128, Subsets CodeB and CodeC. The default is *NO. SETATR - Set field attribute (-afr). Use this field to cause the resetting of all field attributes when the Print Agent encounters a new field, by entering *ON. This is the default. Entering *OFF causes the Print Agent to ignore the resetting of field attributes. STRPAG - Start page number (-aip). Use this field to start printing at a specified page number within the form file. Enter the number of the first page to print. The default is *START. RNGPAG - Page range to print (-apg). Use this field to specify a range of pages to print. To specify more than one range, enter + in the + for more values field. You can print up to 5 page ranges. In any range, the end page must be at least as big as the start page. Ranges can overlap. A page prints if it is covered by any range. A page covered by more than one range only prints once. SKPCHA - Skip characters (-asc). Use this field to skip characters at the start of the data file. Enter the number of characters to skip. The default is *NONE. When you provide a value for both SKPCHA and SKPLIN, the Print Agent processes the value for SKPLIN first, then the value for SKPCHA.
SKPLIN - Skip lines (-asl). Use this field to skip lines at the start of the data file. Enter the number of lines to skip. The default is *NONE. When you provide a value for both SKPCHA and SKPLIN, the Print Agent processes the value for SKPLIN first, then the value for SKPCHA.

q
89
RNBPAG- Override page number (-s). Use this field to override the starting page number for $PAGE fields. $PAGE is a JetForm Design special field name that is filled automatically at print time. Enter the starting page number. The default is 1. LOGNM - Log member name, File name and Library (-all). Use this field to specify the log file to use for processing messages. Enter values for Log member name, File name and Library. The default Library is JFCENTRAL. PARFI - Parameter member name, File name and Library (@parm). Use this field to direct the Print Agent to read its command line options from a file. Create the parameter file with any text editor that produces a plain text file. Separate the options with spaces, or place the options on separate lines. When one of the options includes (quotation mark) characters, the entire option must be on one line. Enter values for Parameter member name, File name and Library. The default Library is JFCENTRAL.
DISFLD - Discard unknown fields (-afx). Use this field to tell the Print Agent how to handle data for unknown fields. Entering *ON causes the Print Agent to discard data for unknown fields. Entering *OFF causes the Print Agent to place data for an unknown field in the next field on the form. The default is *OFF. PICFMT - Picture formatting (-apf). Use this field to tell the Print Agent to use picture formatting, by entering *ON. The Print Agent formats the data for each field according to the picture, if any, assigned to the field by the forms designer. Entering *OFF tells the Print Agent to ignore picture formatting. The default is *OFF. SYMSET - Select field symbol set (-ass). Use this field to select a field symbol set. The choices are:
q q q q q q q q q q q q
0 - Roman-8 extended 2 - IBM/PC850 5 - Windows ANSI/ISO Latin 1 8 - Dec Supplemental 10 - Shift-Jis 20 - KSC5601-87 30 - Big-Five 35 - GB2312-80 36 - GBK 37 - ANSI CP 950 (Taiwan) 40 - EBCDIC translation table - US/Canada English to Roman-8 *CFGFILE - Use the field symbol set specified in the configuration file. This is the default.

q
90
PREAM - Preamble member name, File name, and Library (-apr). Use this field to inform the Print Agent of the existence of a preamble file. The preamble file is an optional file of commands or data that the Print Agent reads before the contents of the data stream. Enter values for Preamble member name, File name and Library. The default Library is JFCENTRAL. EXEPRE - Preamble processing (axps/f). Use this field to have the Print Agent process a JFPREAMBLE document variable. The choices are:
q q q
*OFF - Do not process a JFPREAMBLE document variable. This is the default. *ON - Process a JFPREAMBLE document variable at start-up. *FRM - Process a JFPREAMBLE document variable associated with a ^form command.
MSGLVL - Display message level (-v). Use this field to set the level of status and information messages that the Print Agent writes to the log file. The choices are:
q
-10 - Write trace messages produced as a result of a ^trace command in the data stream. *ALL - Write all messages . This includes informational, warning, error and severe messages. 10 - Write warning, error and severe messages. This is the default. 20 - Write only error and severe messages. 30 - Write only severe messages. 40 - Suppress all messages.
q q q q
JFPRTFRM
The JFPRTFRM command allows you to print a form or image to a specified printer. Typing the command on the command line accesses selection 2. Print Form, on the JetForm Central Main Menu. The parameters for the JFPRTFRM command are:
q
MDFNM - MDF member name (form name), File name and Library. This field is mandatory. Enter the MDF member name of the form you wish to print, File name where the MDF member is stored and Library where the MDF file resides. The default Library is JFMDF. OUTQ - Output queue and Library. Provide values for the Output queue and Library. The output queue and library must be valid and created previously. The default Library is *LIBL.
91
JFPUTSPLF
See JFGETSPLF on page 83.
The JFPUTSPLF command is used for restoring a spooled file. It allows you to create a spooled file from a database file. The format of the data in the database file must be created with the JFGETSPLF command. The parameters for the JFPUTSPLF command are:
q
FROMFILE - From File and Library. This is a required parameter. Specify a user-designed physical database file from which the spooled records will be copied. If this file does not exist at the time of the put, the put will fail. The possible library values are:
q
*LIBL - all libraries in the jobs library list are searched until the first match is found. library-name - the name of the actual library where the file is located.
OUTQ - Output Queue and Library. Specify the Output Queue and Library of the output queue to put the spooled file. The default Library is *LIBL. FROMMBR - From Member. Specify the name of the file member that contains the copied records. The default is *FIRST.
JFRELEASE
The JFRELEASE command displays the release version of the JetForm Central, the Print Agent and the Transformation Agent software. As well, it shows the Program Temporary Fixes (PTFs), if any, that are applied. There are no parameters to pass.
JFSAVSPLF
The JFSAVSPLF command allows you to save a single spooled file to a database file, and, if required, copy the file to a PC document in a shared folder. The parameters for the JFSAVSPLF command are:
q q
FILE - Spool File to Save. Specify the name of the spooled file to save. JOB - Job Name, User and Number. Specify the name of the job that created the spooled file whose data records are to be saved. For Job Name, specify the name of the job that created the spooled file. For User, specify the user name that identifies the user profile under which the job is run. For Number, specify the system assigned job number. SPLNBR - Spooled File Number. Specify the number of the spooled file, from the job whose data records are to be saved.

q
92
TO FILE - Save to and Library. Specify a user-defined physical database file to which the spooled records will be saved. If this file does not exist at the time of the save, the save will create one in the specified library if CRTFILE is *YES. The file must have a record length of 4083. MEMBER - To Member. Specify the name of the file member that receives the converted records. CRTFILE - Create File. Specify whether the save file should be created if it does not already exist. The valid values are:
q q
*NO - the file will not be created if it does not exist. *YES - a file with a record length of 4083 with the name and member will be created in the specified library.
If the file already exists but the member does not, a member will be added.
q
CPYSTMF - Copy to stream file. Specify if the TOFILE file is to be copied to a PC shared folder document. The choices are:
q q
*YES - the file will be copied to a PC shared folder document. *NO - the file will not be copied to a PC shared folder document.
TOSTMF - To stream file. Specify the path name of the stream file to which data is copied. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created. REPLACE - Replace or add records. Specify whether the copy operation replaces or adds the records in the stream file. The choices are:
q q
*ADD - the records are added to the end of the existing stream file records. *REPLACE - the records replace the existing stream file records.
JFSBS
Typing the JFSBS command on the command line accesses selection 20. Work with JetForm Subsystem, on the JetForm Central Main Menu. There are no parameters to pass.
JFSTRSNT
The JFSTRSNT command allows you to start Outque Sentry. The parameters for the JFSTRSNT command are:
q
SENTRY- Sentry name. This field is mandatory. Specify the name of the Outque Sentry you want to start. The name can be up to 10 characters.

q
93
AUDLOG - Generate Audit Log. Enter Y if you want to maintain a log of all Outque Sentry activities. The default value is N. The audit log is placed in the message queue named JFSENTRY in the JFCENTRAL library. SLEEP - Sentry sleep time. This is the period, in seconds, in which Outque Sentry waits before checking its output queue. When the value is set to 0, Output Sentry begins immediately and runs one time only. The maximum sleep time is 99,999 seconds. DELAY - Delay time. This field is used to provide a specific start time for Outque Sentry, in the format HH:MM:SS. DATAQ - Data Queue. Use this field to attach a data queue to an output queue. Caution: Outque Sentry creates a data queue in library JFCENTRAL. The data queue name is the same as the Outque Sentry name. When an Outque Sentry is started, the system will change the data queue attached to all the output queues being monitored. When the Outque Sentry is ended, the original data queues, those previously attached to the output queues, will not be reset.
Ignore Spool File Status:

q
RDYSTS - Use this field to ignore spooled files with a spooled file status of RDY. The default is N. HLDSTS - Use this field to ignore spooled files with a spooled file status of HLD. The default is Y. SAVSTS - Use this field to ignore spooled files with a spooled file status of SAV. The default is Y.
JOBQ - Submit to JOBQ. Specify a job queue name. By default, the Library is JFCENTRAL. OUTOPT - Output option. Specify what this Outque Sentry monitors. The choices are:
q q
*REG - This Outque Sentry will monitor a Registry. You are prompted for REGL. *OUTQ - This Outque Sentry will monitor an output queue. You are prompted for OUTQ.
REGL - From Registry List. If OUTOPT is *REG, specify the name of the Outque Registry this Output Sentry will monitor. OUTQ - From Output Queue and Library. If OUTOPT is *OUTQ, specify the Output Queue and Library this Output Sentry will monitor. The default Library is *LIBL. The next three entries, USER, FORMTYPE and USERDATA, allow you to restrict Outque Sentry from processing spooled files other than those specified.
USER - User entries to process. Use this field to enter a user profile, if you are only processing a spooled file created by a specific user. The default is *ALL. FORMTYPE - Form type of entries. Use this field to enter a specific form type (such as *INV, *purchase, *STD). The default is *ALL.

q
94
USERDATA - User data of entries. Use this field to enter specific user data. The default is *ALL.
JFTRANS
See Running Transformation Agent on page 43 and Defining Outque Sentry on page 21.
The JFTRANS command calls the Transformation Agent. The parameters required are the same parameters presented when calling the Transformation Agent as a single executable from the JetForm Central Main Menu or defining a transformation operation through Outque Sentry. The parameters for the JFTRANS command are:
q
TDFTYP - TDF file format. This field is mandatory. Use it to specify the .TDF file format. The choices are:
q
*DBF - the input is a member in a source file. This is the default. The source member must be in EBCDIC format. You are prompted for TDF. *STMF - the input is a stream file, for example, a PC document in a folder. The stream file must be in ASCII format. You are prompted for STMF.
TDF - TDF member name, File name and Library. This field is mandatory if TDFTYP is *DBF. Use it to identify the Definition File, which provides the details of the conversion to the Transformation Agent. Enter values for TDF member name, File name and Library. The default Library is JFTDF. STMF - Stream file containing TDF. This field is mandatory if TDFTYP is *STMF. Use it to identify the Definition File, which provides the details of the conversion to the Transformation Agent. Enter values for the folder path and document name. For example, QDLS/JETFORM/SAMPLE.TDF. INPOPT - Input Option. This field is mandatory. Use it to specify the type of input the Transformation Agent will use. The choices are:
q
*SPOOL - the input is a spooled file. This is the default. You are prompted for SPLFIL, JOB and SPLNUM. *FILE - the input is a data file. You are prompted for INP. *FORM - the input is a form file. You are prompted for FRMTYP and OUTQ.
q q
INP - Input member name, Input file name and Library. This field is mandatory if the value specified for INPOPT is *FILE. Use it to identify the data file the Transformation Agent will transform. Enter values for Input member name, File name and Library. The default Library is *LIBL. SPLFIL - Spooled File. This field is mandatory if the value specified for INPOPT is *SPOOL. Use it to specify the name of the spooled file. You can obtain the spooled file name by displaying the spooled file attributes. JOB - Job Name, User and Number. This field is mandatory if the value specified for INPOPT is *SPOOL. Use it to specify the Job Name, User and Number of the job that generated the spooled file. You can obtain this job information by displaying the spooled file attributes.

q
95
SPLNUM - Spooled File Number. This field is mandatory if the value specified for INPOPT is *SPOOL. Use it to specify the number of the spooled file. You can obtain the spooled file number by displaying the spooled file attributes. FRMTYP - Form type. This field is mandatory if the value specified for INPOPT is *FORM. Use it to specify the form type of the spooled file. You can verify the form type by checking the spooled file attributes. OUTQ - From Output Queue and Library. This field is mandatory if the value specified for INPOPT is *FORM. Use it to provide a value for From output queue and Library. The default Library is *LIBL. OUTF - Output member name, File name and Library. This field is mandatory. Use it to specify the location of the file to which the Transformation Agent writes the transformed data. Enter values for Output member name, File name and Library. The default Library is *CURLIB.
JFWRKOUTQ
The JFWRKOUTQ command allows you to work with a specified output queue. From this interface, you are able to perform various JetForm command functions against a selected spooled file. The parameter for the JFWRKOUTQ command is:
q
OUTQ - Output queue and Library. Specify the name of the output queue for which you want detailed status information. A list of all spooled files on the output queue is displayed, with information about each. The possible Library values are:
q
*LIBL - all libraries in the jobs library list are searched until the first match is found. *CURLIB - the current library for the job is used to locate the output queue. library-name - specify the library where the output queue is located.
q q
JFWRKREG
Typing the JFWRKREG command on the command line accesses selection 11. Work with Outque Registries, on the JetForm Central Main Menu. There are no parameters to pass.
JFWRKSNT
Typing the JFWRKSNT command on the command line accesses selection 10. Work with Outque Sentry, on the JetForm Central Main Menu. There are no parameters to pass.
B
Printer Diagnostics
JetForm Central for AS/400 provides you with the ability to easily troubleshoot printer problems. By selecting 30. Printer Diagnostic Tests, on the JetForm Central Main Menu, you can print test pages to determine the cause of your printer problems.
q q q
Test Page 1 prints standard output, to simulate a spooled file. Test Page 2 prints PCL5 output. Test Page 3 prints PostScript output. This is Test Page 1, standard output.
JetForm Central Test Page 1 This page is an example of spool file data from the AS/400. If this page prints correctly, any generic spool file should also print.
KELLY GREEN 123 MAIN STREET ANYTOWN ST 12345-6789
KELLY GREEN 123 MAIN STREET ANYTOWN ST 12345-6789
0987654321 (987) 654-3210 SHIPPER
N. BROWN 08/30/93
15 7 9 3 2 9 15
51235 SHIELDER GRAY PRINTER CABLES 59874 16K EXTENDED MEMORY BOARD 75421 SUPER GREAT ALL FUNCTIONAL PC MOUSE 54854 EXTERNAL EXPANSION PRINTER SLOTS 36521 SOLUTION FITTING SOFTWARE 29835 DATA CAPTURE TERMINALS (SZ-127P)
12.54 55.28 9.95 67.45 624.00 442.53 21.19
188.10 386.96 89.55 202.35 1,248.00 3,982.77 317.85
65845 TWINAX CABLE (ENDS INCLUDED)
6,415.58
6,415.58 5 320.77 6,736.35
96
Printer Diagnostics
97
This is Test Page 2, PCL5 output.

JetForm Central Test Page 2
This page is an example of PCL5 Data. It is also printed in the JetForm Central manual for your reference.
This is Test Page 3, PostScript output.
JetForm Central Test Page 3 PostScript Printer Diagnostic Test
C
Product Authorization
As part of the installation of JetForm Central for AS/400, the installation program will prompt for a product authorization code. This is the 24 digit code on the label attached to the installation media case. If you do not have the code at the time of installation or it is invalid/expired, installation can continue but key elements of the system will not operate properly. The authorization code is generated when you order the JetForm Central for AS/400 software, either as an evaluation copy or as an outright purchase. In order for JetForm to generate the code, your AS/400 system model and serial numbers are required. If these numbers are not available at the time of ordering, the software can be released with a temporary code, until such time as a valid authorization code is obtained. The temporary code will allow you full access to all elements of the system. A valid authorization code can have two forms:
q
an evaluation code, which authorizes you to use the software free of charge for a period of thirty days. The system will prompt you at intervals during the 30 days, advising you of the time left before your evaluation code expires. a permanent code, obtained when you buy the software.
To order the JetForm Central for AS/400 software, obtain your AS/400 system model and serial numbers and then contact the JetForm Information Center. Their business hours are at 08:30-20:00 EST, Monday through Friday, and they can be contacted by: Telephone 1-800-JETFORM Email Fax jicweb@jetform.com 613-751-4852
98
99
To obtain your AS/400 system model number

q
Sign on to the AS/400 and enter the command:

dspsysval qmodel
To obtain your AS/400 system serial number

q
Sign on to the AS/400 and enter the command:

dspsysval qsrlnbr
100
Entering your Authorization code

The product authorization code is normally entered during the installation of the JetForm Central software. However, it can be entered later, using the JFAUTH command. To enter your authorization code using JFAUTH 1. Access the JetForm Central Main Menu, JFMAIN.
2. From the command line, enter JFAUTH and then press F4.
3. Enter your authorization code and press ENTER. If the code is valid, you will receive the message:
101
and then the message
If the code is invalid, you will receive the message:
If you receive a message that the code is invalid:

q q
confirm that the code is entered correctly confirm that the model and serial number information you provided to generate the code was correct.
Index
$
&COPY 41 &FORM 41 &GENF 41 &JNAM 41 &JNUM 41 &QLIB 41 &QNAM 41 &SENT 41 &SNAM 41 &SNUM 41 &TQLB 41 &TQNM 41 &UDTA 41 &USER 41 JFSTRSNT 92 JFTRANS 94 JFWRKOUTQ 95 JFWRKREG 95 JFWRKSNT 95 cluster Outque Sentry operations 30 collector directory 40 contacting JetForm Customer Support 75 convert spooled file, JFCVTSPLF 24 COPY 24 creating outque registries 63
D
data queue 23 DELETE 24 download spooled file 62
A
about JetForm Central 5 AS/400 Client Access 68 AS/400 file system 68 attributes, spooled file 62 authorization code 98
E
EDTF 79 evaluation code 98 EXECUTE 24
C
CL commands, JetForm EDTF 79 JFAUTH 79 JFCHGSPL 80 JFCPYSPLF 80 JFCVTSPLF 81 JFDEMO 82 JFDWNLOD 82 JFENDSNT 83 JFGETSPLF 83 JFLIBL 84 JFMAIN 84 JFMERGE 84 JFPRTFRM 90 JFPUTSPLF 91 JFRELEASE 91 JFSAVSPLF 91 JFSBS 92
F
file formats 8 file transfer 68 .MDF 74 .TDF 73 QDLS shared folder 73 QSYS.LIB 74 file, spooled, attributes 62 folder, shared 68 form load in printer 18 print blank 18 formats, file 8
G
getting help contacting JetForm Customer Support 75 registering your JetForm software 75
102
Index JFPRTFRM 90 JFPUTSPLF 91 JFRELEASE 91 JFSAVSPLF 91 JFSBS 92 JFSTRSNT 35, 92 JFTRANS 8, 24, 94 JFWRKOUTQ 95 JFWRKREG 95 JFWRKSNT 95 job card, attach to spooled file 40 Job Management Database 9
103
H
help contacting JetForm Customer Support 75 registering your JetForm software 75
I
installing JetForm Central 10 objects created during installation 11
J
JetForm Central about 5 components 7 Outque Sentry 7 Print Agent 8 Transformation Agent 8 Transformation Builder 8 installing 10 Job Management Database 9 main menu 18 running 35 JetForm CL commands EDTF 79 JFAUTH 79 JFCHGSPL 80 JFCPYSPLF 80 JFCVTSPLF 81 JFDEMO 82 JFDWNLOD 82 JFENDSNT 83 JFGETSPLF 83 JFLIBL 84 JFMAIN 84 JFMERGE 84 JFPRTFRM 90 JFPUTSPLF 91 JFRELEASE 91 JFSAVSPLF 91 JFSBS 92 JFSTRSNT 92 JFTRANS 94 JFWRKOUTQ 95 JFWRKREG 95 JFWRKSNT 95 JFAUTH 79 JFCHGSPL 80 JFCPYSPLF 80 JFCVTSPLF 24, 40, 81 JFDEMO 82 JFDWNLOD 82 JFENDSNT 83 JFGETSPLF 83 JFLIBL 84 JFMAIN 84 JFMERGE 8, 24, 84
L
load form in printer 18
M
MOVE 24
N
NetManage NS/Folders 68 NS/Folders 71 NS/Router 71
O
output queues 20 changing 59 outque registries, creating 63 Outque Sentry 7 clustering 30 data queue 23 defining 21 delay start time 23 JFENDSNT 38 JFSTRSNT 35 sentry sleep time 23 starting 35 stopping 38
P
password (authorization code) 98 Print Agent 8 running 47 print blank form 18 printer diagnostic tests 96 product authorization 98
Q
QDLS shared folder 73 QSYS.LIB AS/400 file system 74
Index &SNUM 41 &TQLB 41 &TQNM 41 &UDTA 41 &USER 41 subsystem, JetForm 19
104
R
registering your JetForm software 75 registries, outque, creating 63 run cycle (sleep time) 23 running Print Agent 47 Transformation Agent 43
T S
serial number (authorization code) 98 shared folder 68 sleep time for Outque Sentry 23 spooled file attributes 62 spooled file, download 62 starting JetForm subsystem 19 Outque Sentry 35 stopping JetForm subsystem 19 Outque Sentry 38 substitution variables &COPY 41 &FORM 41 &GENF 41 &JNAM 41 &JNUM 41 &QLIB 41 &QNAM 41 &SENT 41 &SNAM 41 transfer files 68 Transformation Agent 8 running 43 Transformation Builder 8
V
variables &COPY 41 &FORM 41 &GENF 41 &JNAM 41 &JNUM 41 &QLIB 41 &QNAM 41 &SENT 41 &SNAM 41 &SNUM 41 &TQLB 41 &TQNM 41 &UDTA 41 &USER 41

Jet Form

Încărcat de

Informații document

Descriere originală:

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Jet Form

Încărcat de

Drepturi de autor:

Formate disponibile

JetForm Central Reference Manual

Installing JetForm Central ............................................................................. 10

JetForm Central Main Menu........................................................................... 18 Defining JetForm Central Tasks.................................................................... 20

Running JetForm Central............................................................................... 35

Running Transformation Agent..................................................................... 43

Running Print Agent ....................................................................................... 47

Working with Output Queues ........................................................................ 59 Creating Outque Registries ........................................................................... 63

JetForm Central Reference Manual for AS/400

10 File Transfer .................................................................................................... 68

11 Getting Help .................................................................................................... 75

JetForm Control Language Commands ....................................................... 79

JetForm Filler (Cross-platform)

JetForm Central and Outque Sentry

JetForm Central Reference Manual for AS/400

About JetForm Central

Transformation Agent (JFTRANS)

Spooled Files .TDF (Definition Files)

Field Nominated Data

.MDF (Form Files) Form Files Print Agent (JFMERGE)

JetForm Central Reference Manual for AS/400

About JetForm Central

JetForm Central Components

JetForm Central Reference Manual for AS/400

About JetForm Central

JetForm Central Reference Manual for AS/400

About JetForm Central

JetForm Central Job Management Database

JetForm Central Reference Manual for AS/400

Installing JetForm Central

QSPGETSP QSPOPNSP QSPPUTF QUSCRTUS QUSDLTUS QUSLSPL QUSRSPLA QUSRTVUS

JetForm Central Reference Manual for AS/400

Installing JetForm Central

Installing From a Tape

See Product Authorization on page 98.

JetForm Central Reference Manual for AS/400

Installing JetForm Central

When the installation program completes, it displays this menu:

JetForm Central Reference Manual for AS/400

Installing JetForm Central

from a DOS prompt, enter the following copy command:

JetForm Central Reference Manual for AS/400

Installing JetForm Central

JetForm Central Reference Manual for AS/400

Installing JetForm Central

For example: for RISC:

Note: The parameter JFPCCD must be in capital letters.

JetForm Central Reference Manual for AS/400

Installing JetForm Central

See Product Authorization on page 98.

Selection 1. Load Form in Printer

Selection 2. Print Form

JetForm Central Reference Manual for AS/400

JetForm Central Main Menu

Selection 3. Run Transformation Agent

Selection 4. Run Print Agent

Selection 10. Work with Outque Sentry

Selection 11. Work with Outque Registries

Selection 12. Work with Output Queues

Selection 20. Work with JetForm Subsystem

Selection 30. Printer Diagnostic Tests

Selection 90. Signoff

Outque Sentry Capabilities

JetForm Central Reference Manual for AS/400

DELETE EXECUTE *MOVE JFCVTSPLF JFMERGE JFTRANS