On-Demand Synchronization Support

The synchronization from AccuRev to Endevor is either triggered based on a configured time interval (for example all 30 minutes) or on demand when promoting files to an AccuRev gated stream whose parent stream is supporting a synchronization to Endevor.

In addition, the on demand synchronization process has some other advantages.

• Enterprise Developer users get immediate feedback when their changes are synchronized to Endevor.
• Enterprise Developer get visible reasons why a synchronization failed, for example
  • On demand synchronization failed because of overlapped elements \.\COBOL\MYFILEA.CBL.
  • On demand synchronization failed because the Endevor element MYFILEA is signed-out to MFIXXX.
• The user can perform typical actions to resolve synchronization failures, for example:
  • Demote change back to workspace.
  • Merge changes.
  • Re-promote.

The following is required for supporting on demand synchronizations:

• The Enterprise Sync projects definition requires a defined bi-directional synchronization rule from an AccuRev dynamic stream to Endevor like in the following sample:

  

• Based on the projects definition show in the sample above the stream structure which would support an on demand synchronization to the Endevor TEST and EMER stage could be defined like in the following sample:

  

  In this sample, the stream BANKDEMO_TEST is mapped to the Endevor stage TEST bi-directionally. It is required to define gated streams as children for all such streams to support on demand synchronizations.

Thus, promoting files to the gated stream BANKDEMO_TEST_GATE triggers the on demand synchronization to Endevor, and only if this synchronization is executed successfully, the files are promoted to the target stream BANKDEMO_TEST.

When changes are promoted to the gated stream, the AccuRev server invokes a server-side trigger which provides the on demand synchronization support. Therefore the following rules apply:

• Enterprise Sync pauses the synchronization process which is based on time intervals.
• Enterprise Sync synchronizes the current change to Endevor:
  • If the Endevor element is not signed-out, it is first signed-out to the user who has executed the promote function.
  • If the Endevor element is signed-out to another user and override sign-out is not specified on the promote dialog, then a synchronization error will occur.
• Enterprise Sync resumes typical syncing iterations

If AccuRev detects that a promote function will lead to an on demand synchronization, a specific promote dialog pops up in Enterprise Developer which supports Endevor specific parameters:

• The comment field is limited to 40 characters and entered text will be passed to the Endevor Comment field.
• The CCID is passed to Endevor when adding the related elements.
• If the promote user is authorized in Endevor he could set a flag overriding existing sign-outs.
• The user has the option to generate the element directly in Endevor.
• For each single element in the promote list the processor group could be changed, if required. Normally it is not required to select a processor group.

  Note also the following processing rules relevant for the on demand synchronization process:

• The promote dialog shown above has been optimized in Enterprise Developer, but is also available with limited validations in the AccuRev Windows GUI.
• If the Generate option is selected on the promote dialog, the Generate function is directly executed when adding files to Endevor. This means it is executed synchronously within the Micro Focus Access Server. If the Generate function fails, the element synchronization was still successful and Enterprise Sync will return a warning message. Enterprise Developer supports accessing the compiler listing directly on the mainframe, assuming that Endevor manages compiler listings.
• Specific Endevor processors which are creating and running in a TSO or ISPF environment are supported.
• Submitting a Generate function for Batch execution is not supported.
• If AccuRev change package support is activated, the promote dialog might look a little bit different (see AccuRev Change Package Support).
• If an on demand synchronization has been executed successfully, Enterprise Developer displays the storage decorator on the AccuRev workspace icon with a green background , otherwise with a red background and once a popup message is displayed containing the Endevor error message and the Endevor message text.