Actions the DFHTRAP exit can take

The global trap exit can set a return-action flag byte to tell the trace domain what action is required on return from the exit.

Any combination of the following actions can be specified:
  • Do nothing.
  • Make a further trace entry using data in 24 bit storage or 31 bit storage (below the bar).
  • Make a further trace entry using data in 64 bit storage (above the bar).
  • Take a CICS® system dump. There are two possible actions here, take a system dump while holding the trace lock using system dump code TR1004, or take a system dump without holding the trace lock using system dump code TR1003. Holding the trace lock while the system dump is taken is more invasive to the system but might be required if debugging a concurrency problem.
  • Terminate CICS without a system dump after message DFHTR1000. (If you require a system dump, the system dump return-action flag must also be set.)
  • Disable the trap exit, so that it is not invoked again until you issue the command CSFE DEBUG,TRAP=ON.
All actions are honored on return to the trace domain.

The skeleton source for DFHTRAP shows how to make a further trace entry. When DFHTRAP detects a TS GET request, you can ask for a further trace entry to be made by entering the data required in the data fields supplied for this purpose, and by setting the appropriate bit in the return-action flag byte. If the required data is in 64 bit storage (above the bar), you must use the 64 bit versions of the data fields, and set the appropriate bit in the return-action flag byte to show that 64 bit data is used. The trace domain makes a trace entry with trace point ID TR 0103, incorporating the information supplied by the exit.

Trace entries created following a request by DFHTRAP are written to the currently active trace destination. This could be the internal trace table, the auxiliary trace data set, or the GTF trace data set.

The skeleton source for DFHTRAP also shows how to detect the trace entry made by the storage manager (SM) domain for a GETMAIN request for a particular subpool. The skeleton source shows you how to look at the data fields within a trace entry.



dfhs1lv.html | Timestamp icon Last updated: Monday, 5 June 2017