Skip to content

CMNBILOD - Verify that an ILOD record does not already exist

Utility program CMNBILOD is used to verify that an ILOD record does not already exist for a component.

When a SRC component build is requested, all existing 'ILOD' (i.e. SRC-LOD relationship) records associated with that SRC are deleted from the package master metadata. When program CMNBILOD executes within the staging job it checks that there are still no ILOD records. If none are found, the build job is allowed to proceed and the component can be activated in the expected manner.

If program CMNBILOD finds that ILOD records do exist, however, it will stop the stage job completing with a message like

Out of sync situation: component tied to DB2TST1.DBR

This is primarily to prevent any 'orphan' ILOD records being allowed to slip through unnoticed and to potentially allow unwanted components to make it into baseline or production libraries.

This means that any prior build job submitted for a SRC component must either be completed, or cancelled prior to execution, before a subsequent build job is submitted.


See the description below for return code 8, this is signifying that the load/target component is already linked to another component. Build jobs must complete before the next build job is started for the same component.
If you have two build jobs running at the same time, the second build job will complete with a return code of 8, with an out of synch situation encountered. To resolve the return code 8, start the submit process again for the component.

Program Execution Parameters

The PARM= statement is required for program CMNBILOD. This table describes execution parameters that are used with program CMNBILOD:

Parameter Use Description
SUBSYS= Optional Specifies ChangeMan subsystem, default is blank.
USER= Required TSO ID to use to connect.


DD Statements

This table describes DD statements for CMNBILOD.

DDNAME I/O Purpose
SYSIN Input Required. Component information PKN=package name, LNM=component type, LTP=component type.
SYSPRINT Output Program messages.


Return Codes and Error Messages

This table describes program return codes for CMNBILOD.

Return Code Description
00 Successful execution.
04 An application error has ocurred.
06 Started task inactive or a connection error.
08 Load/target component already linked to another component.