Sample User Exit Program | IBM S544-5351-03 specs

Table 6. Parameters Passed to the User Exit After the AFPDS Spooled File has been

Created

INFILE	Name of the Input spooled file

INNBR	File number of the input spooled file

INTYPE	Input type of spooled file (SCS, IPDS, *AFPDS, etc.)

JOBUSR	Input creating job&csq;s user

JOBNAM	Input creating job&csq;s name

JOBNBR	Input creating job&csq;s number

INOQNM	Input-output queue name

INOQLB	Input-output queue library

INUSDT	Input user data string

INFORM	Input form type

INOBIN	Input outbin

INPGNM	Input creating program name

INPGLB	Input creating program library

PRTDEF	Name of the print definition that will be applied

PRTDLB	Library of the print definition that will be applied

SUCFLG	YES or NO depending on success or failure

OTFILE	Name of the AFPDS output spooled file created

OTOQNM	Out-queue name of the created AFPDS output spooled file

OTOQLB	Library name of the created AFPDS output spooled file

OTHOLD	YES or NO depending on the Hold flag of the created AFPDS
	output spooled file

OTSAVE	YES or NO depending on the Save flag of the created AFPDS
	output spooled file

OTUSDT	User data string of the created AFPDS output spooled file

OTFORM	Form type of the created AFPDS output spooled file

OTOBIN	Outbin of the created AFPDS output spooled file

USRPRM	Value from the User Parameter (after) field

Sample User Exit Program

The following Control Language (CL) program provides a framework for using the before. middle, and after user exits within APU production processing. This program is provided in the QCCSRC file in the QAPU library.

/******************************************************************************/

/* NAME:	QYPUEXTSMP	*/
/*		*/
/* DESCRIPTIVE NAME:	APU SAMPLE EXIT PROGRAM FOR APYPRTDEF	*/
/*	5798-AF4 (C) COPYRIGHT IBM CORP. 1997	*/
/*		*/
/* FUNCTION:	This sample program demonstrates the	*/
/*	new exit points in the APYPRTDEF command.	*/
/*		*/

/******************************************************************************/

PGM	PARM(&EXPARM)
	/* Exit program parameter string	*/

106APU User's Guide

Image 118

IBM S544-5351-03 manual Sample User Exit Program

Contents

