10.1.1 Initialize_Trace Procedure

The Initialize_Trace procedure allocates and initializes a Trace object.

Calling syntax:

call Initialize (Trace, Index, Length_PE, status)

Input variables:

Trace The Trace object to be initialized.

Index The indirect index values for the specified communication pattern.

Length_PE Length of the destination vector on this PE. This corresponds to the Many axis of a Many-to-One relationship.

Output variables:

Trace The Trace object has been allocated and initialized.

status If present, the status variable is set to either 'Memory Error' or 'Success' depending on program execution. If not present, the procedure aborts if unsuccessful when the DEBUG_LEVEL is set high enough.

Internal variables:

allocate_status Allocation Status.

The Initialize_Trace code listing contains additional documentation.

Michael L. Hall

	`Trace`		The Trace object to be initialized.
	`Index`		The indirect index values for the specified communication pattern.
	`Length_PE`		Length of the destination vector on this PE. This corresponds to the Many axis of a Many-to-One relationship.

	`Trace`		The Trace object has been allocated and initialized.
	`status`		If present, the status variable is set to either `'Memory Error'` or `'Success'` depending on program execution. If not present, the procedure aborts if unsuccessful when the `DEBUG_LEVEL` is set high enough.