LDLD gate, GET_NEXT_PROGRAM function
The GET_NEXT_PROGRAM function of the LDLD gate is used to perform an INQUIRE function for the next program in the alphabetic sequence of programs in the current browse session.
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
- LIBRARY
- Optional parameter
- is the name of the LIBRARY concatenation from which the program was loaded.
- LIBRARYDSN
- Optional parameter
- is the name of the data set within the LIBRARY concatenation from which the program was loaded.
- 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
- PROGRAM_USE_COUNT
- Optional Parameter
- is the cumulative use count of the program.
- PROGRAM_USER_COUNT
- Optional Parameter
- is the current number of users of the program.
- 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