Checking the Design Consistency by Running a Batch in CATUTIL

To check the fastener's design consistency, you can run a batch by using the CATUTIL command. The batch requires an xml file that contains parameters defining inputs and outputs. The result of the check is generated in the fastener rules report.

This task shows you how to:

Before you begin: To open the Batch Monitor, run the CATUTIL command by doing either of the following:

  • From an interactive session, from the Tools section of the Action Bar, click Utility...

  • From a MS-DOS window, type catstart -env LocalEnv -run CATUTIL. The Batch Monitor dialog box is displayed, listing all available batches.

See Also
Fastener Check Rules

Create a Parameter File

You can first create a parameter file.

  1. In the Utilities tab of the Batch Monitor dialog box, right-click FastenerRulesCheck and select New parameter file.

    The Fastener Rules Check dialog box opens.

  2. Click Object Search to choose the products on which the rules should be processed.

    The 3DEXPERIENCE Platform Object Search dialog box is displayed.

  3. For example, fill in the Part Number box.
  4. Click Apply to import the results into the FastenerRuleCheck dialog box and click OK to close the 3DEXPERIENCE Platform Object Search dialog box.
  5. Remove the products you do not need by clicking .
  6. Select the Report directory by clicking the Browse icon.

    You can customize the report by using these options:

    • Long report: adds projection results and specific process category data for each fastener
    • Include comments: specifies that the report starts with the commented header block showing keywords description.
    • Ordered zones sorting: specifies how the joined parts specifications are ordered.
    • Translate coded values: defines attribute values belonging to a predefined list of codes are translated according to the NLS set-up. For example if the value of the fastener finish attribute is "B", using this option will display the translation "Class B" in the report.
    • Unit: either be millimeter or inch.
    • Real numbers precision: number of decimal digits of all the real numbers written in the neutral file and of the discretization values displayed in the dialog box above. This number is comprised between 0 and 10.
    • Scientific notation: used in the report (power of 10).
  7. Optional: Select each and choose to activate or deactivate it.
    Rules are all deactivated by default. For more information, see Rules.
  8. Select the Report directory in which the rule report will be executed by clicking the Browse icon.
  9. Optional: Modify the Report name and the Suffix for the object report.
  10. Click Save to save the parameters in the xml file.
  11. In the Save As dialog box, select the xml file and click Save.

    The xml parameter file is automatically generated in the selected directory.

    Tip: Provided you have already saved the rules parameters in an xml file, you can right-click anywhere in the Fastener Rules Check dialog box and select Read input from parameter file...to retrieve these parameters.

Run the Batch

You can run the batch from two different dialog boxes.

From the FastenerRulesCheck Dialog Box

You can run the batch from the FastenerRuleCheck dialog box.

Click Run to run the batch process.
The xml parameter file is generated in the default repository.

From the Batch Monitor Dialog Box

In the Batch Monitor dialog box, you can run the batch in Start Tab .

  1. Right-click Run to generate the report again.

    The Processes tab enables to follow the progress and status of run batches.

    The following information is displayed:

    • name of the batch
    • name of the parameters file used to run the batch
    • status of the batch ("Ended", etc.)
    • start and end time, respectively in the "Beginning at" and "Ending at" columns
    • return code: "0" means that the batch executed correctly, "-1" means that an error occurred result of the batch execution (either "Succeeded" or "Failed")
    • batch identification number

    The batch ID corresponds to the directory, named after the batch ID, where the log is stored. If warnings are detected, a warning log is added to the existing log file.

  2. Right-click FastenerRulesCheck and select Results.
    The Results dialog box is displayed.
  3. Click Save to save the results in a text file or Close to simply close the dialog box.

Associate an Existing Parameter File

You can associate an existing parameter file.

  1. From the Utilities tab, right-click FastenerRulesCheck and select Associate a parameter file.
  2. In the dialog box that appears, select an xml parameter file and click Open.
    The xml parameter file appears in the Start tab as an argument for the start of the FastenerRuleCheck utility.