IBM Page IBM Fourth Edition May Contents Part 4. Appendixes Automatic Printing with APU Monitor Figures Vi APU Users Guide Tables Viii APU Users Guide APU Enhancements Purpose of this PublicationOrganization of the Manual APU Users Guide Part 1. Understanding and Preparing to Use APU Introducing Advanced Print Utility APU Users Guide Introducing Advanced Print Utility What is APU?What You Can Do with APU Printing with and without APU Why Use APU?Printing without APU Design Phase Printing with APU Production Phase APU formatting instructions Steps in Creating an APU Document APU Concepts Questions you need to Ask Analyzing the Existing ApplicationExample of Sample Spooled File Source Input Data LOS Using APU to Create a Print DefinitionLocating Required AFP Resources Chantenay Seeds Defining Copies Printing with the Print DefinitionDefining Page Formats APU Introducing Advanced Print Utility APU Users Guide Recommended Preparing to Use the Advanced Print UtilityAPU Prerequisites and Options Required Optional Initial APU Setup SUPER2 Input Inch Apudft Font Installation ConsiderationsReview Document Resource Requirements Calc Super Sun Seeds Invoice Using Fonts with APU Printersville Map Text panel Outline Fonts Custom Fonts Default SYSUSR, *SYS, *ALL Display Font Details on Work with Fonts panel Special Special HelveticaHelvet Image Resources How APU Works with Image Resources Treenb StrwnbInch Strwnb Building Image Resources Overlay Resources How APU Works with Overlays Invoice Full Header InvallInvbac Super SUN Seeds T&C Invfst Invoice First Invlst Invoice Last Invmid Invoice Middle Bar Code Resources Building Overlay ResourcesInvbac Postnet Postal Bar Code Bar Code Example Code 3 of 9 Bar Code ExampleHow APU Works with Bar Codes Map Bar Code panel Postnet Additional Bar Code Attributes Part 2. Creating Print Definitions with APU Building an APU Print Definition for a Single Page Format APU Users Guide Example of a Single-Page Format Document Building an APU Print Definition for a Single Page FormatExample of the SCS File to be Formatted Example of the Formatted File Setting up a Basic Print DefinitionIdentifying Resources Working with a Print Definition Work with Print Definitions SUNSD1 Further Defining the Print DefinitionYES, *NO USER1 Qypuoutq QypuoutqALL Invscs USER1 Qypuoutq Input Working with CopiesCourier LATIN1 Work with Copies panel Layout Options Setting up DuplexingSelecting a Sample Spooled File Layout Options You can Set Defining Page Segments What Duplex Printing Does Defining Overlays Create Page Segment Positioning panel Best WAY Mapping Field DataInvscs Your Printer RE Spar HighNort Mapping a Field as Text Same Performance Boulevard Printersville Using the Repeat Function When you map a field, the mapping is displayed as follows Mapping a Field at Multiple Locations Mapping a Field the First Time Mapping a Field to a Second Position Multiple Mapping Restrictions Building an APU Print Definition for Multiple Page Formats Example of a Multiple Page Format Document Super Sun Seeds Invoice Building an APU Print Definition for Multiple Page Formats Overview of Defining a Multiple Page Format Document Working with a Print Definition Identifying Resources Initial Copy for Page Format OneContinuation Page Format Starting to Work on a Print Definition Invoice Developing Your Print DefinitionYES YES, *NO Define a Print Definition panel displays APU1 Set Print Definition Attributes Screen 1 panel Perelman Qypuoutq RDY Invscs HLD Defining Selection Fields Set Print Definition Attributes panel 2 panel Inside page formats are copies Defining the Page Layout Specifying the Back Overlay Mapping Fields Back Overlay Terms and Conditions Invbac Goldenoats Nochems Mapping Bar CodesOrganic Garden Supplies Chris Seeder Map Bar Code panel Selecting Fonts Defining Constant DataText Outline Fonts Define Overlays panel Replicating the Contents of Copies Fava Seeds Arboles DEL SURSeed Roaster Oven SET Purple Teepee Seeds Continuation Page Copies Sample Packing List Showing Suppression PAGE1 Pagen Create with Copies panel Packing USE USE, *OMIT, *GOTO AND, or USE PAGE1 Pagen APU Users Guide Manual and Command Line Printing Part 3. Printing With APU APU Users Guide Methods of Printing with APU Manual and Command Line Printing with APUManually Associating a Print Definition with a Spooled File John Panel 1 Apply Print DefinitionNormal Spoolfile Panel 2 Apply Print DefinitionJOB NO, *YES Using the Apply Print Definition Command Panel 3 Apply Print Definition Introduction to the APU Monitor Automatic Printing with APU MonitorUnderstanding How the APU Monitor Works An Example of APU Monitor Processing Customer Environment Implementing the Customer Requirements on the APU Monitor Outq Save Condition of the Output Queue after Processing APU Monitor Action Example Configuring APU Monitor APU Main Menu Specifying the Queues APU is to Monitor Qgpl Initial Panel Configuring APU Monitor ActionCreating an Action Group Entry Defining Selection for Input Spooled File Qpjob Defining Action for Input Spooled FileOUTQ1 Outq Defining Action for Output Spooled FileAn Example of this Processing Step OUT1 Action Defining User Exit Before and Middle Spooled File Location after Processing Prtdeflib SamplePRT01 YES, *NO, Spoolfile Defining User Exit AfterDevd Starting APU Monitor Begin at the APU Main menu, as shown in Figure Stopping APU Monitor Monitor Part 4. Appendixes APU Users Guide Appendix A. APU Samples Name Type APU Users Guide Appendix B. User Exits Processing PhasesUser Exit Before User Exit Middle Parameters Passed to the Before Initialization User Exit User Exit After Parameters Passed to the Middle User Exit Sample User Exit Program VAR&EXINFILE VAR&EXPARMVAR&EXINNBR VAR&EXJOBUSR VAR&RESERVEDVAR&EXINTYPE VAR&EXJOBNBR HOLD’ *CAT &EXOTHOLD *TCAT ’ SAVE’ + MSG’APUExinfile *TCAT ’.’ *CAT &EXINNBR *BCAT + CAT &EXOTSAVE *TCAT ’’ TOUSR*SYSOPR Return Endpgm Appendix C. APU Helpful Hints Apyprtdef CommandAPU Defaults Maximum APU Values Mapping Data Copies and Page Formats Creating Your Own Copy of Invscs DuplexCreating Sample Spool Files Recreating Invpre and Invscs APU Users Guide Appendix D. AFP Resource Commands Creating Font Resources Curlib Creating Overlay ResourcesFntrsc MBR Fntrsc MBR OVL Creating Page Segment ResourcesOVL Datatype Afpds Pagseg MBR Pagseg Appendix D. AFP Resource Commands APU Users Guide Methods of Rotating Text Data Appendix E. Rotation HintsGeneral Rules APU Users Guide Appendix F. Font Samples Times New Roman Medium Helvetica Roman Bold Helvetica Roman Bold Courier Courier Font Samples APU Users Guide Glossary 127 Bar Code Object Content Architecture Bcoca Glossary MICR. Magnetic ink character recognition Glossary Spooling simultaneous peripheral operation online Trademarks IBM APU Users Guide Index Extaft OverlayCpysplf Extbef User exit APU Users Guide Readers Comments Ð Wed Like to Hear from You How satisfied are you that the information in this book is Business Reply Mail Page Ibmr