User Tools

Site Tools


pub:preprocessor

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
pub:preprocessor [2018/09/14 20:06] – [Configuration] kkramerpub:preprocessor [2022/06/25 17:02] (current) – external edit 127.0.0.1
Line 41: Line 41:
 ===== Configuration ===== ===== Configuration =====
  
-To configure the SmartRouter, issue the command **SR3** (SmartRouter v3) or take option option 13 iDocs Smart Router from the iDocs menu. +To configure the SmartRouter, issue the command **SR3** (SmartRouter) or take option option 13 iDocs Smart Router from the iDocs menu.  
 + 
 +===== Engine Definitions =====
  
 At the first screen you may create up to 9,999 preprocessor definitions.  At the first screen you may create up to 9,999 preprocessor definitions. 
Line 73: Line 75:
  
 <html><pre> <html><pre>
-  9/14/18                     iDocs SmartRouter                     PR0010R4    +  2/26/22                     iDocs SmartRouter                     PR0010R4    
  20:01:06              SR Engine Definition Maintenance             KKRAMER       20:01:06              SR Engine Definition Maintenance             KKRAMER     
                                                                                                                                                                  
   SR Engine Name/Desc: OFACKTEST  Test Ack for Adel W                              SR Engine Name/Desc: OFACKTEST  Test Ack for Adel W                           
   Data Queue Name/Lib: OFACKDTQ   OFERRER                                          Data Queue Name/Lib: OFACKDTQ   OFERRER                                       
-  Archive Outque/Lib.: ARCHIVE2   OFERRER                                       +  Archive Outque/Lib.: ARCHIVE2   OFERRER       Archive/Delete/Hold: <u>D</u> A/D/H                                      
                                                                                                                                                                  
   Process Spool File.: *JOBQ      *CALL, *JOBQ                                     Process Spool File.: *JOBQ      *CALL, *JOBQ                                  
Line 103: Line 105:
  
   * **DataQueue** name and library:  the name of the dataqueue to which the SmartRouter engine will listen for spool files. This dataqueue can not be in use by other dataqueue engines such as those of iDocs, iMail, or iView. The SmartRouting engine will create the dataqueue for you and connect it to the outqueues when you start the engine.   * **DataQueue** name and library:  the name of the dataqueue to which the SmartRouter engine will listen for spool files. This dataqueue can not be in use by other dataqueue engines such as those of iDocs, iMail, or iView. The SmartRouting engine will create the dataqueue for you and connect it to the outqueues when you start the engine.
-  * **Archive** outqueue and library:  endpoint for the original spool file.+  * **Archive** outqueue and library:  endpoint for the original spool file. \\ 
 +Archive/Delete/Hold: A/D/H - SR 6.89 2/26/22 \\  
 +A: Original spool file will be moved to archive queue after processed\\ 
 +D: Original spool file will be deleted after processed\\ 
 +H: Original spool file will be held in current queue after processed\\ 
 +Blank: do nothing with original spool file\\ 
   * **Process Spool File**: Specify *JOBQ to process a spool file in a separate job via SBMJOB. The parameters of the SBMJOB call are provided in the next three parameters. Use *CALL to process a spool file via a CALL, resulting in processing in the same job as the engine.   * **Process Spool File**: Specify *JOBQ to process a spool file in a separate job via SBMJOB. The parameters of the SBMJOB call are provided in the next three parameters. Use *CALL to process a spool file via a CALL, resulting in processing in the same job as the engine.
   * **Job Queue Name**: Provide the name of a job queue if processing with the *JOBQ option. Single threaded job queues will process Smart Routing jobs serially. Multi threaded jobqueues will process them concurrently.    * **Job Queue Name**: Provide the name of a job queue if processing with the *JOBQ option. Single threaded job queues will process Smart Routing jobs serially. Multi threaded jobqueues will process them concurrently. 
Line 147: Line 154:
 ==== Applications ==== ==== Applications ====
  
-**Option 5 - View** from the main Smart Router engine listing permits you to drill down to applications contained within the SmartRouter.+**Option 5 - View** from the main Smart Router engine listing permits you to drill down to applications contained within the SmartRouter and make any additions or changes to the Targets and Conditions.
  
 <html><pre> <html><pre>
