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.


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