PCL Reference Manual > Property Assignment Functions > Loads and Boundary Conditions
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Loads and Boundary Conditions
This section explains the functions that pertain to loads and boundary conditions (Loads/BCs).  
loadsbcs_create
(lbc_name, lbc_type, lbc_category, target_element, load_case_type, ap_list, geo_filter, alt_coord_frame, lbc_scale_factor, static_data, dynamic_field_name)
Description:
 
 
This function creates a new Load/BC set in the database.
Input:
 
 
STRING
lbc_name[31]
This value specifies the new Load/BC set name.
STRING
lbc_type[66]
This value specifies the Load/BC definition type. See the remarks below for more information.
STRING
lbc_category[31]
This value specifies the Load/BC category type: “Nodal”, “Element Uniform”, or “Element Variable”.
STRING
target_element[31]
This value specifies the target element type: ““, “1D”, “2D”, or “3D”.
STRING
load_case_type[31]
This value specifies the load case type and can be set to either “Static” or “Time Dependent”.
STRING
ap_list[]()
This value specifies the application region list by entity types and IDs.
STRING
geo_filter[31]
This value specifies the geometry filter: “Geometry” or “FEM”.
STRING
alt_coord_frame[200]
This value specifies the alternate coordinate frame in which Load/BCs are defined in.
REAL
lbc_scale_factor
This value specifies the Load/BC set scale factor.
STRING
static_data[100](20)
This value specifies static data values which could be real numbers or field names.
STRING
dynamic_field_name[200](20)
 
 
This value specifies the dynamic field names.
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:
 
3001003
%A% is an invalid Load Case Type. Must be Static or Time Dependent.
13000085
Cursor not open
13000117
The query specified has completed
14000001
LpGetHeapSpace: Allocated heapspace is exhausted
14000003
LpSublistType: No sublist filter bits are set on invocation
14000004
LpSublistType: I am being invoked with a NULL list
14000005
LpSublistType: In the list being used, the current sublist has a nonatomic CAR
14000006
LpSublistType: In the list being used, the current geometry sublist is unclassifiable
14000007
LpSublistType: In the list being used, the current finite element sublist is unclassifiable
14000008
LpSublistType: In the list being used, the current token sublist is unclassifiable
14000009
LpSublistType: In the list being used, the current sublist is unclassifiable
14000010
LpSublistType: In the list being used, the current sublist does not match the sublist filter
14000014
LpSublistNext: Attempt to proceed past last sublist in current list
14000015
LpSublistNext: End of current list has been reached
14000201
Invalid output string specified for call
26001010
Load/BC Definition %A% does not exist.
26002010
Load/BC Name is blank. Input a Load/BC Name.
26002011
Load/BC Name %A% is too long. Input 31 characters or less.
26002121
%I% is an invalid number of application regions for the specified Load/BC definition.
26002134
The list %A% contains FEM or unknown GEOmetric entities. All the entities in the application region(s) must be GEOmetric.
26002135
The list %A% contains GEOmetric or unknown FEM entities. All the entities in the application region(s) must be FEM.
26002136
%A% is an invalid Geometry Filter. Must be Geometry or FEM.
26002200
There was no data input for this Load/BC Set.
26002201
%I% is an invalid number of input data fields for the specified Load/BC definition.
26006001
Database error encountered: %I%. Call PDA Hotline.
Remarks:
The newly created Load/BC set will be displayed on the application region in the graphics window. If the Load/BC set is applied to geometry then the display will show the geometric entities, unless the “Show on FEM only” toggle is selected on the“Display”, Load/BC/Elem. Props...” menu bar form. If there are any associated FEM entities, then the Load/BC set will be evaluated at the FEM entities and displayed on them.
Load/BC set is added to the current load case.
The input value lbc_type can be set to the following values:
 
 
“Displacement”
“Force”
 
“Pressure”
“Temperature”
 
“Inertial Load”
“Initial Displacement”
 
“Initial Velocity”
“Distributed Load”
 
“Contact”
 
Example:
Please see loadsbcs_create.
 