-  5/12/09                      iDocs SmartRouter                      PR0020H1   +  9/14/18                      iDocs SmartRouter                      PR0020H1   
- 14:55:01              Application Definition Maintenance             QSECOFR   + 20:08:59              Application Definition Maintenance             KKRAMER   
                                                                                                                                                                  
-  SR Engine Name/Desc: JOBLOG     Example Application                            +  SR Engine Name/Desc: OFACKTEST  Test Ack for Adel W                            
-  Data Queue Name/Lib: JOBLOGDTAQ DCYQC                                          +  Data Queue Name/Lib: OFACKDTQ   OFERRER                                        
-  Archive Outque/Lib.: OUTQARC    DCYQC                                         +  Archive Outque/Lib.: ARCHIVE2   OFERRER                                       
                                                                                                                                                                  
  Type option, press enter.                                                        Type option, press enter.                                                      
Line 161: Line 168:
                                                                                                                                                                  
  Opt Engine App Description          Form App  Act                                Opt Engine App Description          Form App  Act                              
-     MAINAPP    Main Application     JOBLOG                                      +     OFACKTEST  Ack test             OFACKADEL2                                  
-     MAINAPP2   Main Appl 2          JOBLOG                                      +                                                                                 
-     MAINAPP3   Main Appl 3          JOBLOG                                     +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                
                                                                                                                                                                  
- 
                                                                                                                                                                  
                                                                         More...                                                                          More... 
Line 231: Line 242:
  
 ==== Conditions ==== ==== Conditions ====
-Conditions are entered via option 6, and are attached to applications and/or targets. +Conditions are entered via **option 6**, and are attached to applications and/or targets. 
  
   * When attached to the **application**, the conditions are evaluated once at the beginning of the processing of a spool file. If the tests fail, the application and all its targets are not considered further for the spool file.   * When attached to the **application**, the conditions are evaluated once at the beginning of the processing of a spool file. If the tests fail, the application and all its targets are not considered further for the spool file.
Line 274: Line 285:
  
  
-There is a feature where you can name your document is using the **&EMAIL** option: +There is a feature where you Name objects or conditional list as fields which we defined and they can be reused for many times using the **&EMAIL** option: 
-Press F8 when cursor is at &EMAIL and the following PR0035W3 window appears:+**Press F8 when cursor is at &EMAIL** and the following PR0035W3 window appears:
 <html><pre> <html><pre>
   9/14/18                     iDocs SmartRouter                     PR0035H1       9/14/18                     iDocs SmartRouter                     PR0035H1    
Line 301: Line 312:
   F3=Exit  F23=Delete  F5=Refresh  F6=Insert  F12=Cancel                           F3=Exit  F23=Delete  F5=Refresh  F6=Insert  F12=Cancel                        
 </pre></html> </pre></html>
-You can now use the F8=Cond. Named Object option to name the object.  The PR0036W1 window is displayed as shown below:+You can now use the **F8=Cond. Named Object** option to name the object.  The PR0036W1 window is displayed as shown below:
 <html><pre> <html><pre>
   9/14/18                     iDocs SmartRouter                     PR0035H1       9/14/18                     iDocs SmartRouter                     PR0035H1    
Line 328: Line 339:
 </pre></html> </pre></html>
  
 +Select a field with option 1 and the PR0035W3 window is displayed as shown below:
 +<html><pre>
 +  9/14/18                     iDocs SmartRouter                     PR0035H1    
 + 13:24:46              Target Spoolfile Page Conditions             KKRAMER     
 +                                                           PR0035W3             
 + SR                     Testing Values                                          
 + Ap                                                                  6W1.       
 +  F   Field . . : &EMAIL                                                :       
 + Ta   Test  . . : *EQ *EQ, *LT, *LE, *GT, *GE, *NE, *IN                 :       
 +  D                                                                     :       
 +  O   Test value (&MapField, *Attribute,Value, Value1 Value2..)         :       
 +      EMAILADD                                                          :       
 +                                                                        : UTQUE 
 +  L                                                                     : BNAME 
 +                                                                        : G     
 +                                                                        :       
 +  0                                                                     :       
 +  0                                                                     :       
 +  0                                                                     :       
 +  0                                                        More...      :       
 +  0    F4=Prompt  F8=Cond. Named Object  F10=Save                       :       
 +  0                                                                     :       
 +                                                                        : re... 
 +                                                                        :       
 +  F3=Exi :..............................................................:       
 +                                                                                
 +</pre></html>
  
 +Enter a Value i.e.:                                                      
  
