LDLB gate, INQUIRE_LIBRARY function
The INQUIRE_LIBRARY function of the LDLB gate is used to get information about the specified LIBRARY.
Input Parameters
- APPLICATION_ID
- Optional parameter
- The 64-character name of the application.
- APPL_MAJOR_VER
- Optional parameter
- The fullword binary value that is the major version of the application.
- APPL_MICRO_VER
- Optional parameter
- The fullword binary value that is the micro version of the application.
- APPL_MINOR_VER
- Optional parameter
- The fullword binary value that is the minor version of the application.
- LIBRARY_NAME
- The name of the required LIBRARY.
- LIBRARY_DSNAMES
- Optional parameter
- Buffer storage in which the list of all data sets in the LIBRARY is to be returned.
- PLATFORM_ID
- Optional parameter
- The 64-character name of the platform.
Output Parameters
- CRITICAL
- Optional parameter
- Whether the LIBRARY is defined 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
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME02
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME03
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME04
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME05
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME06
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME07
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME08
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME09
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME10
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME11
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME12
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME13
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME14
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME15
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- DSNAME16
- Optional Parameter
- The name of a data set in the LIBRARY concatenation. This name can be blank.
- ENABLE_STATUS
- Optional Parameter
- 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
- The ranking value currently assigned to this LIBRARY, which is used to determine its position within the search order.
- RESOURCE_SIGNATURE
- Optional Parameter
- A buffer to receive the LIBRARY resource signature.
- SEARCH_POSITION
- Optional Parameter
- 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
- BUFFER_TOO_SMALL
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.