loadsbcs_create2
(lbc_name, lbc_type, lbc_category, target_element, load_case_type, ap_list, geo_filter, alt_coord_frame, str_lbc_scale_factor, static_data, dynamic_field_name)
Description:
 
 
Evaluate the string variable str_lbc_scale_factor if it contains an unevaluated expression. Convert the scale factor to a real value. Call the loadsbcs_create function to create a new Load/BC set in the database.
Input:
 
 
STRING
lbc_name[32]
This value specifies the new Load/BC set name.
STRING
lbc_type[66]
This value specifies the Load/BC definition type. See the remarks below for more information.
STRING
lbc_category[32]
This value specifies the Load/BC category type: “Nodal”, “Element Uniform”, or “Element Variable”.
STRING
target_element[32]
This value specifies the target element type: ““, “1D”, “2D”, or “3D”.
STRING
load_case_type[32]
This value specifies the load case type and can be set to either “Static” or “Time Dependent”.
STRING
ap_list[]()
This value specifies the application region list by entity types and IDs.
STRING
geo_filter[32]
This value specifies the geometry filter: “Geometry” or “FEM”.
STRING
alt_coord_frame[200]
This value specifies the alternate coordinate frame in which Load/BCs are defined in.
STRING
str_lbc_scale_factor [LBC_DATA_LEN]
 
 
This value specifies the Load/BC set scale factor expression as a string.
STRING
static_data[100](20)
This value specifies static data values which could be real numbers or field names.
STRING
dynamic_field_name[200](20)
 
 
This value specifies the dynamic field names.
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:
 
3001003
%A% is an invalid Load Case Type. Must be Static or Time Dependent.
13000085
Cursor not open
13000117
The query specified has completed
14000001
LpGetHeapSpace: Allocated heapspace is exhausted
14000003
LpSublistType: No sublist filter bits are set on invocation
14000004
LpSublistType: I am being invoked with a NULL list
14000005
LpSublistType: In the list being used, the current sublist has a nonatomic CAR
14000006
LpSublistType: In the list being used, the current geometry sublist is unclassifiable
14000007
LpSublistType: In the list being used, the current finite element sublist is unclassifiable
14000008
LpSublistType: In the list being used, the current token sublist is unclassifiable
14000009
LpSublistType: In the list being used, the current sublist is unclassifiable
14000010
LpSublistType: In the list being used, the current sublist does not match the sublist filter
14000014
LpSublistNext: Attempt to proceed past last sublist in current list
14000015
LpSublistNext: End of current list has been reached
14000201
Invalid output string specified for call
26001010
Load/BC Definition %A% does not exist.
26002010
Load/BC Name is blank. Input a Load/BC Name.
26002011
Load/BC Name %A% is too long. Input 31 characters or less.
26002121
%I% is an invalid number of application regions for the specified Load/BC definition.
26002134
The list %A% contains FEM or unknown GEOmetric entities. All the entities in the application region(s) must be GEOmetric.
26002135
The list %A% contains GEOmetric or unknown FEM entities. All the entities in the application region(s) must be FEM.
26002136
%A% is an invalid Geometry Filter. Must be Geometry or FEM.
26002200
There was no data input for this Load/BC Set.
26002201
%I% is an invalid number of input data fields for the specified Load/BC definition.
26006001
Database error encountered: %I%. Call PDA Hotline.
Remarks:
This is an interface function that evaluates the scale factor string expression argument. The evaluation creates a real value that is passed on to the loadsbcs_create function. The purpose of this interface is to support the use of unevaluated expressions.
The newly created Load/BC set will be displayed on the application region in the graphics window. If the Load/BC set is applied to geometry then the display will show the geometric entities, unless the "Show on FEM only" toggle is selected on the"Display", Load/BC/Elem. Props..." menu bar form. If there are any associated FEM entities, then the Load/BC set will be evaluated at the FEM entities and displayed on them. Load/BC set is added to the current load case.
The input value lbc_type can be set to the following values:
 
 
“Displacement”
“Force”
 
“Pressure”
“Temperature”
 
