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.