ACS/TDK control toolbar (ACS)

• If the ACS Profile has not been added to the model, no toolbar buttons are available.

• If ACS is not loaded, only the following toolbar buttons are available:

Load or Unload ACS

Enable or Disable Code Generation

Enable or Disable Reverse Engineering

• If the TDK Profile is installed, additional buttons that relate to TDK only are available on the toolbar.

Load or Unload ACS button

If ACS is not started (button not depressed), the result of clicking the Start button is dependent on what is shown in the drop-down list:

• If the drop-down list shows a selected Generation Settings Scheme, starts ACS using the shown Generation Settings Scheme. Note that the drop-down list lists the Generation Settings Schemes that have been created for the selected item in Modeler.

• If the drop-down list show New Scheme..., opens the Launch ACS/TDK dialog for you to define the Generation Settings Scheme for the Model or Package that is selected in Modeler.

• If the drop-down list is blank, does not start ACS. You must select a valid item in Modeler, that is, the Model or a Package.

• The Generation Settings Schemes available in the list depend on the Model or Package that is selected in Modeler.

• If New Scheme is selected in the drop-down-list, ACS opens the Launch ACS/TDK dialog for you to define the Generation Settings Scheme for the Model or Package that is selected in Modeler.

Enable or disable code generation

Enables or disables the automatic generation of code files. When enabled and ACS is running with a Modeler model, changes to that model are automatically generated to the code files. By default, generation is enabled. When enabled, the button is depressed.

Enable or Disable Reverse Engineering button

Enables or disables the automatic reverse engineering of operation bodies and other reversible properties in the code. When enabled and ACS is running with a model, changes to reversible properties in your code files are automatically reverse engineered to the Model. By default, reverse engineering is enabled. When enabled, the button is depressed.

For information about using the reverse option to maintain reversible properties, see Strategy for maintaining reversible properties (ACS).

Force Generate button

Forces the forward generation of code files from the Model. When you force a generation, ACS deletes any redundant code files, but does not delete any redundant folders. Use this button when you want to make sure that your code files are in sync with the model.

Force Reverse button

Forces the reverse engineering of operation bodies and other reversible properties from your code files to the Model. Use this button when you want the reversible properties in the model to be in sync with the associated marked text in your code files.

You should not force a reverse in a multi-user environment, because you may overwrite other user’s changes to reversible properties in the model.

Force Refresh button

Forces ACS to poll the model to identify differences between the model and the associated code files.

Show Protected Properties button

Writes the following information to the ACS/TDK Log pane which code files have operation bodies and other reversible properties that have not been reverse engineered.

Show Generation Information button

Writes the following information to the ACS/TDK Log pane which model is loaded, which Model or Package is the root object for generation, which code files are being worked with, and which Code Generator DLL is being used.

If you hover the mouse pointer over the Generation Settings Scheme drop-down-list, the Modeler status bar displays the current ACS generator, model root item and target directory being used.

Edit ACS Settings button

Enables or disables the automatic reverse engineering of operation bodies and other reversible properties when starting ACS. When selected, on starting ACS, ACS reverse engineers reversible properties from your code files that are different from their associated text in the model.

If the Reverse on Startup check box is selected and you disable reverse engineering through the Enable or Disable Reverse Engineering toolbar button, ACS clears the Reverse on Startup check box.

In a multi-user model, you must never enable reverse on startup. If you do, on starting ACS, any updated reversible properties in the model will be overwritten with the out-of-date text in your code files. Likewise, you must never force a reverse.

For information about using the reverse on startup option to maintain reversible properties, see Strategy for maintaining reversible properties (ACS).

Enables or disables a generation on startup. If reverse and generate are enabled on startup, ACS performs the reverse engineering operation, followed by the generation operation. When ACS forces a generation, ACS deletes any redundant code files, but does not delete any redundant folders. If reversible properties are out of sync because they cannot be reverse engineered, ACS does not overwrite that marked text in the code file.

If the Generate on Startup check box is selected and you disable generation through the Enable or Disable Code Generation toolbar button, ACS clears the Generate on Startup check box.

For information about using the Generate on Startup option to maintain reversible properties, see Strategy for maintaining reversible properties (ACS).

Enables or disables the automatic generation of classes that have default names. When selected, ACS generates classes that have default names. When disabled, ACS ignores classes whose names are Class <integer> - ACS does this so that you can set up the class before generating it.

Deletes the ACS cache file (SHM file) that is associated with the current model. You should delete the ACS cache file only if it is necessary to do so to resolve a problem.

Edit ACS Scheme button

• If the drop-down list shows a Generation Settings Scheme, opens the Launch ACS/TDK dialog for you to change that Generation Settings Scheme.

• If the drop-down list show New Scheme..., opens the Launch ACS/TDK dialog for you to create a Generation Settings Scheme for the Model or Package that is selected in Modeler.

• If the drop-down list is blank, you must select a valid item in Modeler, that is, the Model or a Package.

List Generation Settings Schemes that have been created for the item selected in Modeler. You can create Generation Settings Scheme for the Model or a Package only.

To change a Generation Settings Scheme and select the Generation Settings Scheme, and then click the

Edit ACS Scheme toolbar button.

To use a Generation Settings Scheme and select the Generation Settings Scheme, and then click the

Start toolbar button.

If you hover the mouse pointer over the Generation Settings Scheme drop-down-list, the Modeler status bar displays the current ACS generator, model root item and target directory being used.

Properties	Uses
Connected	ACS is loaded, but has not been started using a Generation Settings Scheme.
First Generation	ACS is generating to cache. After ACS has finished generating to cache, you can generate code files through the Force Generate toolbar button.
Loading Model	ACS is loading the model.
Not Connected	ACS is not loaded. Load ACS through the Load toolbar button.
Ready	ACS is waiting for changes to generate or reverse.
Updating Code	ACS is generating.
Updating Model	ACS is reverse engineering.

If you hover the mouse pointer over the Status space, the Modeler status bar displays additional information about the current status of ACS.