Skip to main content
Version: 7.9


This function is used in Python Scripting.


Enables or disables a Tuple of equipment connections from a script.

Client Permission Restrictions

Permission Type: SECS/GEM Management

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when called in the Gateway scope.


system.secsgem.enableDisableEquipment(enable, names)


BooleanenableSet to True to enable equipment connections, or set to False to disable them.
TuplenamesA Tuple of Strings. Each String should match an Equipment Connection configured on the Gateway. If this parameter contains the name of an Equipment Connection that does not exist, then a message will be included in the List returned by this function.


List - A List of unicode strings. Each string contains a message about an equipment connection that could not be enabled/disabled. If the list is empty, then all specified equipment connections were successfully modified.


Designer, Client

Code Examples

Code Snippet
# Executing this example script will attempt to disable two Equipment Connections

# Create a Python Tuple of equipment names to disable.
equipmentNames = ("ToolOne","ToolTwo")

# Invoke the Function
result = system.secsgem.enableDisableEquipment(False, equipmentNames)

# Print the results of any equipment connections that could not be modified.
print result