You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

LANSA for i provides an exit point program which can be registered to MSF for the purpose of tracing mail messages as they are processed by MSF. To register the LANSA Email tracing program perform these steps:
Step 1
Work with registration information for exit point. Enter this command:
WRKREGINF EXITPNT(QIBM_QZMFMSF_TRK_CHG)
Step 2
Choose the option to work with exit programs. If there is already a registered exit point program, it is important that you write down its details. You will need these details when and if you need to restore this exit point program.
Step 3
Register (add) the LANSA Email tracing program (DCXP8711). This program is installed in your LANSA program library (normally DCXPGMLIB). Use these parameters:
 

 
                          Add Exit Program (ADDEXITPGM)
 
 Type choices, press Enter.
 
 Exit point . . . . . . . . . > QIBM_QZMFMSF_TRK_CHG                  
 Exit point format  . . . . . > MSFF0100      Name                    
 Program number . . . . . . . > 1          1-2147483647, *LOW, *HIGH
 Program  . . . . . . . . . . > DCXP8711      Name                    
 Library  . . . . . . . . . . > DCXPGMLIB     Name, *CURLIB
 Text 'description' . . . . . LANSA Email tracing____________
 ________                                                              
                                                                      
                         Additional Parameters                        
                                                                      
 Replace existing entry . . .  > *NO           *YES, *NO 
 Create exit point  . . . . .    *NO           *YES, *NO  
                                                                More  
 F3=Exit    F4=Prompt    F5=Refresh    F12=Cancel         
 F13=How to use this display   F24=More keys
 

 |
 
continued …
 

 
                       Add Exit Program (ADDEXITPGM)            
                                                                      
 Type choices, press Enter.                                      
                                                                      
 Exit program data:                                               
   Coded character set ID . . .  *NONE         Number, *NONE, *JOB
   Length of data . . . . . . .  8             0-2048, *CALC    
   Program data . . . . . . . .  TCMM0100                        
 _____________________________________________________      
 _____________________________________________________      
 _____________________________________________________      
 _____________________________________________________      
 _____________________________________________________      
 _____________________________________________________      
 _____________________________________________________      
                                                            Bottom
 F3=Exit    F4=Prompt    F5=Refresh    F12=Cancel
 F13=How to use this display    F24=More keys
 

 |
 
Step 4
To start tracing you need to restart the MSF job. When you trace messages it is recommended that you start only one MSF job.
Step 5
To see the contents of the trace file, find the active MSF job and work with its spooled files. Note that the spooled file won't be opened until mail messages are written to the MSF.
Step 6
When you have finished tracing, remove DCXP8711 from the registered point (restore the previous exit point program if there was one).
Note:

  • DCXP8711 traces all mail messages written to MSF, not just the mail messages generated with LANSA.
  • Due to buffering, the last message(s) may not appear in the trace spooled file. You may need to send an extra dummy mail message to make visible the mail message you are looking for.

Tracing will have a significant impact on the performance of your mail processing jobs. You should disable tracing during normal operations.

  • No labels