Troubleshooting (ACS)

If you do not find the answer to your problem in this topic, see the Known Issues section in the Release Notes.

If you do not have the required licenses to run ACS, ACS displays a message stating that a license is required.

To use ACS you require an ACS license and a Modeler license. In addition, you need ACS licenses for the languages you want to generate.

Ensure that you have added the ACS Profile to the model. If you have updated Modeler, ensure that you update the ACS Profile in your model. For information about adding the ACS Profile to a model, see Adding the ACS profile to a model (ACS).

Ensure that you have loaded ACS. On the ACS/TDK Control toolbar the

Load or Unload ACS button is depressed when ACS is loaded. If the

Load or Unload ACS button is not depressed, click it.

When you use ACS with a model for the first time, you must set up a Generation Settings Scheme to use to generate code. Tell me more...

If after selecting a Generation Settings Scheme and starting ACS through the

Start button, ACS does not do anything, the problem may be caused by you not having write access to your C:\Documents and Settings\<user> folder, in which ACS saves model cache files.

If you do not have write access to this folder, ACS will not work. To resolve this problem, obtain write access to the C:\Documents and Settings\<user> folder.

If you cannot obtain access to the C:\Documents and Settings\<user> folder, make the following changes:

• Change the values of the SHADOW_COMDIR environment variables to folders for which you have write access.

• In the Generate.sdl file that appears in the same folder as the Code Generator DLL, change any paths to the ComDir to the path you specified in the appropriate environment variable.

This message can be caused by selecting a previously supplied Synchronizer generation template scheme by mistake, rather than an ACS Code Generator DLL.

In the Modeler Help, find the ACS Code Generator DLLs topic for the code language you are generating - this topic documents the location of the ACS Code Generator DLLs that are available for that language.

While ACS is running, only changes shown in your Modeler's view of the model are generated.

If your Generation Settings Scheme is set up to work with a Package, ACS will not generate changes made to items that are not scoped to that Package or its sub-Packages. If this is the problem, create a new Generation Settings Scheme that uses the Model or a different Package. For more information, see Creating a generation settings scheme (ACS).

By default, ACS does not generate a new Class until you change its default name, that is, ACS ignores classes whose names are Class<integer>. ACS does this so that you can set up the Class before generating it. To resolve this problem, rename the Class, or on the Settings dialog (click the

Edit ACS Settings toolbar button to open) select the Generate Default Named Items check box.

Check that generation is enabled - on the ACS/TDK Control toolbar the

Enable or Disable Code Generation button should be depressed.

Check that ACS is working with the correct code directory. On the ACS/TDK Control toolbar, click the

Show Generation Information button - the ACS/TDK Pane records which code directory ACS is working with. Check that your code files are writeable - if they are read-only, ACS cannot generate to them.

If ACS has unreversed operation bodies or other marked text, ACS will not generate changes to the associated properties in the model. This ensures that unreversed changes are not lost.

If none of the preceding solutions solve the problem, force a generation: on the ACS/TDK toolbar, click the

Force Generation button.

If forcing a generation does not solve the problem, force a refresh: on the ACS/TDK toolbar, click the

Force Refresh button.

If you reset ACS, any reversible property changes that have not been reverse engineered because of the associated item in the model being read-only will be lost. To determine whether there are any reversible properties that have not been reverse engineered, on the ACS/TDK Control toolbar, click the

Show Protected Properties button.

To reset ACS: on the ACS/TDK toolbar, click the

Edit ACS Settings button. From the dialog, click the Reset ACS/TDK button.

If changes in the model are still not being generated. Unload ACS and close Modeler. Through Windows Task Manager, stop the following processes if they are running: ShdBridge.exe, ShadowACS.exe and RtsME.exe. Restart Modeler and ACS.

When working with a large model, you can improve the performance of ACS by making the root object a Package in that model, rather than the model itself.

ACS performs a full model load when the version number of the model has changed

When ACS generates code for a model the first time, it performs a full model load and creates a model cache file. Thereafter, ACS saves time by opening the model cache file rather than performing a full model load.

If ACS detects that the version number of a model has changed, ACS performs a full model load. For large models, a full model load can take a long time so you may prefer to force ACS to instead use the model cache file when the version number of a model has changed.

To force ACS to ignore changes to the version number of a model, set the value of the HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SELECT Software Tools\Ent60\Addins\Shadow\CacheFromVersionDisabled registry entry to 0.

On the ACS/TDK Control toolbar, click the

Show Generation Information button. The ACS/TDK Pane records which Code Generator DLL that is currently being used by ACS.

On the ACS/TDK Control toolbar, click the

Show Generation Information button. The ACS/TDK pane records which code files that are currently being managed by ACS.

If you change a Code Generator DLL's mangle.ini file, you must reset ACS (which deletes the cache).

Show Protected Properties button.

To reset ACS with the ACS running the appropriate Generation Setting Scheme, on the ACS/TDK toolbar, click the

Edit ACS Settings button. From the dialog, click the Reset ACS/TDK button.