“Inertial Load”
“Initial Displacement”
 
“Initial Velocity”
“Distributed Load”
 
“Contact”
 
Example:
None.
  
loadsbcs_create3
(lbc_name, lbc_type, lbc_category, target_element, load_case_type, ap_list, geo_filter, alt_coord_frame, str_lbc_scale_factor, static_data, disp_vec, dynamic_field_name)
Description:
 
 
Evaluate the string variable str_lbc_scale_factor if it contains an unevaluated expression. Convert the scale factor to a real value. Place the display vector argument, disp_vec, at the end of the static_data array. Call the loadsbcs_create function to create a new Load/BC set in the database.
Input:
 
 
STRING
lbc_name[32]
This value specifies the new Load/BC set name.
STRING
lbc_type[66]
This value specifies the Load/BC definition type. See the remarks below for more information.
STRING
lbc_category[32]
This value specifies the Load/BC category type: “Nodal”, “Element Uniform”, or “Element Variable”.
STRING
target_element[32]
This value specifies the target element type: ““, “1D”, “2D”, or “3D”.
STRING
load_case_type[32]
This value specifies the load case type and can be set to either “Static” or “Time Dependent”.
STRING
ap_list[]()
This value specifies the application region list by entity types and IDs.
STRING
geo_filter[32]
This value specifies the geometry filter: “Geometry” or “FEM”.
STRING
alt_coord_frame[200]
This value specifies the alternate coordinate frame in which Load/BCs are defined in.
STRING
str_lbc_scale_factor [LBC_DATA_LEN]
 
 
This value specifies the Load/BC set scale factor as a string.
STRING
static_data[100](20)
This value specifies static data values which could be real numbers or field names.
STRING
disp_vec[200]
Computed display vector from the mscnastran lbc_nsth_inpt_dirc_flux class.
STRING
dynamic_field_name[200](20)
 
 
This value specifies the dynamic field names.
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:
 
3001003
%A% is an invalid Load Case Type. Must be Static or Time Dependent.
13000085
Cursor not open
13000117
The query specified has completed
14000001
LpGetHeapSpace: Allocated heapspace is exhausted
14000003
LpSublistType: No sublist filter bits are set on invocation
14000004
LpSublistType: I am being invoked with a NULL list
14000005
LpSublistType: In the list being used, the current sublist has a nonatomic CAR
14000006
LpSublistType: In the list being used, the current geometry sublist is unclassifiable
14000007
LpSublistType: In the list being used, the current finite element sublist is unclassifiable
14000008
LpSublistType: In the list being used, the current token sublist is unclassifiable
14000009
LpSublistType: In the list being used, the current sublist is unclassifiable
14000010
LpSublistType: In the list being used, the current sublist does not match the sublist filter
14000014
LpSublistNext: Attempt to proceed past last sublist in current list
14000015
LpSublistNext: End of current list has been reached
14000201
Invalid output string specified for call
26001010
Load/BC Definition %A% does not exist.
26002010
Load/BC Name is blank. Input a Load/BC Name.
26002011
Load/BC Name %A% is too long. Input 31 characters or less.
26002121
%I% is an invalid number of application regions for the specified Load/BC definition.
26002134
The list %A% contains FEM or unknown GEOmetric entities. All the entities in the application region(s) must be GEOmetric.
26002135
The list %A% contains GEOmetric or unknown FEM entities. All the entities in the application region(s) must be FEM.
26002136
%A% is an invalid Geometry Filter. Must be Geometry or FEM.
26002200
There was no data input for this Load/BC Set.
26002201
%I% is an invalid number of input data fields for the specified Load/BC definition.
26006001
Database error encountered: %I%. Call PDA Hotline.
Remarks:
This is an interface function that evaluates the scale factor string expression argument. The evaluation creates a real value and passes it on to the loadsbcs_create function. The disp_vec argument is placed at the end of the stat_data array and the evaluated and combined data is passed to the loadsbcs_create() function. This interface function was required to support the lbc_nsth_inpt_dirc_flux class which creates a display vector. The purpose of this interface is to support the use of unevaluated expressions.
The newly created Load/BC set will be displayed on the application region in the graphics window. If the Load/BC set is applied to geometry then the display will show the geometric entities, unless the "Show on FEM only" toggle is selected on the"Display", Load/BC/Elem. Props..." menu bar form. If there are any associated FEM entities, then the Load/BC set will be evaluated at the FEM entities and displayed on them. Load/BC set is added to the current load case.
The input value lbc_type can be set to the following values:
 
 
“Displacement”
“Force”
 
