Invalid characters in OptoControl subroutine names cause problems when downloading strategy

Applies To:

FactoryFloor Software - OptoControl

Versions Affected:

Problem was discovered in version: R4.1d

Symptoms:

Subroutines with invalid characters (such as a period or an ampersand) in a subroutine name, cause an Undefined command error when the strategy is downloaded to a controller.

Workaround:

To correct the problem, rename the subroutines using valid characters.

Example:
These 2 subroutines need to be renamed.

Calculate.Result ←This name has a period (.)
MeasureWater&Level ←This name has an ampersand (&)

To rename them, open the subroutine in OptoControl and select File→Save As. Save the subroutine using a valid name. In our example, the subroutines can be saved as:

Calculate_Result_z
Measure_Water_Level_z

Note: The invalid character is replaced with an underscore (_). A suffix such as "_z" is also added in case an item is named the same in OptoScript.

After saving the new subroutine names, they need to be added to the strategy. Use Edit→Replace to replace all instances of the old name with the new name. After the new subroutines are added, remove the old subroutines from the strategy.

The strategy can now be downloaded to the controller.

Resolution:

Opto 22 is aware of this issue.

Questions?

Contact: Opto 22 Product Support.
Phone: 800-835-6786 or 951-695-3080
Email: support@opto22.com

DISCLAIMER

This Opto 22 Knowledge Base ('OptoKB') article is intended to provide general technical information on a particular subject or subjects and is not an exhaustive treatment of such subjects. Accordingly, the information in this OptoKB article is not intended to constitute application, design, software, or other professional engineering advice or services. Opto 22 may modify the OptoKB articles at any time. Before making any decision or taking any action which might affect your equipment, you should consult a qualified professional.

OPTO 22 DOES NOT WARRANT THE COMPLETENESS, TIMELINESS, OR ACCURACY OF THE DATA CONTAINED IN THIS OPTOKB ARTICLE AND MAY MAKE CHANGES THERETO AT ANY TIME AT ITS SOLE DISCRETION WITHOUT NOTICE. FURTHER, ALL INFORMATION CONVEYED HEREBY IS PROVIDED TO USERS 'AS IS.' IN NO EVENT SHALL OPTO 22 BE LIABLE FOR ANY DAMAGES OF ANY KIND INCLUDING DIRECT, INDIRECT INCIDENTAL, CONSEQUENTIAL, LOSS PROFIT, OR DAMAGE, EVEN IF OPTO 22 HAS BEEN ADVISED ON THE POSSIBILITY OF SUCH DAMAGES.

OPTO 22 DISCLAIMS ALL WARRANTIES WHETHER EXPRESSED OR IMPLIED WITH RESPECT TO THE INFORMATION (INCLUDING HARDWARE, SOFTWARE, AND/OR FIRMWARE) PROVIDED HEREBY, INCLUDING THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTIBILITY, AND NON-INFRINGEMENT. Note that certain jurisdictions do not sanction the exclusion of implied warranties: thus, this disclaimer may not apply to you.