User Tools

Site Tools


pub:utilitymenu

This is an old revision of the document!


[ Up To Index ]

Utility Menu

Old Menu

IFDUTILITY                    iDocs Utility Menu                              
                                                            System:   S10AE7BC
Select one of the following:                                                  
                                                                              
  iDocs Engine Options                                                        
     1. Create FMGBATCH Subsystem                            CRTFMGSBS        
     2. Schedule an Engine to Start/stop                     ADDFMGSCDE       
                                                                              
  iDocs Save and Restore Options                                              
     3. Save a Spool File                                    SAVSPLF          
     4. Save a Form Application                              SAVFRMAPP        
     5. Restore a Form Application                           RSTAPP           
     6. Restore Demonstration Applications                   DEMOSETUP        
     7. Restore a Spool File                                 RSTSPLF          
                                                                              
  iDocs System Options                                                        
     9. Create a Remote Out Queue                            CRTIPOUTQ        
    10. System Information                                   SYSINFO          
    11. Add FMG Directory Entry                              ADDFMGDIRE       
                                                                             
  iDocs Administration                                                        
    20. Register inFORM Decisions Products                                    
    21. Register iFAX                                                         
    22. Setup iPDF PCL to PDF Converter                                       
                                                                             
  iDocs Journaling and Audit Trail                                            
    30. Enable Check Journaling                                               
    31. Generate Journal Report                              PRTADTTRL        
                                                                             
  iDocs Manual Checks                                                         
    40. Generate a Manual Payroll Check                      CRTPRPCHK        
    41. Configure Manual Payroll Defaults                    CFGPRPCHK        
    42. Create A Blank Manual Check                          CRTMANCHK       
    43. Generate a Manual AP Check                           CRTAPPCHK       
New menu
 IFDUTILITY                    iDocs Utility Menu                               
                                                             System:   DEVV6CLT 
 Select one of the following:                                                   
                                                                                
   iDocs Engine Options                                                         
      1. Create FMGBATCH Subsystem                            CRTFMGSBS         
      2. Schedule an Engine to Start/stop                     ADDFMGSCDE        
                                                                                
   iDocs Save and Restore Options                                               
      3. Save a Spool File                                    SAVSPLF           
      4. Save iDocs Form/Check                                SAVIFDFRM         
      5. Save iDocs Formset                                   SAVIFDSET         
      6. Save iDocs Engine                                    SAVIFDENG         
      7. Restore a Spool File                                 RSTSPLF           
      8. Restore iDocs Form/Check                             RSTIFDFRM         
      9. Restore iDocs Formset                                RSTIFDSET         
     10. Restore iDocs Engine                                 RSTIFDENG         
     11. Restore Demonstration Applications                   DEMOSETUP          
     12. Export database to XML                               CNVDB2XML         
     13. Import database from XML                             CNVXML2DB         
                                                                                
   iDocs Save and Restore Options (Continue)                                    
     15. Save iDocs data                                      SAVEIDATA         
                                                                                
   iDocs System Options                                                         
     16. Create a Remote Out Queue                            CRTIPOUTQ         
     17. System Information                                   SYSINFO           
     18. Add FMG Directory Entry                              ADDFMGDIRE        
                                                                                
   iDocs Administration                                                         
     20. Register inFORM Decisions Products                                     
     21. Register iFAX  
     22. Setup iPDF PCL to PDF Converter 
     23. Reset iCheck Password                                       
                                                                                                         

iDocs Engine Options

Create FMGBATCH Subsystem

If FMGBATCH subsystem does not already exist this option creates it. By default it reserves 4 MB of storage for the subsystem and has a maximum of 2 concurrent jobs; that allows one engine to run in the subsystem and permits the end engine option to work. FMGJOBQ jobqueue is created to route jobs into the subsystem.