“Pressure”
“Temperature”
 
“Inertial Load”
“Initial Displacement”
 
“Initial Velocity”
“Distributed Load”
 
“Contact”
 
  
loadsbcs_delete
(lbc_name)
Description:
 
 
This function deletes Load/BC sets from the database.
Input:
 
 
STRING
lbc_name[31]()
This value specifies the Load/BC set names to be deleted.
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:
 
-1
This is an internal status condition. There is no corresponding status message in the message database.
Remarks:
The deleted Load/BC sets are removed from the database. Each of the deleted Load/BC sets are removed from the graphics window.
The deleted Load/BC sets are removed from any load cases to which they were associated.
This function can display a fatal popup message form with the following messages:
 
13000103
No LBC was found
26003010
There are no Load/BC sets to delete.
26006001
Database error encountered: %I%. Call PDA Hotline.
26006004
Dynamic memory allocation error encountered.
This function can display a warning popup message form with the following messages:
 
26003040
Load/BC Set %A% does not exist.
26003050
%I% Load/BC Set(s) do not exist.
This function can display an information popup message form with the following message:
Example:
Please see elementprops_delete.
   
loadsbcs_modify
(load_case_name, new_name, lbc_type, lbc_category, target_element, load_case_type, ap_list, geo_filter, alt_coord_frame, lbc_scale_factor, static_data, dynamic_field_name)
Description:
 
 
This function modifies an existing Load/BC set in the database.
Input:
 
 
STRING
load_case_name[31]
This value specifies an existing Load/BC set name.
STRING
new_name[31]
This value specifies the new Load/BC set name.
STRING
lbc_type[31]
This value specifies the Load/BC definition type. See the remarks below for more information.
STRING
lbc_category[31]
This value specifies the Load/BC category type: “Nodal”, “Element Uniform”, or “Element Variable”.
STRING
target_element[31]
This value specifies the target element type: ““, “1D”, “2D”, or “3D”.
STRING
load_case_type[31]
This value specifies the load case type and can be set to either “Static” or “Time Dependent”.
STRING
ap_list[]()
This value specifies the application region list by entity types and IDs.
STRING
geo_filter[31]
This value specifies the geometry filter: “Geometry” or “FEM”.
STRING
alt_coord_frame[200]
This value specifies the alternate coordinate frame in which Load/BCs are defined in.
REAL
lbc_scale_factor
This value specifies the Load/BC set scale factor.
STRING
static_data[100](10)
This value specifies static data values which could be real numbers or field names.
STRING
dynamic_field_name[200](10)
 
 
This value specifies the dynamic field names.
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:
 