-<html><pre>+  Webmaster@INFORMDECISIONS.COM                                  
 + 
 +  
 + 
 +Then we can use field EMAILADD to replace long name ‘Webmaster@INFORMDECISIONS’ 
 +The Smart Router will check test value as conditional list, if found will replace test value by values which we have defined. 
 + 
 +**Tests and Keyword descriptions:** 
 +<html><pre>                                                       
                                                                                                                                                                  
   Line      and  Attribute or           Attribute or                               Line      and  Attribute or           Attribute or                            
Line 341: Line 388:
                                                                                                                                                                  
 </pre></html> </pre></html>
- 
  
   * **And/Or**:  As implied.   * **And/Or**:  As implied.
Line 360: Line 406:
  
 ^ Comparand keyword ^ Meaning ^ ^ Comparand keyword ^ Meaning ^
-| ***USRPRF**  | User profile owning the spool file | +| ***BLANKS**  | The compared field is blank |  
 +| ***USRPRF**  | User profile owning the spool file |
 | ***USRDTA** | Spool file user data |  | ***USRDTA** | Spool file user data | 
 | ***OUTQUE** | Spool file outqueue |  | ***OUTQUE** | Spool file outqueue | 
Line 368: Line 415:
 | ***JOBNAME** | Spool file job name |  | ***JOBNAME** | Spool file job name | 
 | ***TOTALPG** | Spool file total pages |  | ***TOTALPG** | Spool file total pages | 
 +
 +1. The processing priority:
 +
 +  * Map fields (with prefix ‘&’)
 +  * Attributes of spool file (with prefix ‘*’) attributes:
 + *SPLFILE
 + *USRPRF
 + *JOBNAME
 + *USRDTA
 + *FORM
 + *PGM
 + *TOTALPG
 + *OUTQUE
 + *OUTLIB
 +  * Name object: The first ten characters will be look up in list name objects
 +  * Constant value       
 +
 +2. Program will deal values above for both 2 fields: ‘Field’ and ‘Test value’. For example, we can define as below:
 +<html><pre> 
 +Field . . : ORLANDO@INFORMDECISIONS.COM                                
 +
 +Test  . . : *EQ *EQ, *LT, *LE, *GT, *GE, *NE, *IN          
 +
 +                                                            
 +
 +Test value (&MapField, *Attribute,Value, Value1 Value2..)  
 +
 +&EMAIL                                         
 +</pre></html>
 +
 +3. Regarding test values: ‘Value, Value1 Value2…’ the program compare values as Constants
 +<html><pre>                                                 
 +
 +                 Maintain Conditional List      
 +
 +                                                 
 +
 +  Name: ODD1-5     Description: Odd Pages 1 - 5 
 +
 +                                                 
 +
 +  Value:                                        
 +
 +  1 3 5       
 + 
 +
 +                  Testing Values                        
 +
 +Field . . : &EMAIL                                      
 +
 +Test  . . : *EQ *EQ, *LT, *LE, *GT, *GE, *NE, *IN       
 +
 +                                                         
 +
 +Test value (&MapField, *Attribute,Value, Value1 Value2..)
 +
 +ODD1-5                                                  
 +</pre></html>
 + 
 +
 +It similar to this case below:
 +<html><pre> 
 +                  Testing Values                        
 +
 +                                                         
 +
 +Field . . : &EMAIL                                      
 +
 +Test  . . : *EQ *EQ, *LT, *LE, *GT, *GE, *NE, *IN       
 +
 +                                                         
 +
 +Test value (&MapField, *Attribute,Value, Value1 Value2..)
 +
 +1 3 5                      
 +</pre></html>
 +
 +==== Insert Text ====
 +Spool file text is entered via **option 8**. 
 +
 +<html><pre>
 +                               iDocs SmartRouter                      PR0032R1  
 +                          Insert Text into Spool File                 KKRAMER   
 +                                                                                
 +  SR Engine Name/Desc. : EARNINGS1  Example Earning No.1                          
 +  Application Name/Desc: EARNSRENG  Earning SR Engine                           
 +  Form App Reference . : EARNADD    Used for Emp.number add                     
 +  Target Name/Desc . . : HANDOFF    To Handdoff OutQ                            
 +                                                                                
 +  Source Spool Text:                                                            
 +   Map Field : EMPLOYNO1  Or Constant                                           
 +   From Page :            Output Text To: Row   1 Column  50 Page:              
 +   Map Field : EMPLOYNO2  Or Constant                                           
 +   From Page :            Output Text To: Row   1 Column  50 Page:              
 +   Map Field :            Or Constant                                           
 +   From Page :            Output Text To: Row     Column     Page:              
 +   Map Field :            Or Constant                                           
 +   From Page :            Output Text To: Row     Column     Page:              
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 + F3=Exit  F2=Conditionally Map F4=Prompt F5=Refresh  F12=Cancel F14=Remove Text
 +                                                                                
 +</pre></html>
 +
 +== F2=Conditionally Map ==
 +
 +**On iDocs 6.96 and older...**
 +Under the Insert Text function of a Smart Router Application, Conditions were universally applicable to all Mapped Fields listed under the Source Spool Text parameters.
 +
 +**On IDocs 6.97 and newer...**
 +Under the Insert Text function of a Smart Router Application, Conditions are now independently applicable to each of the Mapped Fields listed under the Source Spool Text parameters.\\
 +When you put the cursor on each of the Mapped Fields and select the **F2=Conditionally Map option**, you will see a window to apply your condition to the specific Mapped Field.
 +For example, for Mapped Field MAPONE, we can have a condition in which the Mapped Field is not equal (*NE) to - - - 
 + - - - (five dashes) \\
 +
 +F2=Conditionally Map option on Mapped Field MAPONE displays the screen below:
 +<html><pre>
 +                               iDocs SmartRouter                      PR0032R1  
 +                          Insert Text into Spool File                 KKRAMER   
 +                                                                                
 +  SR Engine Name/Desc. : EARNINGS1  Example Earning No.1                          
 +  Application Name/Desc: EARNSRENG  Earning SR Engine                           
 +  Form App Reference . : EARNADD    Used for Emp.number add                     
 +............................................................................... 
 +:  Conditionally Map Field:    &EMPLOYNO1                                     : 
 +:                                                                             : 
 +:    Line#   AND/OR Mapped Field    Test  Value                               : 
 +:                                                                             : 
 +:    0001             *NE   -----                                             : 
 +:    0002                                                                     : 
 +:    0003                                                                     : 
 +:                                                                     More... : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:.............................................................................: 
 +                                                                                
 +</pre></html>
 +For the second Mapped Field MAPTWO, we can have a condition in which the Mapped Field is not equal (*NE) to *BLANK
 +<html><pre>
 +                               iDocs SmartRouter                      PR0032R1  
 +                          Insert Text into Spool File                 KKRAMER   
 +                                                                                
 +  SR Engine Name/Desc. : EARNINGS1  Example Earning No.1                          
 +  Application Name/Desc: EARNSRENG  Earning SR Engine                           
 +  Form App Reference . : EARNADD    Used for Emp.number add                     
 +............................................................................... 
 +:  Conditionally Map Field:    &EMPLOYNO2                                     : 
 +:                                                                             : 
 +:    Line#   AND/OR Mapped Field    Test  Value                               : 
 +:                                                                             : 
 +:    0001             *NE   *BLANK                                            : 
 +:    0002                                                                     : 
 +:    0003                                                                     : 
 +:                                                                     More... : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:.............................................................................: 
 +                                                                                
 +</pre></html>
 +
 +**On IDocs 6.97 and newer continued** \\
 +**F4 Prompt** in the **Page**: field will specify where the inserted text will appear.  Enter *FIRST, *LAST, *EXTB, *EXTE, *2NDLS or certain page number where text will be displayed. \\ 
 +**Page:** field parameters on the Insert Text into Spool File screen are as follows:
 +
 +  * ** *FIRST** = Insert text on first page
 +  * ** *LAST** = Insert text on last page
 +  * ** *EXTB** = Spool page extra first page (at the beginning of spool page)
 +  * ** *EXTE** = Spool page extra last page (at the end of spool page)
 +  * ** *2NDLS** = Insert text on second to last page
 +  * **(Blank)** = Leave blank to insert text into every spool page
 +  * **(Specific page)** = Specify the page number to insert text
  
 ===== Starting and Ending a SmartRouter™ Engine ===== ===== Starting and Ending a SmartRouter™ Engine =====
pub/preprocessor.1536980817.txt.gz · Last modified: 2022/06/25 17:02 (external edit)