Following are the steps to create FMG subsystem:
-          Create class
-          Create job queue
-          Create job description
-          Create subsystem description
-          Add job queue entry
-          Add routing table entry
Details are below:
1.       Create class (or user can use the existing class): define priority and wait time for running jobs
·         CRTCLS   CLS(&LIB/FMGCLS) RUNPTY(15) TIMESLICE(500) PURGE(*NO) DFTWAIT(120) TEXT('iDocs Subsystem Class')
2.       Create job queue (or user can use the system job queue QBATCH): job queue contains entries for job that are waiting to be processed by the system
·         CRTJOBQ  JOBQ(&LIB/FMGJOBQ) TEXT(‘iDocs Job Queue’)
3.       Create job description
·         CRTJOBD  JOBD(&LIB/FMGJOBD) JOBQ(&LIB/FMGJOBQ) TEXT('iDocs Job Description') RTGDTA('iDocs Job')
Or using QBATCH
·         CRTJOBD  JOBD(&LIB/FMGJOBD) JOBQ(&LIB/QBATCH) TEXT('iDocs Job Description') RTGDTA('iDocs Job')
4.       Create subsystem
·         CRTSBSD SBSD(QGPL/FMGBATCH) POOLS((1 *BASE *N)) MAXJOBS(*NOMAX) TEXT('iDocs Subsystem')
5.       Add job queue entry
·         ADDJOBQE SBSD(QGPL/FMGBATCH) JOBQ(QGPL/FMGJOBQ) MAXACT(*NOMAX) SEQNBR(10)MAXPTY1(*NOMAX)
6.       Add routing table entry
·         ADDRTGE  SBSD(&LIB/FMGBATCH) SEQNBR(9999) CMPVAL(*ANY) PGM(QSYS/QCMD) CLS(&LIB/FMGCLS)

Schedule an Engine to Start/stop

This option creates job schedule entries to start and stop engines. The job schedule, an OS/400 utility, may be viewed with WRKJOBSCDE command. You must uniquely name the start and end jobs.

IMPORTANT: If you want the engine status to display in the engine list display, you must give as the start job name the name of the engine. See the example immediately below:

                       iDocs Schedule Entry (ADDFMGSCDE)                       
                                                                               
Type choices, press Enter.                                                     
                                                                               
Schedule Multiple Engines:                                                     
  iDocs engine name  . . . . . .   MYENGINE      Value, or F4 for list         
  Starting Job Name  . . . . . .   MYENGINE      Character value               
  Starting Scheduled Time  . . .   09:00:00      00:00:00-24:00:00             
  Ending Job Name  . . . . . . .   ENDMYENG      Character value               
  Ending Schedule Time . . . . .   17:00:00      00:00:00-24:00:00             
               + for more values                                               

iDocs Save and Restore Options

Save a Spool File

Use this option to save a *SCS spool file into a folder. Use the Restore A Spool File option below to restore.

Save a Form Application

Use this option to save a form, check, form set, or engine definition into a savefile.

FMGCUST library is created if not present. The data is copied into files in FMGCUST. Savefile FMGSAVF in FMG is created if not present and is otherwise cleared. Library FMGCUST is saved into FMGSAVF.

If email addresses are specified and iMail is installed, the savefile FMGSAVF may be emailed.

Restore a Form Application

This option works on file fmgsavf in folder FORMFMG. It loads a form, check, form set, or engine definition saved under option 4 into library FMG. It will overwrite.

Restore Demonstration Applications

Used to restore demonstration form applications into library FMG.

Restore a Spool File

Used to restore a spool file, loaded as a document in a folder, into an outqueue with specified user data, length, width, and spool file name. This is the inverse of the Save A Spool File option above.

iDocs System Options

Create a Remote Out Queue

Creates a remote outqueue with specified parameters. A front end to OS/400 system commands.

System Information

Displays system information useful to iDocs users and inFORM Decisions support.

Add FMG Directory Entry

Any interactive user profile or profile running a batch engine must have an entry in the system directory. You can add these entries manually with the WRKDIRE command. This option is a front end to the OS/400 commands.

iDocs Administration

Register inFORM Decisions Products

Enter most license keys here. Presently the only key not entered here is for iFax, which is entered through this menu option 21.

Register iFAX

Enter iFax key using this option. All other keys should be entered using option 20.

Setup iPDF PCL to PDF Converter

Before a pcl to pdf conversion is first attempted after installation, or after upgrading the iPDF converter, the command IPDFSETUP should be run. Specify the name of the library containing the converter programs. This is usually FMG. This option deletes and recreates the /ipdf directory in the ifs.

iDocs Journaling and Audit Trail

iDocs contains controls to track who created checks, the day and time that the checks were created and the work station used to create them. For an accounting manager, this information is useful to flag potential anomalies in instances where the same check was created twice. For this reason the journal feature is included as apart of iChecks and needs to be both enabled and configured.

Enable Check Journaling

Selecting option 30 from the utility menu generates the following configuration screen.


 8/12/07                     inFORM Decisions                      FM7100     
10:48:26              Enable Disable Check Journaling              QSECOFR    
                                                                              
                                                                              
                                                                              
             Security Password:                                               
                                                                              
       Enable Check Journaling: N                                             
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
 F3=Exit   F12=Previous                                                       
                                                                              