3001003
%A% is an invalid Load Case Type. Must be Static or Time Dependent.
13000085
Cursor not open
13000103
No LBC was found
13000117
The query specified has completed
14000001
LpGetHeapSpace: Allocated heapspace is exhausted
14000003
LpSublistType: No sublist filter bits are set on invocation
14000004
LpSublistType: I am being invoked with a NULL list
14000005
LpSublistType: In the list being used, the current sublist has a nonatomic CAR
14000006
LpSublistType: In the list being used, the current geometry sublist is unclassifiable
14000007
LpSublistType: In the list being used, the current finite element sublist is unclassifiable
14000008
LpSublistType: In the list being used, the current token sublist is unclassifiable
14000009
LpSublistType: In the list being used, the current sublist is unclassifiable
14000010
LpSublistType: In the list being used, the current sublist does not match the sublist filter
14000014
LpSublistNext: Attempt to proceed past last sublist in current list
14000015
LpSublistNext: End of current list has been reached
14000201
Invalid output string specified for call
26001010
Load/BC Definition %A% does not exist.
26002011
Load/BC Name %A% is too long. Input 31 characters or less.
26002030
%A% already exists. Modify not permitted.
26002121
%I% is an invalid number of application regions for the specified Load/BC definition.
26002134
The list %A% contains FEM or unknown GEOmetric entities. All the entities in the application region(s) must be GEOmetric.
26002135
The list %A% contains GEOmetric or unknown FEM entities. All the entities in the application region(s) must be FEM.
26002136
%A% is an invalid Geometry Filter. Must be Geometry or FEM.
26002200
There was no data input for this Load/BC Set.
26002201
%I% is an invalid number of input data fields for the specified Load/BC definition.
26002701
Load/BC set cannot be renamed to blank.
26002703
No existing Load/BC set is selected.
26006001
Database error encountered: %I%. Call PDA Hotline.
26006004
Dynamic memory allocation error encountered.
Remarks:
The Load/BC set data is modified in the database. The graphical display of the Load/BCs is modified.
The input value lbc_type can be set to the following values:
 
 
“Displacement”
“Force”
 
“Pressure”
“Temperature”
 
“Inertial Load”
“Initial Displacement”
 
“Initial Velocity”
“Distributed Load”
 
“Contact”
 
Example:
Please see loadsbcs_modify.
   
loadsbcs_modify2
(load_case_name, new_name, lbc_type, lbc_category, target_element, load_case_type, ap_list, geo_filter, alt_coord_frame, str_lbc_scale_factor, static_data, dynamic_field_name)
Description:
 
 
Convert the lbc scale factor from a string variable to a real value and call the loadsbcs_modify function which modifies an existing Load/BC set in the database.
Input:
 
 
STRING
load_case_name[32]
This value specifies an existing Load/BC set name.
STRING
new_name[32]
This value specifies the new Load/BC set name.
STRING
lbc_type[32]
This value specifies the Load/BC definition type. See the remarks below for more information.
STRING
lbc_category[32]
This value specifies the Load/BC category type: “Nodal”, “Element Uniform”, or “Element Variable”.
STRING
target_element[32]
This value specifies the target element type: ““, “1D”, “2D”, or “3D”.
STRING
load_case_type[32]
This value specifies the load case type and can be set to either “Static” or “Time Dependent”.
STRING
ap_list[]()
This value specifies the application region list by entity types and IDs.
STRING
geo_filter[32]
This value specifies the geometry filter: “Geometry” or “FEM”.
STRING
alt_coord_frame[200]
This value specifies the alternate coordinate frame in which Load/BCs are defined in.
STRING
str_lbc_scale_factor[LBC_DATA_LEN]
 
 
This value specifies the Load/BC set scale factor as a string.
STRING
static_data[100](10)
This value specifies static data values which could be real numbers or field names.
STRING
dynamic_field_name[200](10)
 
 
This value specifies the dynamic field names.
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:
 
3001003
%A% is an invalid Load Case Type. Must be Static or Time Dependent.
13000085
Cursor not open
13000103
No LBC was found
13000117
The query specified has completed
14000001
LpGetHeapSpace: Allocated heapspace is exhausted
14000003
LpSublistType: No sublist filter bits are set on invocation
14000004
LpSublistType: I am being invoked with a NULL list
14000005
LpSublistType: In the list being used, the current sublist has a nonatomic CAR
14000006
LpSublistType: In the list being used, the current geometry sublist is unclassifiable
14000007
LpSublistType: In the list being used, the current finite element sublist is unclassifiable
14000008
LpSublistType: In the list being used, the current token sublist is unclassifiable
14000009
LpSublistType: In the list being used, the current sublist is unclassifiable
14000010
LpSublistType: In the list being used, the current sublist does not match the sublist filter
14000014
LpSublistNext: Attempt to proceed past last sublist in current list
14000015
LpSublistNext: End of current list has been reached
14000201
Invalid output string specified for call
26001010
Load/BC Definition %A% does not exist.
26002011
Load/BC Name %A% is too long. Input 31 characters or less.
26002030
%A% already exists. Modify not permitted.
26002121
%I% is an invalid number of application regions for the specified Load/BC definition.
26002134
The list %A% contains FEM or unknown GEOmetric entities. All the entities in the application region(s) must be GEOmetric.
26002135
The list %A% contains GEOmetric or unknown FEM entities. All the entities in the application region(s) must be FEM.
26002136
%A% is an invalid Geometry Filter. Must be Geometry or FEM.
26002200
There was no data input for this Load/BC Set.
26002201
%I% is an invalid number of input data fields for the specified Load/BC definition.
26002701
Load/BC set cannot be renamed to blank.
26002703
No existing Load/BC set is selected.
26006001
Database error encountered: %I%. Call PDA Hotline.
26006004
Dynamic memory allocation error encountered.
 
 
 
