Destroy Activation Group-Based Heap Space (DESHS)

Instruction Syntax

Built-in number for DESHS is 113.
DESHS (
       heap_identifier   : address of signed binary(4) OR
                           address of unsigned binary(4)
)

Description:

This instruction destroys and removes from the current activation group the heap space specified by the heap identifier in operand 1. Subsequent use of this heap identifier within the activation group will result in an invalid heap identifier (hex 4501) exception. The heap identifier was returned on the Create Activation Group-Based Heap Space (CRTHS) instruction. An attempt to destroy the default heap space (heap identifier value of 0) will result in an invalid request (hex 4502) exception.

Space pointer references to heap space allocations from a destroyed heap space will cause unpredictable results.

All heap spaces are implicitly destroyed when the activation group in which they were created is destroyed.

Operand 1 is not modified by the instruction.

Authorization Required

• None

Lock Enforcement

• None

Exceptions

• 06 Addressing
  • 0601 Space Addressing Violation
  • 0602 Boundary Alignment
  • 0603 Range
• 08 Argument/Parameter
  • 0801 Parameter Reference Violation
• 10 Damage Encountered
  • 1004 System Object Damage State
  • 1005 Authority Verification Terminated Due to Damaged Object
  • 1044 Partial System Object Damage
• 1C Machine-Dependent
  • 1C03 Machine Storage Limit Exceeded
• 20 Machine Support
  • 2002 Machine Check
  • 2003 Function Check
• 24 Pointer Specification
  • 2401 Pointer Does Not Exist
  • 2402 Pointer Type Invalid
• 44 Protection Violation
  • 4401 Object Domain or Hardware Storage Protection Violation
• 45 Heap Space
  • 4501 Invalid Heap Identifier
  • 4502 Invalid Request
  • 4505 Heap Space Destroyed
  • 4506 Invalid Heap Space Condition