Running the Coexistence Batch

This task explains how to run the Coexistence batch. It can build a large scope of transferable data and accommodate the dynamic ENOVIAvpm configuration for the transfer of a resolved Product Structure. It requires a coexistence profile i.e. a correctly structured XML file which can be selected either by using the File Input option or by searching for an object in the ENOVIAvpm database.

Important: You cannot export CATIA V5 data created with Unified X-CAD Design Management. For more information, see Design with CATIA V5 User's Guide and Product Structure Editor User's Guide.
Note: You cannot use this batch with a shareable license.

This task shows you how to:

Retrieve Source Objects Using File Input

This task explains how to select a coexistence profile using the File Input option. This option builds a large scope of transferable data, accommodates the dynamic ENOVIAvpm configuration for the transfer of a resolved Product Structure and transfers data to 3DEXPERIENCE based on a choice of one of four file types.

  1. Follow the procedure described in Connecting to an ENOVIAvpm Data Source.
    For a Publish/Subscribe file to be generated correctly, you must:
    • use the Subscribe with action command in ENOVIAvpm.
    • use, as an example, the script file named V6_coexistence.sh located in the ENOVIAvpm runtime view. This is important because the file contains the pubsub file format that must be kept as is. The script file can be modified to take account of the network configuration. A part of the script file must be configured in order to remotely launch the CATBatchStarter script if required.
    • provide the file name in the Input file path field and make sure that the pubsub extension is specified because otherwise the batch interface will not recognize the file and will filter it out.
  2. Click the Input file type list and select one of the following options:

    • a psn file

      for filtering purposes (for more information, see "Editing the Product Structure" and other appropriate sections in the ENOVIAvpm User Guide)

      Note: The data will be transferred to 3DEXPERIENCE whether the psn file is stored in static or dynamic mode.

    • a Publish/Subscribe-generated file

      for event subscription purposes (for more information, see "Using Publish/Subscribe" in the ENOVIAvpm User Guide)

    • a template for a psn file

      to be used for the MultiPDM CDM/VPM Plug-in (for more information, see "Transferring Data to 3DEXPERIENCE" in the MultiPDM CDM/VPM Plug-in User Guide)

    • a vpmuuid_lst file

      containing a list of VPM UUIDs, intended to avoid problems you may have with large structures (for more information, see Using .vpmuuid_lst Files with CoexistenceBatch).

    Now that you have selected Input file type, the Input file path button is enabled.

  3. In the Input file path field, specify the location of your input file using the push button on the right.
    The Run button, in the bottom right-hand corner of the dialog box, is now enabled.
  4. If you are going to launch the batch immediately, provide the information regarding report generation in the Report directory and Report name fields.
  5. You can now either:
    • click Run to launch the batch immediately

      The input files are generated.

    • or click Save to
      • schedule the launch (specifying time, day or frequency) or
      • launch the batch remotely (from another machine, UNIX for example)
      then prepare an input xml CATBatchStarter file (see Running Batches in Remote Mode).

Retrieve Source Objects Using a Database Search

This task explains how to select a coexistence profile by searching for an object in the appropriate provider database.

  1. Run the batch.
    The CoexistenceBatch dialog box appears:

  2. Select the coexistence profile or scenario in the Coexistence Profile drop-down list at the top of the dialog box.

    This list contains two types of information:

    • XML profiles i.e. upward or downward
    • structural information i.e. upward scenarios such as "SMT to 3DExperience" or downward ones such as "3DEXPERIENCE to ENOVIAvpm").
  3. If you select a downward XML profile, the Advanced preferences... button, just to the right of the Expand all descendants check box, is activated, allowing you to export data in As Result or As Spec format.
    Notes:
    • Once you have selected a profile from the drop-down list, the Read input from parameter file... option (in the contextual menu displayed by right-clicking within the dialog box) is disabled. If you select structural information in the drop-down list, Upward Scenario(s) for example, you can then use that option. Conversely, if the Coexistence Profile list is grayed out preventing you from making any selection, a profile has already been selected. Only one XML profile can be selected.
    • Once the data has been loaded in the batch, a list of the data items is shown and the Objects to process option in the contextual menu is activated with two options: Select all and Remove.

Set the Expand Level

Note: If you use the File Input option, you cannot perform the steps described below.
You can find out how to set the expand level correctly.

  1. If you want to guarantee the integrity of transferred data, keep the Expand all descendants check box selected.
  2. If you want to do an expand to a limited level, make sure the Expand all descendants checkbox is not selected then enter the appropriate level in the Expand depth box. The expand depth level ranges from 0 through 25. Note that an expand level set to 0 implies that the expand will be applied to the root only.
  3. If you want to do an expand on the full range depth, select the Expand all descendants checkbox.
    Notes:
    • By default, when running the batch, the Split options are taken into account. For more information, see Performance.
    • By default, when an assembly node is sent to 3DEXPERIENCE using DBDI, the whole branch beneath the node is sent as well. The Expand depth option allows some refinement with sources implementing the Structure exposed assemblies. In ENOVIAvpm and ENOVIA VPM V5, it enables you to select expansion depth in the assembly branch and only applies to Structure exposed branches. When a blackbox document is encountered, the full recursive logic applies to the leaves involved.
    • Some general information on your PLM Batch execution and a report with the global results of the batch are generated in the report directory.

Use Multiprocessing

Note: If you use the File Input option, you cannot perform the steps described below.
The coexistence batch may require lengthy processing times. To alleviate this problem, it is possible to define a whole set of computers enabling a simultaneous database design import via different subprocesses.

Before you begin: Make sure that the same environment is defined for all processes. Both the code level and the settings must be the same.
  1. If you want multiprocessing to be performed on a single computer, keep the default i.e. hostname and set the number of processes to launch the import of the representation documents. If you want multiprocessing to be performed on more than one computer, you must specify the list of host names. For more information, see Performance.
  2. Configure communication ports and launch the CATBatSrvMonitorExe BB service on each remote computer (see Start the Server Monitor on the Remote Machine on Windows).
    Notes:
    • Multiprocessing serves no useful purpose when only a small number of representations need to be migrated, for example when the update mode is used.
    • When a large number of representations are involved, multiprocessing will significantly reduce processing times.
    • The path you specify for the report directory must be UNC (Universal Naming Convention) compliant. Remember that the import is run on several computers. (A drive specified by a letter is only local.)
    • Unlike the standard monoprocessing context, no information is duplicated from a representation migration report to the main report.