LDLB gate, GET_NEXT_LIBRARY function
The GET_NEXT_LIBRARY function of the LDLB gate is used to get information about the next LIBRARY in the current browse session of LIBRARY resources currently installed in the CICS system. The browse is in ranking order, and in install-time order within ranking.
Input Parameters
- BROWSE_TOKEN
- is a token which identifies this browse of LIBRARY resources.
- LIBRARY_DSNAMES
- Optional parameter
- specifies buffer storage in which the list of all data sets within the LIBRARY is to be returned.
Output Parameters
- LIBRARY_NAME
- returns the name of the next LIBRARY in the browse of LIBRARY resources.
- CRITICAL
- Optional parameter
- specifies whether the LIBRARY is to be installed as critical (must be available at CICS startup) or non-critical (does not have to be available at CICS startup).
- Values for the parameter are:
- CRITICAL_YES
- CRITICAL_NO
- DSNAME01
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME02
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME03
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME04
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME05
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME06
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME07
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME08
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME09
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME10
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME11
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME12
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME13
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME14
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME15
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME16
- Optional Parameter
- returns the name of a data set in the LIBRARY concatenation. This name can be blank.
- ENABLE_STATUS
- Optional Parameter
- returns a value which indicates whether the LIBRARY is currently enabled (participates in the search order) or disabled (does not participate in the search order)
- Values for the parameter are:
- DISABLED
- ENABLED
- RANKING
- Optional Parameter
- returns the ranking value currently assigned to this LIBRARY, which is used to determine its position within the search order.
- SEARCH_POSITION
- Optional Parameter
- returns the actual current position of this LIBRARY in the overall LIBRARY search order (zero if the LIBRARY is disabled).
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- LIBRARY_NOT_FOUND
- NO_MORE_DATA_AVAILABLE
- BUFFER_TOO_SMALL
- 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.