Figure 1. Sample file tailoring trace
header========= ISPF File Tailoring Trace =========== 2005.305 01:48:01 GMT ==========
ZISPFOS: ISPF FOR z/OS 01.08.00 ZOS390RL: z/OS 01.05.00
ISPFTTRC Command: ISPFTTRC
Options in Effect: SKELETON(*) SCREEN(0) RECORDS(SOURCE CNTL DATA)
READ(DETAIL) SERVICE(DETAIL) TBVARS(DETAIL)
ISPFICRX Version: ISPFICRX 05286-BASE z/18
ISPFICWC Version: ISPFICWC 05286-BASE z/18
ISPFICWD Version: ISPFICWD 05286-BASE z/18
ISPFICWE Version: ISPFICWE 05286-BASE z/18
ISPFICWL Version: ISPFICWL 05286-BASE z/18
ISPFICWT Version: ISPFICWT 05286-BASE z/18
ISPFICWX Version: ISPFICWX 05286-BASE z/18
ISPFIEND Version: ISPFIEND 05286-BASE z/18
ISPFIINT Version: ISPFIINT 05286-BASE z/18
ISPFILBS Version: ISPFILBS 05284-BASE z/18
ISPFITLR Version: ISPFITLR 05284-BASE z/18
ISPFITR0 Version: ISPFITR0 05297-BASE z/18
ISPFITRV Version: ISPFITRV 05286-BASE z/18
================================================================================
TLD# Type Skeleton Rec# IM IF DO TB Cd RC Data
---- ---- -------- ------ -- -- -- -- -- -- ----------------------------- … -->
The trace header shows the following information:
- Current date and time (GMT) when the trace was initialized
- ISPF level information as found in dialog variable ZISPFOS
- z/OS® level information
as found in dialog variable ZOS390RL
- ISPFTTRC command with the invocation parameters
- The options that are in effect for the current execution of the
file tailoring trace
- Module level information for each of the modules associated with
file tailoring and skeleton processing
The remainder of the trace is broken into a number of columns to
show each trace record. The columns are:
- TLD#
- The task or screen identifier from which the file tailoring is
being invoked.
- Type
- The trace entry type. The valid types are:
- CtlR
- Records are generated when record processing has completed and
the record was determined to be a control statement. The generation
of CtlR trace records is controlled by the ISPFTTRC RECORDS parameter.
- DatR
- Records are generated when record processing has completed and
the record was determined to be a data record. The generation of
DatR trace records is controlled by the ISPFTTRC RECORDS parameter.
- Err
- Records are generated when a file tailoring processing error
occurs and ISPF issues an error message. The generated records include
both the short and long error messages.
- FncI
- Records are generated when a built-in function has been identified
and is ready to be evaluated.
- FncR
- Records are generated when a built-in function has been evaluated.
- NoFT
- Records are generated after the point where the NOFT parameter
is specified on the FTINCL service call, or the point where the
NT option is specified on the )IM control statement. The generation
of NoFT trace records is controlled by the ISPFTTRC RECORDS parameter.
- Read
- Records are generated reading a skeleton into storage. The generation
of Read trace records is controlled by the ISPFTTRC READ parameter.
A summary trace does not show the skeleton source records.
- RexR
- Records are generated when REXX processing is complete and control
is being returned back to the file tailoring.
- Rexx
- Records are generated when a )REXX control statement is being
processed.
- Src
- Records are generated when a skeleton record is selected for
processing. The generation of Src trace records is controlled by
the ISPFTTRC RECORDS parameter.
- Svc
- Records are generated for calls to the ISPF file tailoring services
and show all the call parameters. This is limited to the FTOPEN,
FTINCL, FTCLOSE, and FTERASE services. The generation of Svc trace
records is controlled by the ISPFTTRC SERVICE parameter.
- SvcR
- Records are generated returning from the ISPF file tailoring
services. The trace includes the return code from the service. The
FTCLOSE return trace entry includes an additional record showing
the number of records written to the file tailoring output data
set.
- Var
- Records that are generated to show the ISPF variables and their
values being passed to the file tailoring REXX command.
- VarR
- Records that are generated to show the ISPF variables and their
values being passed back from the file tailoring REXX command.
- Skeleton
- The ISPF skeleton name associated with the trace record.
- Record
- Display the record number associated with the trace entry type.
For Read, Src,
and CtlR the input record number from the
skeleton member is displayed. (For control statements that are continued
over more than one line this is always the record number associated
with the first line of the control statement.) For DatR and NoFT,
the output record number is displayed. This field is blank for all
other record types.
- IM
- The current imbed level. The skeleton name specified on the FTINCL
service is always level 1.
- IF
- The current IF or SEL level. This field is blank if no )IF or
)SEL statement is being processed.
- DO
- The current DO level. This field is blank if no )DO structure
is being processed.
- TB
- The current Table level. This field is blank if no )DOT structure
is being processed.
- Cd
- The Condition value returned for the following skeleton control
statements:
- RC
- The Return Code, shown only for SvcR, DatR, and CtlR trace entries.
- Data
- Trace data for the particular trace entry. The trace data extends
the full width of the output file and will wrap if required.