LDLB gate, GET_NEXT_APPLICATION function
The GET_NEXT_APPLICATION function of the LDLB gate is used to get information about the next application. The browse session is managed by the CURRENT_TOKEN and NEW_TOKEN parameters.
Input Parameters
- APPLICATION_ID
- Optional parameter
- Specifies buffer storage in which the application name is to be returned.
- CURRENT_TOKEN
- A token which identifies the current position of the browse through the applications. This value should be zero for a new browse and replaced by the returned NEW_TOKEN parameter value on subsequent requests.
- PLATFORM_ID
- Optional parameter
- Specifies buffer storage in which the platform name is to be returned.
Output Parameters
- APPL_MAJOR_VER
- Optional parameter
- Specifies the major version number for the application.
- APPL_MICRO_VER
- Optional parameter
- Specifies the micro version number for the application.
- APPL_MINOR_VER
- Optional parameter
- Specifies the minor version number for the application.
- APPL_TOKEN
- Optional parameter
- Specifies the application token.
- NEW_TOKEN
- A token which identifies the next position of the browse through the applications. This value should be used as the value for the CURRENT_TOKEN input parameter on subsequent requests.
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- IAE_LOCK_ERROR
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- NO_MORE_DATA_AVAILABLE
- The following values are returned when RESPONSE is INVALID:
- INVALID_BROWSE_TOKEN
- INVALID_FORMAT
- INVALID_FUNCTION
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.