LDLB gate, ADD_REPLACE_LIBRARY function

The ADD_REPLACE_LIBRARY function of the LDLB gate is used to install a new LIBRARY resource into the CICS system, or to replace an installed disabled LIBRARY resource of the same name.

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.
CRITICAL
Optional parameter
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
The name of a data set in the LIBRARY concatenation.
DSNAME02
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME03
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME04
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME05
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME06
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME07
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME08
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME09
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME10
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME11
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME12
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME13
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME14
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME15
Optional Parameter
The name of a data set in the LIBRARY concatenation.
DSNAME16
Optional Parameter
The name of a data set in the LIBRARY concatenation.
ENABLE_STATUS
Optional Parameter
Whether the LIBRARY is to be installed as enabled (participates in the search order) or disabled (does not participate in the search order).
Values for the parameter are:
  • DISABLED
  • ENABLED
LIBRARY_NAME
The name of the LIBRARY to be installed or replaced.
PLATFORM_ID
Optional parameter
The 64-character name of the platform.
RANKING
Optional Parameter
The ranking value to be assigned to this LIBRARY, which is used to determine its position within the search order.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • CATALOG_WRITE_FAILED
  • CATALOG_DELETE_FAILED
  • LIBRARY_LOCK_ERROR
  • LIBRARY_NAME_ERROR
  • LIBRARY_CHAIN_ERROR
  • LOOP
  • DSNAME_ARRAY_ERROR
The following values are returned when RESPONSE is EXCEPTION:
  • INSUFFICIENT_STORAGE
  • ALLOCATE_FAILED_ENABLE
  • CONCATENATE_FAILED_ENABLE
  • OPEN_FAILED_ENABLE
  • NOT_DISABLED
  • SECURITY_FAILURE
  • USERID_NOTAUTHED
  • MVS_ABEND_CONDITION
  • SERIOUS MVS ABEND
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
  • INVALID_PARAMETERS
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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