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.


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