DELETE

Purpose

Use the DELETE macro to release control of a load module.

After a task is finished with a load module, that module should be released from the task's control. Generally this will free the storage space that the load module occupies.

In effect, the DELETE macro cancels the effect of the LOAD macro. See LOAD. Use the DELETE macro to release your task's control over a load module and, if it is no longer needed, to remove it from virtual storage.

Parameters

EP

Specifies the name of the entry point contained in the load module.

This is the module you no longer wish to control.

You can write this parameter as any valid symbol.

EPLOC

Specifies the address in your program where you have stored the name of the load module's entry point.

This name may be up to 8 bytes long. If it is less than 8 bytes long, then it must be padded on the right with blanks.

You can write this parameter as an RX-type address, as register (0), or as register (2) through (12).

DE

Specifies the address of the NAME FIELD within the directory list entry associated with the entry point in question.

This is the same list entry you placed in the directory using the BLDL macro. See BLDL.

You can write this parameter as an RX-type address, as register (0), or as register (2) through (12).

RELATED

Specifies documentation data that you are using to relate this macro to a LOAD macro.

The value you assign to this parameter has nothing to do with the execution of the macro itself. It merely relates one macro (DELETE) to a macro that provides an opposite, though related, service (LOAD).

The format and contents of this parameter are at your discretion, and can be any valid coding value.

Usage

1. The DELETE macro frees the storage occupied by the load module only if it resides in private storage and if the module is no longer needed.
2. The task that issues the DELETE macro to release a given load module must be the same task that issued the LOAD macro.
3. Modules loaded with the ADDR parameter cannot be deleted.

Return Codes and ABEND Codes

When this macro completes processing, it passes to the caller a return code in register 15.