*CE_UpdateLink

Allows search and replace of an existing link in the specified connector with a new link entity.

Syntax

*CE_UpdateLink id search_type search_id search_name search_rule replace_type replace_id replace_name replace_rule replace_state

Type

HyperMesh Tcl Modify

Description

Allows search and replace of an existing link in the specified connector with a new link entity.

Inputs

id
The connector ID to update.
search_type
The entity type to search in the connector. This must be specified. The supported entities are comps, props, assems, surfs, tags, elems, nodes and parts.
search_id
The link entity ID to replace in the connector. The ID is optional, only if one of the following is true:
  • search_rule = 3 (use-name)
  • search_rule = 4 (proximity)
search_name
The name of the link entity to replace in the connector. The name is optional, only if one of the following is true:
  • search_rule = 1 (none)
  • search_rule = 2 (use-id)
  • search_rule = 4 (proximity)
search_rule (optional)
The rule by which the link entity was added to the connector. The following codes define the different rules:
  • search_rule = 0 (undefined rule)
  • search_rule = 1 (none rule)
  • search_rule = 2 (use-id rule)
  • search_rule = 3 (use-name rule)
  • search_rule = 4 (proximity rule)
If the rule is specified, the entity search is performed in accordance with the rule. For example, a search_rule of "use-id" requires search_id.
replace_type (optional)
The entity type that replaces the found link entity (search_type) in the connector. If not specified, the entity type information is not replaced for the found link (replace_type = search_type). The supported types are the same as that for search_type.
replace_id (optional)
The entity ID that replaces the found link entity. If not specified, the entity ID information is not replaced for the found link (replace_id = search_id).
replace_name (optional)
The entity name that replaces the found link entity. If not specified, the entity name information is not replaced for the found link (replace_name = search_name).
replace_rule (optional)
The rule to set for the found link entity. All the rules supported for search_rule parameters are supported.
replace_state
Sets the link entity that specifies if you are connecting to mesh or to geometry. The supported values are:
  • 0 - Undefined
  • 1 - Connect to mesh
  • 2 - Connect to geometry

Examples

To replace component ID 10 with component ID 20 for connector ID 1:
*CE_UpdateLink 1 comps 10 "" 0 0 20 "" 0 0
To replace component name "comp1" with component name "bumper" for connector ID 1:
*CE_UpdateLink 1 comps 0 "comp1" 0 0 0 "bumper" 0 0
To replace use-id with use-name rule for component ID 10 for connector ID 1:
*CE_UpdateLink 1 comps 10 "" 2 0 0 "" 3 0
To replace the state for component ID 10 in connector ID 1 from "connect to elems" to "connect to geom":
*CE_UpdateLink 1 comps 10 "" 0 0 0 "" 0 2
Note: In all the above cases, the connector entity is unrealized and any existing welds are removed from the connector. At most, one of the "replace" data must be specified to see a change in the link attributes. If the replace data exactly match the search data, the connector is not unrealized and no change is made to the link entity.