To enable the journal feature, change the software switch from above to 'Y'. Next, to configure check journaling, the check month, check day, and check year all need to be identified within the application using the reserved mapped fields: CHECKMM, CHECKDD, and CHECKYY respectively. Lastly, from within the bank file maintenance screen, the Positive Pay ID prompt needs to be populated with the check account number.

Neglecting to identify the check date from the spooled file content will result in the check date being populated with the current date.

Generate Journal Report

Option 31 enables the previously collected audit information to be printed. Selecting the item allow the audit criteria to be refined and isolated to a specific date range, and user profile.

                          Print Audit Trail (PRTADTTRL)                    
                                                                           
 Type choices, press Enter.                                                
                                                                           
 Destination Output queue . . . .                 Name                     
   Library  . . . . . . . . . . .     *LIBL       Name, *LIBL              
 Low range user profile . . . . .                 Character value          
 High range user profile  . . . .                 Character value          
 Begin Date . . . . . . . . . . .                 Date                     
 End Date . . . . . . . . . . . .                 Date                     
                                                                           

iDocs Manual Checks

Generate a Manual Payroll Check

Option 40 Enables a manual payroll check to be produced on the fly outside the accounting system. Information entered here needs be reentered for tracking purposes. That said, this enables a user to quickly generate an on-the-fly check containing values not only for the net amount of the check, but also for the check receipt. The receipt lists all of the current and year to date information necessary to closely mirror the same information that would appear on a regularly scheduled check receipt.

Configure Manual Payroll Defaults

Option 41 allows default values to be set or changed when generating checks.

  8/12/07                                                         FM0495      
 11:09:30               Configure Manual Pay Checks               QSECOFR     
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
        Default       Default       Default        Default       Default      
        Form          Bank          Library        Outq           Check#      
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
  F1=Help   F3=Exit   F10=Save   F12=Cancel                                   
                                                                              

Create A Blank Manual Check

Option 42 enables a spooled file to be created with check numbers generated on each page for the range specified. Once the intermediate spooled file is created, the spooled file is merged with the iCheck Application and the bank file specified from the command. Amounts are not prompted for as this command acts only to print blank checks themselves.

                        Create Manual Check (CRTMANCHK)                        
                                                                               
Type choices, press Enter.                                                     
                                                                               
Output queue . . . . . . . . . .   FMGMICR                                     
  Out Queue  . . . . . . . . . .     FMG                                       
From Check Number  . . . . . . .                 1-999999                      
To Check Number  . . . . . . . .                 1-999999                      
Form Application . . . . . . . .   *NONE         Value, or F4 for list         
Bank Definition  . . . . . . . .   *NONE         Value, or F4 for list         
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                        Bottom 
F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display    

  • Output queue must be a valid Output queue and library name. FMGMICR is the default output queue in library FMG.
  • From and To check numbers determine how many Blank Checks will be generated.
  • Form Application must be a valid Check Application with mapping and check overlay to be used.

Note: The check number must be mapped from the BLANKCHECK spool file in the FMGMICR output queue. (Row 1 columns 12-21)

  • Bank Definition is normally the same as the Form Application and this is what provides the Bank routing and MICR information for the check.


Upon execution, 2 entries are created:

1. A raw spool file BLANKCHECK is created in the FMGMICR/FMG output queue. 
  It contains 1 page for each of the check numbers generated.  
  i.e. In the example shown below, the spool file BLANKCHECK in the FMG/FMGMICR output queue is 2 pages. 
2. A merged ASCII print file containing both data and overlay in the selected output queue.

                             Work with Output Queue                             
                                                                                
 Queue:   FMGMICR        Library:   FMG            Status:   RLS                
                                                                                
 Type options, press Enter.                                                     
   1=Send   2=Change   3=Hold   4=Delete   5=Display   6=Release   7=Messages   
   8=Attributes        9=Work with printing status                              
                                                                                
 Opt  File        User        User Data   Sts   Pages   Copies  Form Type   Pty 
      BLANKCHECK  IDOCSUSER   CSGAPCHK    RDY       1       1   *STD         5  
      BLANKCHECK  IDOCSUSER   CSGAPCHK    RDY       1*      1   *STD         5  
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         Bottom 
 Parameters for options 1, 2, 3 or command                                      

