Change management sample exit

Data Replication for VSAM provides a CECCMVSM sample exit that contains additional logic to deal with conflicts. This version of the exit includes the “base” code from the CECCFVSM exit and includes additional logic and reason codes.

A replicated insert, update, or delete will invoke the conflict exit for change management processing if:

  • The apply service is configured to use STRICTVALIDATION=2.
  • The apply service is configured with a conflict exit in the CONFLICTEXIT parameter.
  • The target file is fixed and the source record length is not equal to the target file maximum record length or the target file is variable and the source record length is greater than the target file maximum record length.

The following list shows the additional reason codes:

106 – Force apply the operation when the source/target record lengths are different

Additional formatting logic is included when reason code 106 is returned:

  • For a fixed-length record insert operation when the target is larger than the source, the new space is filled with spaces.
  • For a variable-length insert operation when the target maximum length is larger than the source, the source record is written with its source length without invoking the exit because it is less than the target maximum length.
  • For a variable-length record insert operation when the source record length is greater than the target maximum length, the source record is truncated to the target maximum length.
  • For a fixed-length record update operation when the target is larger than the source, the additional data in the target record is appended to the end of the source record and the resulting value is used to update the target.
  • For a variable-length record update operation when the existing target record length is larger than the source, the additional data in the target record is appended to the end of the source record and the resulting value is used to update the target.
  • For a variable-length record update operation when the source record length is greater than the target maximum length, the source record is truncated to the target maximum length.
  • For a record delete operation the sample change management conflict exit makes no changes and simply forces the delete.

Supported scenarios

  • KSDS with target record length greater than the source record length: Both fixed and variable record formats.
  • KSDS with source record length greater than the target record length: Both fixed and variable record formats.
  • Standard ESDS replicated to extended addressing ESDS and the reverse: Neither DS should use addressing past 4GB during the transition. Data Replication for VSAM manages this condition without invoking the conflict exit by treating the source key value with the target key style and length (RBA or XRBA).
Note: The organization type that is passed to the conflict exit reflects the target organization. This rule might be important in the case where a standard ESDS is being replicated to an extended addressing ESDS. The key length that is passed in this scenario, however, is the source key length.