cAnalyzeGetCaseStatus Method

Retrieves the status for all load cases.

Namespace:  ETABS2016
Assembly:  ETABS2016 (in ETABS2016.dll) Version: 16.0.0.0 (16.0.0.0)
Syntax
Copy
int GetCaseStatus(
	ref int NumberItems,
	ref string[] CaseName,
	ref int[] Status
)

Parameters

NumberItems
Type: SystemInt32
The number of load cases for which the status is reported.
CaseName
Type: SystemString
This is an array that includes the name of each analysis case for which the status is reported.
Status
Type: SystemInt32
This is an array containing integers from 1 to 4, indicating the load case status.
  1. Not run
  2. Could not start
  3. Not finished
  4. Finished

Return Value

Type: Int32
Returns zero if the status is successfully retrieved; otherwise it returns a nonzero value.
Remarks
Examples
VB
Copy
Public Sub Example()
       Dim SapModel As cSapModel
       Dim EtabsObject As cOAPI
       Dim ret As Integer = -1
       Dim NumberItems As Integer
       Dim CaseName() As String
       Dim Status() As Integer

   'create ETABS object
       EtabsObject = CreateObject("CSI.ETABS.API.ETABSObject")

   'start ETABS application
       ret = EtabsObject.ApplicationStart()

   'create SapModel object
       SapModel = EtabsObject.SapModel

   'initialize model
       ret = SapModel.InitializeNewModel()

   'create steel deck template model
       ret = SapModel.File.NewSteelDeck(4,12,12,4,4,24,24)

   'set load case run flag
       ret = SapModel.Analyze.SetRunCaseFlag("MODAL", False)

   'run analysis
       System.IO.Directory.CreateDirectory("c:\CSI_API_temp")
       ret = SapModel.File.Save("C:\CSI_API_temp\example.edb")
       ret = SapModel.Analyze.RunAnalysis

   'get load case status
       ret = SapModel.Analyze.GetCaseStatus(NumberItems, CaseName, Status)

   'close ETABS
       EtabsObject.ApplicationExit(False)

   'clean up variables
       SapModel = Nothing
       EtabsObject = Nothing
   End Sub
See Also