Appearance
Scenario Object Reference
This Scenario object is the response object to a simulation request.
json
{
"Id":"do.vj5rf3xjrgsvhzzuqejwa",
"StatusNbr": 1,
"StatusDescription": "Ok",
"JobStates": [],
"Progress": null,
"ResourcesForecast": [],
"NoSolutionGraphs": [],
"Errors": [],
"Settings": {},
}
INFO
A simulation request may return an error, such as a validation error, and therefore the Scenario response object is not guaranteed to contain a ResourcesForecast object.
Attributes
Id - string
Uniquely identifies a scenario.
StatusNbr - integer
Status number of current job state.
StatusDescription - string
Status description of current job state.
JobStates - array of objects
Identifies job states of a create scenario request. A request is managed as an on-demand job. An error-free request proceeds through Job States 1 - 7. Any Job State above 7 indicates a state in which a job cannot complete and a scenario cannot be generated. When a request is reporting the simulator is running (Job State 6), the Progress object provides progress information.
INFO
The Pool Resources Model is large and fairly common that initial attempts to run a simulation with a newly specified model will fail validation. The reported job states will be 1,2 and 8. Description of the error(s) are found in the Error object.
Progress - object
Description of progress and transactional statistics of a running simulation. Available when Job State is 5 or 6.
Results - array of objects
Object that contains a preferred result with respect to the type of simulation selected. The object is a collection of key performance metrics and time-series forecasts for each pool resource.
Time-Series Collection Items
- Financial KPI
- Financial Summary
- Hardware KPI
- Hardware Summary
- Hardware Transactions
- Software KPI
- Software Summary
- Software Transactions
- Facility KPI
- Facility Summary
- Facility Transactions
NoSolutionGraphs - array of objects
A list of graph object for which a solution was not found. A graph with no solution may arise when the model includes a Constraints object.
Errors - array of objects
List of scenario error descriptions.
Settings - object
Object that contains user provided values received from the PoolResourceModel Settings object. Zypr adds several date properties to this object and returns the Scenario Settings object.
JobStates
This JobStates object reports the various states a request steps through to generate a scenario.
json
{
"StatusTimestamp" : "08/22/2022 22:28:43",
"StatusNbr" : 3,
"Message" : ""
}
Attributes
StatusTimestamp - DateTime in UTC
Indicates when the state was posted.
StatusNbr - integer
The status number that corresponds to a job state.
Message - string
Describes the job state that corresponds to the status number.
Status Numbers and Description
Nbr | Description |
---|---|
1 | Received request |
2 | Start request initiated |
3 | Model validation succeeded |
4 | Host container available |
5 | Request verified start |
6 | Simulator is executing |
7 | Simulator completed |
8 | Simulator reports error |
9 | Request timed out |
10 | Simulator is not available |
11 | Job host service not available |
12 | Request exceeds user's rate limit |
13 | A required database transaction failed |
14 | Server returned an error |
Progress
This Progress object reports the current progress of a running scenario.
json
{
"Started": true,
"Completed": false,
"PercentComplete": 42,
"TransactionCount": 12847,
"SequenceCount": 832
}
TIP
To fetch the status of a running scenario use the appropriate GET endpoint in Simulation Management
Attributes
Started - boolean
Indicates the simulator has a valid input model to work with and construction of a scenario has commenced.
Completed - boolean
The simulator has completed and generated a scenario or encountered an error.
PercentComplete - integer
An estimate of progress to generate a scenario.
TransactionCount - integer
An estimate of feasible server add/remove transactions.
TransactionCount - integer
An estimate of feasible sequences of transactions corresponding to time-series duration as indicated by SolutionTargetTime property in the SimulationRules object.
Resources Forecast
This ResourcesForecast object reports the results of the scenario. Definitions of each object can be found in Resources Forecast object reference.
json
{
"FinancialKpi": {},
"FinancialSummary": {},
"ServerKPI": {},
"ServerSummary": {},
"ServerTransactions": {},
"SoftwareKPI": {},
"SoftwareSummary": {},
"SoftwareTransactions": {},
"FacilityKPI": {},
"FacilitySummary": {},
"FacilityTransactions": {}
}
No Solution Graphs
This NoSolutionGraphs object may list of one or more graphs that failed because a solution could not be found for that graph. If the Constraints object is used to constrain the feasible solution space, it is likely the object has a value that is too restrictive.
json
{
"FailedGraphNbr": 9,
"EdgeNbr" : 0,
"NodeY" : 0,
"NodeX" : 0,
"Message:" "Your constraint is too restrictive.
No graph solution compliant with constraint."
"AtRelativeTargetTime": 0.0,
"AtAbsoluteTargetTime": 0.0,
"LowestConstraintMetricVarianceRate": 0.0,
"StackTrace": null,
"NonCompliantSequences": null
}
INFO
The code block above indicates the solution space for Graph 9 is empty. This graph failed immediately at start time 0.0, indicated by both the AtRelativeTargetTime and AtAbsoluteTargetTime at 0.0, and the graph's EdgeNbr, and node address at NodeY, and NodeX, which are both 0.
Attributes
FailedGraphNbr - integer
The graph number the simulation engine attempted to build, but failed.
EdgeNbr - integer
Edge number of graph.
NodeY - integer
Node Y dimension of edge number.
NodeX - integer
Node X dimension of edge number.
INFO
Graph, Edge, and Node numbers represent a location address in Zypr's simulation engine.
Message - string
Description of failure.
AtRelativeTargetTime - numeric
Time (yrs) of failure relative to the edge number.
AtAbsoluteTargetTime - numeric
Time (yrs) of failure in absolute time.
LowestConstraintMetricVarianceRate - numeric
Variance from the target constraint.
Errors
This Error object identifies and describes one or more errors.
json
{
"Type": "Model input error",
"Message": "Processor Set Size must be positive at JE 2",
}
INFO
The code block above indicates the received PoolResourceModel object failed validation. The Message description refers to a Jump Event with EventId #2 in the JumpEvents object.
Attributes
Type - string
Error type.
Message - string
Detailed description of error.
Settings
This Scenario Settings object is includes properties received from the PoolResourcesModel Settings object, plus Zypr generated date properties used to generated all time-series results.
json
{
"ScenarioName": "My Scenario Name",
"DataValidationCascadeMode": "Stop",
"ModelEffectiveDate": "1/7/2022",
"ModelStartDate": "1/7/2022",
"ScenarioCreatedDate": "3/1/2022",
"CultureInfoISOCode": "EN",
"EmailResults": true,
"Pool": {
"Id": "ATL1_42_PROD",
"Name": "Name of service pool",
"Description": "A long description of pool"
},
}