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.


dfhs3_LDLDrelease_program.html | Timestamp icon Last updated: Monday, 5 June 2017