Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

LANSA for i 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:

Panel

...

                                        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____________
 ________                                                              

...

 |
 
continued …
 

...

                                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 …

Panel

                                        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


Note

Notes:

  • 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.
Info
Tracing will have a significant impact on the performance of your mail processing jobs. You should disable tracing during normal operations.