z/OS ISPF User's Guide Vol II
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Function trace entries

z/OS ISPF User's Guide Vol II
SC19-3628-00

A pair of function trace entries, a BEGIN entry and an END entry, is generated during a function trace for each traced dialog service that is called. A service can be called from a user dialog that is currently processing, or from a Dialog Test action for the user. The summary portion of each of these entries shows the name of the dialog service, whether it is the beginning or the end of its processing, and whether it was called indirectly from a Dialog Test panel. If the word TEST does not appear, the user dialog called the service directly. For END entries, the service return code is shown on a second line.

The detailed section of the log entries contains an image of the service call and the parameters used to call that service, using two lines if necessary. For example:
DISPLAY .. BEGIN ... TEST - DISPLAY PANEL(XYZ)
⋮
DISPLAY .. END.. ... TEST - DISPLAY PANEL(XYZ)
  ..RETURN CODE (0)

There can be many log entries between the begin and end entries. For example, any active variable traces can cause log entries during a SELECT trace.

Note these aspects about the service call image:
  • The image is truncated after the second line.
  • ISPEXEC calls are shown as typed in the dialog.
  • ISPLINK and ISPLNK calls (except for the ISREDIT service) are displayed with their parameter values separated by commas. Name-lists are shown as typed in the dialog, in either string or structure format. Structure format includes the count, element length, and list of names. For a variable services parameter whose context is defined by the name-list parameter on the service call, the first four bytes of the parameter value are displayed in hexadecimal format (X'nnnnnnnn').
  • Dialog Test calls are shown using the command call format without the ISPEXEC prefix.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014