10 3 2 LANSA Email Tracing

Installing LANSA on IBM i

10.3.2 LANSA Email Tracing

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.