ABM5   

Explanation

A DFHTS TYPE=PURGE request has been issued with an invalid REQID. This incorrect request was issued by basic mapping support (BMS).

DFHTPR cannot find the terminal identifier for the current terminal in the terminal list in the message control record (MCR).

System action

The transaction is abnormally terminated with a CICS transaction dump.

User response

Check the trace table and find the preceding PUT/PUTQ TS requests. Check whether the identifier for the PUT/PUTQ is the same as that for the PURGE. If it is not, find out how they differ. Check to see if the OSPWA has been corrupted.

This error is very unlikely, as the label indicates (TPRSNH - "Should Not Happen"). DFHTPS has scanned the MCR to identify the terminals to which this message is directed, and has created an AID to initiate CSPG (DFHTPR) at each of them. However, when DFHTPR retrieves the MCR, it cannot find the current terminal identifier in the list of terminals. Presumably the MCR has been corrupted between creation of the AID and dispatching of CSPG at the terminal. Check back through the trace table to find the instance of DFHTPS that built the AID for this terminal (transaction CSPS); it will have issued a TC LOCATE request to verify that the terminal identifier is valid, and this identifier can be seen in the trace entry.

Problem determination

The TS identifier is built in TCATSDI before the TS purge is issued, although this has probably been overwritten before the dump is taken. The trace table entry for the DFHTS TYPE=PURGE contains the TS identifier in the last 8 bytes.

The OSPWA is addressed by register 9.

OPSTSID temporary storage identifier (8 bytes).

Register 8 points to the MCR.

Register 5 points to the current entry.

Register 0 points to the end of table.

Register 9 points to the TCTTE.

The terminal list starts at MCRIDLST and the terminal identifier is at the start of the terminal entry. Each terminal entry is X'15' bytes long.

Analysis: DFHMCP uses the temporary storage identifier in OSPTSID.

Cannot find the terminal identifier for this terminal in the terminal list in the MCR.

Register    Label     Description

R9=@(OSPWA) MCPCKPGS  Code builds the temporary
                      storage code in TCATSDI
                      and issues DFHTS
                      TYPE=PURGE macro,
                      specifying IDERROR exit
                      of MCPTSIDE, where the
                      abend is raised.

R8=@(MCR)   TPRCKID   Code scans terminal list
                      for a terminal entry that
                      has the id of the current
                      terminal, and if it
                      cannot be found, links to
                      TPRSNH to raise the abend.

Module

DFHMCP, DFHTPR


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