Remarks:
This is an interface function that evaluates the scale factor string expression argument. The evaluation creates a real value that is passed on to the loadsbcs_modify function. The purpose of this interface is to support the use of unevaluated expressions.
The Load/BC set data is modified in the database. The graphical display of the Load/BCs is modified.
The input value lbc_type can be set to the following values:
 
 
“Displacement”
“Force”
 
“Pressure”
“Temperature”
 
“Inertial Load”
“Initial Displacement”
 
“Initial Velocity”
“Distributed Load”
 
“Contact”
 
Example:
None.
   
loadsbcs_plot_contours
(lbc_type, dynamic_value, data_variable, vector_component, lbc_name, group_names)
Description:
 
 
This function displays contours of the selected data variable on the selected group for a Load/BC in the current load case.
Input:
 
 
STRING
lbc_type[31]
This value specifies the Load/BC definition type. See the remarks below for more information.
REAL
dynamic_value
If this is a dynamic Load/BC set, then this is the dynamic value (e.g. time) at which contours are desired.
STRING
data_variable[31]()
This value specifies the selected data variable. If the Load/BC definition type is “Displacement” then valid variable names are “Translations <T1 T2 T3>” or “Rotations <R1 R2 R3>”.
STRING
vector_component[31]()
 
 
This value specifies the vector component: “Resultant”, “Component 1”, “Component 2”, or “Component 3”.
STRING
lbc_name[31]()
This value specifies the Load/BC set names in the current load case.
STRING
group_names[31]()
This value specifies the group names.
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:
 
-1
This is an internal status condition. There is no corresponding status message in the message database.
Remarks:
The Load/BC plot contours are displayed on the selected groups.
The input value lbc_type can be set to the following values:
 
 
“Displacement”
“Force”
 
“Pressure”
“Temperature”
 
“Inertial Load”
“Initial Displacement”
 
“Initial Velocity”
“Distributed Load”
 
“Contact”
 
This function can display a fatal popup message form with the following messages:
Example:
Please see loadsbcs_plot_contours.
   
loadsbcs_plot_markers
(lbc_name, group_names)
Description:
 
 
This function plots a graphical display of markers for the selected Load/BC sets in the current load case.
Input:
 
 
STRING
lbc_name[31]()
This value specifies the Load/BC set names in the current load case.
STRING
group_names[31]()
This value specifies the group names on which markers are to be plotted.
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:
 
-1
This is an internal status condition. There is no corresponding status message in the message database.
Remarks:
Markers are displayed for the selected Load/BC sets in the current load case.
This function can display a fatal popup message form with the following messages:
Example:
Please see loadsbcs_plot_markers.
   
loadsbcs_show
(lbc_name)
Description:
 
 
This function shows a tabular display of data for a selected Load/BC set on a spreadsheet, if the session is interactive.
Input:
 
 
STRING
lbc_name[31]
This value specifies the Load/BC set name in the current load case.
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:
 
-1
This is an internal status condition. There is no corresponding status message in the message database.
Remarks:
A spreadsheet with data is displayed if the session is interactive.
This function can display a fatal popup message form with the following messages:
Example:
Please see loadsbcs_show.