Modify Independent Index (MODINX)

Instruction Syntax

Op Code (Hex) Operand 1 Operand 2
0452 Independent index Modification option
Operand 1: System pointer.

Operand 2: Character(4) scalar.

Bound Program Access 
Built-in number for MODINX is 39.
MODINX (
        independent_index     : address of system pointer
        modification_option   : address
)

Warning

The following information is subject to change from release to release. Use it with caution and be prepared to adjust for changes with each new release.

Description:

Modify the selected attributes of the independent index specified by operand 1 to have the values specified in operand 2. The modification options specified in operand 2 have the following format:

Offset  
Dec Hex Field Name Data Type and Length
0 0 Modification selection Char(1)
0 0
  • Reserved (binary 0)
  • Bit 0
0
0
  • Immediate update
    0 =
    Do not change immediate update attribute
    1 =
    Change immediate update attribute
  • Bit 1
0
0
  • Index coherency tracking
    0 =
    Do not change index coherency tracking attribute
    1 =
    Change index coherency tracking attribute
  • Bit 2
0
0
  • Reset index
    0 =
    Do not reset the index
    1 =
    Reset the index
  • Bit 3
0 0
  • Reserved (binary 0)
  • Bits 4-7
1 1 New attribute value Char(1)
1 1
  • Reserved (binary 0)
  • Bit 0
1
1
  • Immediate update
    0 =
    No immediate update
    1 =
    Immediate update
  • Bit 1
1
1
  • Index coherency tracking
    0 =
    Do not track index coherency
    1 =
    Track index coherency
  • Bit 2
1 1
  • Reserved (binary 0)
  • Bits 3-7
2 2 Reserved (binary 0) Char(2)
4
4
--- End ---
 

If the modification selection immediate update is binary 0, then the immediate update attribute is not changed. If the modification selection immediate update bit is binary 1, the immediate update attribute is changed to the new attribute value immediate update value.

If the immediate update attribute of the index was previously set to no immediate update, and it is being modified to immediate update, then the index is ensured before the attribute is modified.

If the modification selection index coherency tracking is binary 0, then the index coherency tracking attribute is not changed. If the modification selection index coherency tracking bit is binary 1, the index coherency tracking attribute is changed to the new attribute value index coherency tracking value.

If the modification selection reset index is binary 0, then the index is not reset. If the modification selection reset index is binary 1, then the index will be reset to its state at create time. In addition, all entries will be removed and any additional allocated space will be freed.

This operation will cause an object domain or hardware storage protection violation (hex 4401) exception if attempted from user state on an index object with the restrict index operations from user state at all security levels attribute set to binary 1.

Authorization Required

  • Object management
    • Operand 1
  • Execute
    • Contexts referenced for address resolution

Lock Enforcement

  • Modify
    • Operand 1
  • Materialization
    • Contexts referenced for address resolution

Exceptions

  • 06 Addressing
    • 0601 Space Addressing Violation
    • 0602 Boundary Alignment
    • 0603 Range
  • 08 Argument/Parameter
    • 0801 Parameter Reference Violation
  • 0A Authorization
    • 0A01 Unauthorized for Operation
  • 10 Damage Encountered
    • 1004 System Object Damage State
    • 1005 Authority Verification Terminated Due to Damaged Object
    • 1044 Partial System Object Damage
  • 1A Lock State
    • 1A01 Invalid Lock State
  • 1C Machine-Dependent
    • 1C03 Machine Storage Limit Exceeded
    • 1C0E IASP Resources Exceeded
    • 1C11 Independent ASP Varied Off
  • 20 Machine Support
    • 2002 Machine Check
    • 2003 Function Check
  • 22 Object Access
    • 2201 Object Not Found
    • 2202 Object Destroyed
    • 2203 Object Suspended
    • 2207 Authority Verification Terminated Due to Destroyed Object
    • 2208 Object Compressed
    • 220B Object Not Available
  • 24 Pointer Specification
    • 2401 Pointer Does Not Exist
    • 2402 Pointer Type Invalid
    • 2403 Pointer Addressing Invalid Object Type
  • 2E Resource Control Limit
    • 2E01 User Profile Storage Limit Exceeded
  • 32 Scalar Specification
    • 3201 Scalar Type Invalid
    • 3202 Scalar Attributes Invalid
  • 36 Space Management
    • 3601 Space Extension/Truncation
  • 44 Protection Violation
    • 4401 Object Domain or Hardware Storage Protection Violation