CDDELETE (Delete Loaded Phase) Macro
The macro deletes a phase previously loaded by a CDLOAD request.
Deletion means that the phase load count is decremented by one. If the load count is zero, the phase entry in the CDLOAD directory (the anchor table) is cleared and the GETVIS storage occupied by the phase is freed.
CDDELETE returns the actual load count of a phase in register 0.
If the maximum load count was exceeded by previous CDLOAD requests, a CDDELETE request is ignored and return code 4 is given.
Format
Requirements for the caller
- AMODE:
- 24 or 31
- RMODE:
- 24 or ANY
- ASC Mode:
- Primary
Parameters
- phasename | (1)
- For phasename, specify the name of the phase to be deleted. If
register notation is used, the register must contain the address of
an 8-byte field that holds the phase name as an alphanumeric character
string.
The address of phasename is regarded as a 24-bit or 31-bit address, depending on the AMODE (24 or 31) of the caller.
Return Codes in Register 15
- 0
- CDDELETE completed successfully.
- 4
- CDDELETE was given for a phase whose maximum load count was exceeded. The phase is not deleted.
- 20
- Phase not found. This return code is also given for phases that are loaded into the SVA, because SVA phases cannot be deleted by CDDELETE.