LDLD gate, RELEASE_PROGRAM function
The RELEASE_PROGRAM function of the LDLD gate is used to inform the loader domain that use of a copy of the named program is no longer required. The use count of the specified program instance is decremented; if the use count reaches zero, and the program is eligible to be removed from memory, it is removed from memory.
Input Parameters
- APPL_CONTEXT_TOKEN
- Optional parameter
- A token representing the application context of PLATFORM_ID, APPLICATION_ID, APPL_MAJOR_VER, APPL_MINOR_VER, and APPL_MICRO_VER.
- APPLICATION_ID
- Optional parameter
- The 64-character name of the application associated with the task.
- APPL_MAJOR_VER
- Optional parameter
- The fullword binary value that is the major version of the application associated with the task.
- APPL_MINOR_VER
- Optional parameter
- The fullword binary value that is the minor version of the application associated with the task.
- APPL_MICRO_VER
- Optional parameter
- The fullword binary value that is the micro version of the application associated with the task.
- ENTRY_POINT
- specifies the address of the entry point of the module.
- PLATFORM_ID
- Optional parameter
- The 64-character name of the platform associated with the task.
- PROGRAM_NAME
- specifies the name of the required program.
- PROGRAM_TOKEN
- is a valid program-identifying token as returned by a previous DEFINE or ACQUIRE request for the same program name.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- PROGRAM_NOT_DEFINED
- PROGRAM_NOT_IN_USE
- The following values are returned when RESPONSE is INVALID:
- INVALID_ENTRY_POINT
- INVALID_PROGRAM_TOKEN
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- LOAD_POINT
- Optional Parameter
- is the address of the load point of the program instance.
- LOCATION
- Optional Parameter
- determines where the program instance for which the LOAD_POINT and ENTRY_POINT have been returned resides.
- Values for the parameter are:
- CDSA
- ECDSA
- ELPA
- ERDSA
- ESDSA
- LPA
- NONE
- RDSA
- SDSA
- NEW_APPL_CONTEXT_TOKEN
- Optional parameter
- A token to be used on subsequent calls, representing the application context of PLATFORM_ID, APPLICATION_ID, APPL_MAJOR_VER, APPL_MINOR_VER, and APPL_MICRO_VER.
- PROGRAM_LENGTH
- Optional Parameter
- is the length of the program instance in bytes.