Materialize Activation Export (MATACTEX)

Built-in number for MATACTEX2 is 660.
MATACTEX2 (
          activation_mark   : unsigned binary(8)
          ident_type        : unsigned binary(4)
          number            : unsigned binary(4)
          name              : address
          pointer           : address of procedure pointer(16) OR
                              address of space pointer(16)
          export_type       : address of unsigned binary(4)
)
 
OR
 
Built-in number for MATACTEX is 460.
MATACTEX (
          activation_mark   : unsigned binary(4)
          ident_type        : unsigned binary(4)
          number            : unsigned binary(4)
          name              : address
          pointer           : address of procedure pointer(16) OR
                              address of space pointer(16)
          export_type       : address of unsigned binary(4)
)

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

This instruction returns the address of an export identified by name or export identifier from a specified program activation. The type of the export item, either data or procedure, is also returned. If the item is not found, an indicator is returned via the export type operand; no exception is signaled in this case.

Operands are as follows,

• activation mark (input) specifies the activation mark of a bound service program. If the specified program activation does not exist then a program activation not found  (hex 2C16) exception is signaled. If the activation mark does not correspond to a bound service program then an invalid operation for program  (hex 2C15) exception is signaled.

• ident type (input) specifies how the export is identified.

  0 =	reserved
  1 =	by export ID. The item is identified by export identifier (or export ID.) The number operand specifies the export ID of the item. An export ID is the ordinal position, starting from 1, of the item in the bound service program's export list.
  2 =	by name. The item is identified by name. The name operand provides the symbolic name of the item. The length of the name is specified by the number operand.
  >2 =	reserved

  Use of a reserved value causes a scalar value invalid  (hex 3203) exception to be signaled.

• number (input) specifies either the export ID or length of the character string which supplies the name.

• name (input) specifies the character string name. This operand is ignored if ident type is not 2, but must always be specified.

• pointer (address in, value out) specifies either a procedure pointer or space pointer to the exported item. If the requested export does not exist, 16 bytes of storage at the location indicated by this operand are set to binary 0.

• export type (address in, value out) identifies the type of export,

  0 = item not found

  1 = procedure export

  2 = data export

  3 = inaccessible data export

  If the item was not found the pointer is also set to binary 0.

The thread must have execute authority to the program specified by the activation mark in order to obtain the address of an exported item. In addition, a user state program may only materialize data exports from activations within the same activation group. An attempt to materialize a data export from another activation group will result in a value of 3 for export type and binary 0 being returned in the pointer operand. A system state program may materialize data exports from any activation.

Authorization Required

• Execute

  • Program specified by activation mark.

Lock Enforcement

• None

Exceptions

06 Addressing

• 0601 Space Addressing Violation
• 0602 Boundary Alignment

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

22 Object Access

• 2202 Object Destroyed
• 220B Object Not Available

24 Pointer Specification

• 2401 Pointer Does Not Exist
• 2402 Pointer Type Invalid

2C Program Execution

• 2C15 Invalid Operation for Program
• 2C16 Program Activation Not Found

2E Resource Control Limit

• 2E01 User Profile Storage Limit Exceeded

32 Scalar Specification

• 3203 Scalar Value Invalid

36 Space Management

• 3601 Space Extension/Truncation

44 Protection Violation

• 4401 Object Domain or Hardware Storage Protection Violation
• 4402 Literal Values Cannot Be Changed