Data Register Operator Functions

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

res_data_delete	(register, location, register_type)

Description:
This function deletes the current definition of the specified register.
Input:
INTEGER	register	This value specifies the register identifier.
STRING	location[]	This value specifies the model entity with which the results data is associated. Valid values are: "C" = centroid, "N" = nodal, "EN" = element nodal, and "EL" = element.
STRING	register_type[]	This value specifies the register type. Valid values are: "S" = scalar, "V" = vector, and "T" = tensor.
Output:
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Description:

This function deletes the current definition of the specified register.

Input:

INTEGER

This value specifies the register identifier.

STRING

location[]

This value specifies the model entity with which the results data is associated. Valid values are: "C" = centroid, "N" = nodal, "EN" = element nodal, and "EL" = element.

STRING

register_type[]

This value specifies the register type. Valid values are: "S" = scalar, "V" = vector, and "T" = tensor.

Output:

INTEGER

This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.

Error Conditions:

See the Status Messages for information on any error values returned by this function.

res_data_save	(register, location, register_type, load_case, subcase, layer, primary_result, secondary_result, num_entities, entity_list)

Description:
This function saves all of the possible data available for the specified register in the database as a result.
Input:
INTEGER	register	This value specifies the register identifier.
STRING	location[]	This value specifies the model entity with which the results data is associated. Valid values are: "C" = centroid, "N" = nodal, "EN" = element nodal, and "EL" = element.
STRING	register_type[]	This value specifies the register type. Valid values are: "S" = scalar, "V" = vector, and "T" = tensor.
STRING	load_case[]	This value specifies the load case identifier.
STRING	subcase[]	This value specifies the subcase identifier.
STRING	layer[]	This value specifies the layer position identifier.
STRING	primary_result[]	This value specifies the primary result identifier.
STRING	secondary_result[]	This value specifies the secondary result identifier.
INTEGER	num_entities	The number of entities in entity list. Default is 0. If value is 0 then PATRAN automatically generates a list of entities to associate with the results.
STRING	entity_list	The picklist of entities to associate to the results. If this argument is not existent, PATRAN automatically associates the results with appropriate entities [no default value].
Output:
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages (Ch. 11) for information on any error values returned by this function.

Description:

This function saves all of the possible data available for the specified register in the database as a result.

Input:

INTEGER

This value specifies the register identifier.

STRING

location[]

This value specifies the model entity with which the results data is associated. Valid values are: "C" = centroid, "N" = nodal, "EN" = element nodal, and "EL" = element.

STRING

register_type[]

This value specifies the register type. Valid values are: "S" = scalar, "V" = vector, and "T" = tensor.

STRING

load_case[]

This value specifies the load case identifier.

STRING

subcase[]

This value specifies the subcase identifier.

STRING

layer[]

This value specifies the layer position identifier.

STRING

primary_result[]

This value specifies the primary result identifier.

STRING

secondary_result[]

This value specifies the secondary result identifier.

INTEGER

num_entities

The number of entities in entity list. Default is 0. If value is 0 then PATRAN automatically generates a list of entities to associate with the results.

STRING

entity_list

The picklist of entities to associate to the results. If this argument is not existent, PATRAN automatically associates the results with appropriate entities [no default value].

Output:

INTEGER

This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.

Error Conditions:

See the Status Messages (Ch. 11) for information on any error values returned by this function.

The data register result is associated with the specified, existing, loadcase and subcase. It is given the primary and secondary result titles specified by the input value primary_result and secondary_result.