Addressing the contents of the TACLE

The TACLE is created by the terminal control program when the error occurs, and contains all the I/O error information provided by BSAM.

About this task

To address the contents of the TACLE, the user-written terminal error program should contain the COPY DFHTACLE and COPY DFHTCTLE statements, in that order. These define the complete DFHTCTLE DSECT. The symbolic names in this DSECT are used to address fields in both the TACLE and the real line entry associated with the error.

The TACLE consists of a 16-byte prefix (defined by COPY DFHTACLE) and a further 48-byte section, which is a modified copy of the DECB of the real line entry at the time the TACLE was created.

To address the TACLE, the user-written terminal error program should therefore contain the statements:
COPY DFHTACLE
COPY DFHTCTLE
 
L TCTLEAR,TEPCATCA        POINT TO TACLE
USING DFHTCTLE,TCTLEAR

Note that fields normally part of the real line entry DECB have offsets increased by 16 in the TACLE.

The following fields in the DECB copy in the TACLE do not represent data copies from the real line entry:
TCTLEDCB                (Offset 24 in TACLE,
                         8 in real TCTLE)
This field in the TACLE points to the real line entry; in the real line entry, it points to the BSAM DCB for the line group.
TCTLECSW                (Offsets 46, 48 in TACLE,
TCTLEALP                 30, 32 in real TCTLE)

These are used in the TACLE for SAM error information.

The following statements give direct addressability to the real line entry:
COPY DFHTCTLE
COPY DFHTCTTE
 
L      TCTLEAR,TEPCATCA        POINT TO TACLE
USING  DFHTCTLE,TCTLEAR
L      TCTTEAR,TCTLEPTE        POINT TO ERROR TCTTE
USING  DFHTCTTE,TCTTEAR
DROP   TCTLEAR
L      TCTLEAR,TCTTELEA        POINT TO TCTLE
USING  DFHTCTLE,TCTLEAR

After you have carried out the required functions and, optionally, altered the default actions scheduled by DFHTACP, the user-written DFHTEP must return control to DFHTACP by issuing the EXEC CICS RETURN command. DFHTACP then performs the actions specified in the TACLE and causes the error processing task to terminate.

The format of the TACLE DSECT is shown in Figure 1.
Figure 1. Format description of the TACLE DSECT (part 1)
               TERMINAL ABNORMAL CONDITION LINE ENTRY
 
The picture shows, in graphical format, the same information that is presented, in text format, in the second part of the figure.
Figure 2. Format description of the TACLE DSECT (part 2)
Displacement
 
Dec     Hex   Code     Bytes Label       Meaning
 
 
0       0              4     TCTLEPSA    Storage accounting
 
                             RESERVED
 
8       8              1     TCTLEPFL    Error flags
              81                         Message too long
 
              84                         TCT search error
              85                         Write not valid
              87                         Unsolicited input
              88                         Input event rejected
              8C                         Output event rejected
              8D                         Output length of zero
              8E                         No output area
              8F                         Output area exceeded
              94                         Unit check
              95                         Unit check
                                         (should not occur)
              96                         Unit exception
              97                         Unit exception
                                         (should not occur)
              99                         Undetermined I/O error
              9F                         Invalid destination
                                         (TCAM: no longer supported)
              .
              .      (All codes not listed are reserved and are
              .       not intended for use by DFHTEP)
              .
 
9       9             1     TCTLEPF2     Special indicator
              01                         dummy terminal
 
12      C             4     TCTLEPTE     Address of terminal
                                         entry for terminal
                                         in error
 
16      10            4     TCTLEECB     DECB/copy of line
                                         when error occurred
 
60      3C            4     TCTLEOA      For TCAM lines only.
                                         (No longer supported)


dfha353.html | Timestamp icon Last updated: Sunday, 4 June 2017