Materialize Access Group Attributes (MATAGAT)


Op Code (Hex) Operand 1 Operand 2

03A2 Receiver Access group

Operand 1: Space pointer.

Operand 2: System pointer.

Bound program access
Built-in number for MATAGAT is 68.
MATAGAT (
         receiver       : address
         access_group   : address of system pointer
)

Description

The attributes of the access group and the identification of objects currently contained in the access group are materialized into the receiving object specified by operand 1.

Objects requested to be in the access group may:

The machine may also use the access group for enabling programs to run within a process. In this case, the Process Control Space (PCS) object is considered to exist partially in the access group, even if the access group membership was not requested when the PCS was created.

Only objects which exist wholly or partially in the access group will be materialized.

The materialization must be aligned on a 16-byte boundary. The format is:

Offset
Dec Hex
Field Name
Data Type and Length
0 0
Materialization size specification
Char(8)
0 0
Number of bytes provided for materialization
Bin(4)
4 4
Number of bytes available for materialization
Bin(4)
8 8
Object identification
Char(32)
8 8
Object type
Char(1)
9 9
Object subtype
Char(1)
10 A
Object name
Char(30)
40 28
Object creation options
Char(4)
40 28
Existence attributes
Bit 0



0 = Temporary
1 = Reserved


40 28
Space attribute
Bit 1



0 = Fixed-length
1 = Variable-length


40 28
Context
Bit 2



0 = Addressability not in context
1 = Addressability in context


40 28
Reserved (binary 0)
Bits 3-12
40 28
Initialize space
Bit 13
40 28
Reserved (binary 0)
Bits 14-31
44 2C
Reserved (binary 0)
Char(4)
48 30
Size of space
Bin(4)
52 34
Initial value of space
Char(1)
53 35
Performance class
Char(4)
53 35
Space alignment
Bit 0



0 = The space associated with the object is allocated to allow proper alignment of pointers at 16-byte alignments within the space. If no space is specified for the object, this value must be specified for the performance class.
1 = The space associated with the object is allocated to allow proper alignment of pointers at 16-byte alignments within the space as well as to allow proper alignment of input/output buffers at 512-byte alignments within the space.


53 35
Reserved (binary 0)
Bits 1-4
53 35
Default main storage pool
Bit 5



0 = Process main storage pool is used for this object.
1 = Machine default main storage pool is used for this object.


53 35
Reserved (binary 0)
Bit 6
53 35
Block transfer on implicit access state modification
Bit 7



0 = Transfer the minimum storage transfer size for this object.
1 = Transfer the machine default storage transfer size for this object.


53 35
Reserved (binary 0)
Bits 8-31
57 39
Reserved (binary 0)
Char(7)
64 40
Context
System pointer
80 50
Reserved (binary 0)
Char(16)
96 60
Access group size
UBin(4)
100 64
Available space in the access group
UBin(4)
104 68
Number of objects in the access group
UBin(4)
108 6C
Reserved (binary 0)
Char(4)
112 70
Access group object system pointer
[*] System pointer



(repeated for each object currently contained in the access group)


* *
--- End ---

The receiver space contains the access group's attributes, the current status of the access group, and a system pointer to each object assigned to the access group.

The number of bytes provided indicates the size of the materialization template. The number of bytes available is set by the instruction to indicate the actual number of bytes available to be returned. In no case does the instruction return more bytes of information than number of bytes provided.

The access group size represents the total amount of space that has been allocated to the access group.

The available space in the access group represents the amount of space that is available in the access group for additional objects.

The number of objects in the access group is a count of the number of objects that are currently contained in the access group. This value is also the number of times that the access group object system pointer below is repeated.

There is one access group object system pointer for each object currently assigned to the access group. The authorization field within each system pointer is not set.

Authorization Required

Lock Enforcement

Exceptions

06 Addressing

08 Argument/Parameter

0A Authorization

10 Damage Encountered

1A Lock State

1C Machine-Dependent

20 Machine Support

22 Object Access

24 Pointer Specification

2E Resource Control Limit

36 Space Management

38 Template Specification

44 Protection Violation