ACS/TDK control Tab (ACS)
The ACS/TDK Control tab has the following buttons.
 |
• If ACS is not loaded, only the following buttons are available:  Load or Unload ACS Enable or Disable Code Generation Enable Disable Reverse Engineering• If the TDK Profile is installed, additional buttons that relate to TDK only are available on the tab. |
Load or Unload ACS buttonIf ACS is not loaded (button not depressed), loads ACS.
If ACS is loaded (button depressed), unloads ACS.
Start buttonIf 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.
If ACS is started (button depressed), stops ACS running without unloading ACS.
Restart buttonRestarts ACS using the Generation Settings Scheme that is selected in the drop-down-list.
| | • 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. |
Stop buttonMakes ACS stop what it is doing, that is, ACS stops generating, reversing or refreshing.
Enable or disable code generationEnables 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 buttonEnables 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 buttonForces 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 buttonForces 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 buttonForces ACS to poll the model to identify differences between the model and the associated code files.
Show Protected Properties buttonWrites 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 buttonWrites 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 buttonOpens the ACS/TDK Settings dialog so that you can set the following options:
• Reverse on Startup check box
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 Disable Reverse Engineering 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).
Generate on Startup check box
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 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).
Generate Default Named Items check box
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.
Reset ACS / TDK button
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.
Logging options
Specifies which message types you want ACS to send to the ACS/TDK Log pane:
• Full Diagnostic — reports errors, warnings, messages and diagnostics.
• Standard — reports errors, warnings and messages.
• Errors and Warnings — reports errors and warnings.
In the ACS/TDK Log pane, errors, warnings, messages, and diagnostics are shown as follows:
! indicates an error
? indicates a warning
- indicates a message
~ indicates diagnostics.
Edit ACS Scheme buttonOpens the Launch ACS/TDK dialog for you to create or change a Generation Settings Scheme:
• 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.
For more information about the Launch ACS/TDK dialog, see Launch ACS/TDK dialog (ACS).
Generation Settings Scheme drop-down-list
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 button.
Edit ACS Scheme button.To use a Generation Settings Scheme and select the Generation Settings Scheme, and then click the Start button.
Start 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. |
Status space
Displays the current status of ACS.
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 button. |
Loading Model | ACS is loading the model. |
Not Connected | ACS is not loaded. Load ACS through the Load or Unload ACS 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. |