LDLD gate, IDENTIFY_PROGRAM function

The IDENTIFY_PROGRAM function of the LDLD gate is used to locate the program instance which contains the specified address.

Input Parameters

ADDRESS
is a storage address.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • INSTANCE_NOT_FOUND
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
ACCESS
Optional Parameter
is the type of storage that the program resides in.
Values for the parameter are:
  • CICS
  • NONE
  • READ_ONLY
  • USER
CSECT_NAME
Optional Parameter
is the name of the CSECT within the module which contains the address. If no CSECT is available, the module name is returned.
ENTRY_POINT
Optional Parameter
is the address of the entry point of the program instance.
EXECUTION_KEY
Optional Parameter
is the execution key for the program.
Values for the parameter are:
  • CICS
  • USER
INSTANCE_USE_COUNT
Optional Parameter
is the current number of users of this instance.
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
OFFSET_INTO_CSECT
Optional Parameter
is the offset of the address within the CSECT. If no CSECT is available, the module name is returned.
PROGRAM_ATTRIBUTE
Optional Parameter
reflects the program attribute from the program definition, and is used by the program manager domain to recognize RELOAD programs.
Values for the parameter are:
  • RELOAD
  • RESIDENT
  • REUSABLE
  • TEST
  • TRANSIENT
PROGRAM_LENGTH
Optional Parameter
is the length of the program instance in bytes.
PROGRAM_NAME
Optional Parameter
is the name of the program whose attributes have been returned.
PROGRAM_TYPE
Optional Parameter
is the current program copy type.
Values for the parameter are:
  • PRIVATE
  • SHARED
  • TYPE_ANY
PROGRAM_USAGE
Optional Parameter
is the current usage definition.
Values for the parameter are:
  • APPLICATION
  • NUCLEUS
SPECIFIED_AMODE
Optional Parameter
is the addressing mode required by CICS for the program. A program that does not have the required residency mode is not loaded. If REQUIRED_AMODE was omitted when the program was defined, AMODE_NOT_SPECIFIED is returned.
Values for the parameter are:
  • AMODE_ANY
  • AMODE_NOT_SPECIFIED
  • 24
  • 31
  • 64
SPECIFIED_RMODE
Optional Parameter
is the residency mode required by CICS for the program. A program that does not have the required residency mode is not loaded. If REQUIRED_RMODE was omitted when the program was defined, RMODE_NOT_SPECIFIED is returned.
Values for the parameter are:
  • RMODE_ANY
  • RMODE_NOT_SPECIFIED
  • 24


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