Intermate iSeries User Manual

Page of 490
176
    User’s Manual for InterForm400
®
Note that there are no user exit programs delivered with InterForm400
®
, as they must be
written specifically for the application or database they should integrate to.
 
J TIP J
 You can only add to (not overwrite) the contents of the spooled file by use an exit
program. If you want to overwrite the contents you need to use the CRTPBSPLF
command - see page 406.
M WARNING M
 All exit programs called by InterForm400
®
 must be owned by QSECOFR. If it is not the
AFC job will halt with an error message. Change the owner with the command: 
CHGOBJOWN OBJ(library/program) OBJTYPE(*PGM) NEWOWN(QSECOFR)
Defining the spool file attributes for the result of a Split
          Change Split Definition                                     SPL310D
  
 Split definition name  . : SHIPPING_
 Description  . . . . . . : Extract invoices only
 Split detail description : Split Invoice/Credit
 Output queue . . . . . . . . . . . . __________  *INPUT, *NONE, Name
   Library  . . . . . . . . . . . . .   ___________
 Page size
   Length, Lines per page . . . . . . ______      *INPUT, 1-255
   Length, positions per line . . . . ______      *INPUT, 1-378
 Lines per inch . . . . . . . . . . . ______      *INPUT, 3, 4, 6, 7.5, 8, 9, 12
 Lines per inch . . . . . . . . . . . ______      *INPUT, 3, 4, 6, 7.5, 8, 9, 12
 Characters per inch  . . . . . . . . ______      *INPUT, 5, 10, 12, 13.3, 15...
 Overflow line number . . . . . . . . ______      *INPUT, 1-255
 Font ID  . . . . . . . . . . . . . . ______      *INPUT, *CPI, 3, 5, 11, 12... 
 Degree of page rotation  . . . . . . ______      *INPUT, *AUTO, *COR, 0, 90... 
 Form type . . . . . . . . . . . . .  ______      *INPUT, Character value, *STD 
 Spool file name  . . . . . . . . . . ______      *INPUT, *USER, *JOBNAME, Name 
 User data  . . . . . . . . . . . . . ______      *INPUT, *USER, *JOBNAME ...
 Hold spooled file  . . . . . . . . . ______      *INPUT, *NO, *YES
 Save spooled file  . . . . . . . . . ______      *INPUT, *NO, *YES
 F3=Exit                                                     F12=Cancel
 
Output queue: The output queue where the resulting spool entry from the split should be
sent to. 
The value *NONE means that the pages are not printed, but the user exit
program is called. This allows for a user exit program to take data from
pages which are not printed, and transfer them to the following pages.
The rest of the values are corresponding to the spool file attributes found in a printer file
(PRTF). 
Blank fields equals *INPUT, which means the attributes of the original spool entry will be
copied to the resulting spool entry from the split. A user exit program can overwrite these
values, if any of the fields are filled out, when returning from the exit program.
The original spool entry will after the split remain untouched with status *RDY and could
be processed immediately by other AFC definitions, even another Split definition.