ABMA

Explanation

The user has supplied a terminal I/O area (TIOA) with an invalid data length that was either equal to zero or greater than the storage accounting length minus 12.

Alternatively, the length field of a header or trailer area provided by the application program is invalid (that is, not positive).

System action

The transaction is abnormally terminated with a CICS transaction dump.

User response

Correct the program that supplied the erroneous data length.

Check the TIOA. If either of the conditions described is present, check the application program. For programs using command-level interface, the TIOA is obtained by CICS using the length of the data item passed in the FROM option on an EXEC CICS SEND MAP or EXEC CICS SEND TEXT command, or in the TRAILER or HEADER option on an EXEC CICS SEND TEXT or an EXEC CICS SEND PAGE command. Check the data item for zero length.

Header and trailer records have a special format described in the CICS Application development reference. An ABMA abend occurs if the first halfword (the length) is not positive. Check the remainder of the header/trailer record for validity when the length is checked.

Problem determination

The output services work area (OSPWA) is in user storage and will be printed in a transaction dump. It is addressed by register 2 at the time of the abend. Relevant fields are:

  • OSPTR7

  • OSPHDRA

  • OSPTRLA

Register 4 or OSPTIOA points to the TIOA. In the TIOA, the following fields are relevant:

  • TIOATDL

  • TIOASAL

Analysis:



Register    Label      Description


R4=@TIOA    PBCKTDL    TIOATDL is zero or greater
                       than TIOASAL-12.

R2=@OSPWA   PBD20080   R0 (= first halfword of
R0=length              trailer)  is zero.
of trailer             R8=OSPTRLA.
R8=@trailer            OSPTR7 has X'20' bit set.

R2=@OSPWA   PBDTXHDR   R0 (= first halfword of
R8=@header             header) is zero.
R0=length              R8=OSPHDRA.
 of header.            OSPTR7 has X'40' bit set.

Module

DFHPBP, DFHMCP

Applicable releases in Version 6

  • beta
  • 6.3
  • 6.2
  • 6.1