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/27 09:31] – [Conditions] kkramerpub:preprocessor [2022/06/25 17:02] (current) – external edit 127.0.0.1
Line 75: 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 105: 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 237: 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 410: 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.1538065875.txt.gz · Last modified: 2022/06/25 17:02 (external edit)