A sample raw spool file BLANKCHECK with two pages, 1 each for check numbers 99990 to 99991 is shown below:


                                                        Display Spooled File                                                       
 File  . . . . . :   BLANKCHECK                                                                           Page/Line   1/1          
 Control . . . . .                                                                                        Columns     1 - 130      
 Find  . . . . . .                                                                                                                 
 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8....+....9....+....0....+....1....+....2....+....3
 Check No:  0000099990                                                                                                             
 Check No:  0000099991                                                                                                             
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                                   
                                                                                                                      Bottom
 F3=Exit   F12=Cancel   F19=Left   F20=Right   F24=More keys                                                                       
A sample Check Application Spooled Datamap Screen is hown below:
 3/15/11     12=Cancel                iDocs Form Suite                        FM2540C1  
14:53:08              Spooled Datamap Field Maintenance              KKRAMER   
                      Form: BLANKCHECK blank check from Util #42               
                                                                               
 1=Select   3=Copy   4=Delete   5=Display                                      
                                                                               
                                     From     To     Map                       
Sel Fld Name   Description          Row Col Row Col  Type   Fld   Xloc    Yloc 
    A1CHECK#   PRINT CHECK NUMBER     1  12   1  21   2           2100     170 
    CHECK#     Check Number           1  12   1  21   2           9998    9998 
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                        Bottom 
                                                                               
F3=Exit   F6=Add   F7=Font/No Font   F12=Cancel 

Generate a Manual AP Check

Option 43 enables a user to generate generic check information for accounts payable checks for as many entries specified. Choosing this item displays a blank slate entry for from which the user may enter in the check information in a free style format. Once entered, a properly configured accounts payable check application that maps correctly the relevant check fields will produce the desired checks.

Note that proper authority needs needs to be exercised to run this command which is secured with a password.

The output goes to a spool file called APCHECK in outque FMGBURST. This data must be mapped on an existing check application.

Below contains the example of the entry screen for this AP check entry function:


 8/12/07                       inFORM Decisions                  FM0497D1      
11:30:05                       Manual AP Check                   QSECOFR       
                                                                               
 AP Check Remittance Information                                               
Line 1 details                                                                 
Line 2 details       
                                                             
                                                                        
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit   F10=Save   F12=Cancel   F15=Checks                                  
F10 for the check information screen:

  8/26/11                       inFORM Decisions                  FM0497D2      
 17:21:56                       Manual AP Check                   QSECOFR       
                                                                                
                                                                                
  Check Number. . . . . :        100001                                         
                                                                                
  Check Amount. . . . . :        100.00                                         
                                                                                
  Check Date. . . . . . :  08/24/2011                                           
                                                                                
  Accounts Payable Payee:  John Smith                                                     
                           1234 Main St                                                     
                           Anytown, PA USA                                                     
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 F3=Exit   F10=Save   F12=Cancel                                               

F10 to Save. When finished, press F15 for Checks.

 8/26/11                       inFORM Decisions                      FM0497D7  
17:28:05                       Manual AP Check                       QSECOFR   
                                                                               
 Type information, press Enter.                                                
                                                                               
                                                                               
                                                                               
                      Form Application: MANUALCHECKS F4=List                    
                                                                               
                 Bank File Maintenance: MANUALCHECKS F4=List                    
                                                                               
                     Out Queue Library: FMG                                    
                                                                               
                        Out Queue Name: FMGBURST                                
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit   F10=Save   F12=Cancel                                               
The spool file generated in FMG/FMGBURST is free form but will resemble this:
                                                                              
 Line ....+... 1 ...+... 2 ...+... 3 ...+... 4 ...+... 5 ...+... 6 ...+... 7 .
   1  Line 1 details                                                                 
   2  Line 2 details                                                                 
   3                                                                          
   4                                                                          
   5                                                                          
   6                                                                          
   7                                                                          
   8                                                                          
   9                                                                          
  10                                                                          
  11                                                                          
  12                                                                          
  13                                                                          
  14                                                                          
  15                                                                          
  16      $100.00                                                            
  17               08/24/2011                                                
  18  000000100001                                                           
  19  John Smith
  20  1234 Main St                                                                 
  21  Anytown, PA USA                                                                 
  22                                                                         
  23                                                                         
  24                                                                         
  25  One Hundred Dollars and 00 Cents                                       
  26                                                                         
  27                                                                         
  28                                                                         
  29                                                                         
  30 
 
At this point, you can exit the Utility Menu. Go to iChecks and select the check application with an option 2 to configure the data map.


[ Up To Index ]

pub/utilitymenu.1551719192.txt.gz · Last modified: 2022/06/25 17:02 (external edit)