The routine resets an array so that its values become undefined. Its use is advisable before making format changes to an array if retention of the existing values is not required (e.g. before changing its data type with the ARY_STYPE routine); this will avoid the cost of converting the existing values.

CALL ARY_RESET( IARY, STATUS )

IARY = INTEGER (Given)

STATUS = INTEGER (Given and Returned)

• This routine may only be used to reset the state of a base array. If an array section is supplied, then it will return without action. No error will result.

• An array cannot be reset while it is mapped for access. This routine will fail if this is the case.