*modent_applyconfiguration

Applies or unapplies a configuration.

Syntax

*modent_applyconfiguration entity_type entity_id apply_flag

Type

HyperMesh Tcl Modify Command

Description

Applies or unapplies a subsystem configuration. This command allows activating or deactivating a specific configuration of subsystems.

Only one configuration can be applied at a time. By applying a new configuration, any previously applied configuration will be automatically unapplied. Subsystems that do not belong to any configuration are considered active by default. When a configuration is unapplied, all subsystems are set to active, regardless of their previous configuration membership.

When a connector exists between active subsystems, the connector is also activated automatically.

Inputs

entity_type
The type of configuration to apply. Currently supported for subsystemconfigurations.
entity_id
The ID of the configuration to apply or unapply.
apply_flag
Specifies whether to apply or unapply the configuration:
0 - Unapply the configuration.
1 - Apply the configuration.

Examples

To apply a subsystem configuration with ID 1:
*modent_applyconfiguration subsystemconfigurations 1 1
To unapply a subsystem configuration with ID 2:
*modent_applyconfiguration subsystemconfigurations 2 0

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2026