LDLD gate, GET_NEXT_INSTANCE function

The GET_NEXT_INSTANCE function of the LDLD gate is used to browse the current program instances in ascending load point address sequence.

Input Parameters

BROWSE_TOKEN
is a valid browse token as returned by the preceding START_BROWSE request.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • END_LIST
The following values are returned when RESPONSE is INVALID:
  • INVALID_BROWSE_TOKEN
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
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
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_LDLDget_next_instance.html | Timestamp icon Last updated: Monday, 5 June 2017