Diagnostics

The Last Run and Assay Cutting windows show diagnostic messages about your Network case.

• The Last Run window shows messages about the last optimization run.

• The Assay Cutting window shows messages generated when the case assays are recut.

To open both windows, click Diagnostics in the Views group of the Home ribbon tab. To open a specific window, click the arrow next to the Diagnostics button and choose the window you want to open from the list. You can dock these windows to the main Network environment window.

You can organize the list of messages in several ways:

• Click the Errors, Warnings and Messages buttons to include or exclude messages of each type.

• Click a column header to sort the messages according to the contents of the column. Click again to reverse the sorting order.

• Filter the messages by clicking the Find icon () and typing in the text box that appears.

• Choose which columns to display by selecting a view from the Views drop-down list.

The following sections list some common diagnostic messages and their resolution.

Supply or demand

Supply or Demand has a minimum of amount which is greater than the maximum of amount

In the Supplies or Demands page, there are a Minimum and Maximum constraints on the same row, both active and with the minimum value greater than the maximum value.

Solution: Modify the values so that the minimum is lower than the maximum. Alternatively, disable one or both constraints by clearing their Active check box.

Transport links

Transport Link has a minimum of amount which is greater than the maximum of amount

In the Transport Links tab of the Transports page, there are a Minimum and Maximum constraints on the same row, both active and with the minimum value greater than the maximum value.

Solution: Modify the values so that the minimum is lower than the maximum. Alternatively, disable one or both constraints by clearing their Active check box.

Transport Link has an available from date which is after its available to date

In the Transport Links tab of the Transports page, there is a row with the From date in the Availability column being after the To date.

Solution: Modify either date so that the From date is before the To date.

Transport Link has an available from date which is equal to its available to date

In the Transport Links tab of the Transports page, there is a row with the From date in the Availability column being equal to the To date.

Solution: Modify either date so that they differ, with the From date being before the To date.

Availability dates required for transport Transport Link as constraints are not flow rate

In the Transport Links tab of the Transports page, there is a row with no Availability dates set, and with a Minimum or Maximum constraint expressed in a mass or volume unit (such as tonne) rather than a flow rate unit (such as tonne/d).

Solution: Do any of the following:

• Remove or deactivate the constraint.

• Change the constraint unit of measure to a flow rate unit.

• Enter a date range in the Availability column.

Shipments

Shipment: Shipment has an amount UoM of UoM which is incompatible with its associated transport link: Transport Link, which has a constraint numerator UoM of UoM

In the Shipments tab of the Transports page, a shipment is defined with a UoM value under the Amount header which is incompatible with the UoM value defined in the Transport Links tab for the corresponding transport link. For example, in the previous image the shipment is defined with a unit of measure of m3 (volume-based), while the unit of measure of the transport link is tonne (weight-based).

Solution: Change the unit of measure in either the transport link or the shipment, so that the two are compatible. Alternatively, select a different transport link with a compatible unit of measure in the Transport Link column of the shipments grid.

Terminal inventories

Two or more inventories with undefined start or end dates are present for material material name at terminal terminal name

In the Terminal Inventories tab of the Terminals page, at least two inventories are defined for a Node and a Traded Material but do not have either the Start or the End value specified under the Period header.

Solution: Fill the missing values in the Start and End columns.

Inventory for material material name at terminal terminal name is not defined for all periods

In the Terminal Inventories tab of the Terminals page, an inventory is defined for some periods of the case, but not all. For example, in the image above the inventory is defined for period 1 only, but the case has two periods.

Solution: Click the Add Inventory button in the Inventories group of the Home ribbon tab to add more rows to the inventories grid, and define the same inventory for all remaining periods.

Inventory for material material name at terminal terminal name has multiple definitions for the same period

In the Terminal Inventories tab of the Terminals page, an inventory is defined for different periods of the case on separate rows, but there is some overlap in the periods. For example, in the image above inventory for regular gasoline is defined on two rows, both including period 1.

Solution: Modify the inventory definitions so that there is no period overlap.

Terminal terminal name inventory inventory name opening inventory for Traded Material of amount is less than minimum inventory of amount

In the Terminal Inventories tab of the Terminals page, one row has the Opening and Minimum constraints both set as Active, with the Opening value lower than the Minimum value.

Solution: Do either of the following:

• Clear the Active check box under at least one of the Opening or Minimum headers, so that at least one constraint becomes inactive.

• Modify the constraint values so that the Opening value is higher than the Minimum value.

Terminal terminal name inventory inventory name opening inventory for Traded Material of amount is greater than maximum inventory of amount

In the Terminal Inventories tab of the Terminals page, one row has the Opening and Maximum constraints both set as Active, with the Opening value higher than the Maximum value.

Solution: Do either of the following:

• Clear the Active check box under at least one of the Opening or Maximum headers, so that at least one constraint becomes inactive.

• Modify the constraint values so that the Opening value is lower than the Maximum value.

Terminal terminal name inventory inventory name minimum closing inventory for Traded Material of amount is more than maximum closing inventory of amount

In the Terminal Inventories tab of the Terminals page, one row has the Closing Minimum and Closing Maximum constraints both set as Active, with the Closing Minimum value higher than the Closing Maximum value.

Solution: Do either of the following:

• Clear the Active check box under at least one of the Closing Minimum or Closing Maximum headers, so that at least one constraint becomes inactive.

• Modify the constraint values so that the Closing Minimum value is lower than the Closing Maximum value.

Terminal terminal name inventory inventory name has a minimum of amount which is greater than the maximum of amount

In the Terminal Inventories tab of the Terminals page, one row has the Minimum and Maximum constraints both set as Active, with the Minimum value higher than the Maximum value.

Solution: Do either of the following:

• Clear the Active check box under at least one of the Minimum or Maximum headers, so that at least one constraint becomes inactive.

• Modify the constraint values so that the Minimum value is lower than the Maximum value.

Plants

Two or more plants with undefined start or end dates are present at node name

In the Plants page, at least two plants are defined for a Node but do not have either the Start or the End value specified under the Period header.

Solution: Fill the missing values in the Start and End columns.

Plant for node name is not defined for all periods

In the Plants page, one or more plant nodes are not associated with plants (defined in Plan cases) for all the periods defined in the Period page.

Solution: Click the Add Plant button in the Plants group of the Home ribbon tab to add more rows to the grid. Define all the missing associations between plant nodes and cases.

Plant for node name has multiple definitions for the same period

In the Plants page, two or more rows have the same value in the Node column and overlapping periods defined in the Start and End columns under the Period header.

Solution: Do one of the following:

• Delete the duplicate rows by selecting them and clicking Delete Plant in the Plants group of the Home ribbon tab.

• Change the values in the Node column so that the rows refer to different plant nodes, making sure that you do not introduce other conflicts by doing so.

• Change the values in the Start and End columns, so that the rows refer to different periods.

Calculations

Calculation calculation name has a minimum of amount which is greater than the maximum of amount

In the Constraints and Alerts page, one calculation has the Minimum and Maximum constraints both set as Active, with the Minimum value higher than the Maximum value.

Solution: Do either of the following:

• Clear the Active check box under at least one of the Minimum or Maximum headers, so that at least one constraint becomes inactive.

• Modify the constraint values so that the Minimum value is lower than the Maximum value.

Calculation calculation name is marked as 'Global' but contains non-period-specific variables

In the Constraints and Alerts page, one calculation was defined by setting its Type as Global. One or more variables were created by setting their Period as Current, instead of choosing one specific period.

Solution: Click on the calculation row in the Constraints and Alerts page and click Edit in the Calculations group of the Home ribbon tab. The Edit dialog window opens. Then do either of the following:

• Change the Type setting to Period.

• Edit the formula variables by clicking on their rows in the Formula tab and then clicking the Edit Variable icon (). Change the Period setting from Current to a specific period.

Global parameters

Global Parameter parameter name does not have a valid range minimum or an active minimum constraint

In the Constraints and Alerts page there is a Network Global Parameter with no defined Minimum constraint, or with the Active check box for the constraint not selected.

Solution: Enter a value for the Minimum constraint and select the Active check box.

Global Parameter parameter name does not have a valid range maximum or an active maximum constraint

In the Constraints and Alerts page there is a Network Global Parameter with no defined Maximum constraint, or with the Active check box for the constraint not selected.

Solution: Enter a value for the Maximum constraint and select the Active check box.

Optimization

Unexpected error occurred (code guid)

Please contact support for help diagnosing this error.

Optimization solution has active infeasibility breakers: Penalty cost cost M$

The model could not be optimized without infeasibility breakers. Infeasibility breakers were then activated, allowing the model to converge by breaking one or more constraints, and introducing the penalty cost shown in the diagnostic message.

Solution: There will be other error messages which will allow you to determine the constraints that have been violated. You can then modify the model accordingly, for example by disabling or changing the constraints, or by making other changes to bring solution values back within constraint limits.

For background information on infeasibility breakers, see Infeasibility Breakers.

Network Calculation calculation: error in parsing Formula formula

A calculation you defined in the Calculations page has a formula with a syntax error in it. Note that the calculation editor highlights errors in the formula field and warns you before closing the editor, but you can still create calculations with invalid formulas.

Solution: In the Calculations page, select the calculation with the invalid formula. Click Edit Calculation in the Calculations group of the Home ribbon tab. Correct the formula in the editor and click OK to save your changes.

Network Calculation calculation has solution value value which is below fixed value amount

In the Constraints and Alerts page, there is a calculation with an active Fixed constraint. The result of the calculation is below the constraint value.

Solution: Do either of the following:

• Clear the Active check box under the Fixed header to disable the constraint.

• Change the constraint fixed value in the Value column.

Network Calculation calculation has solution value value which is below minimum amount

In the Constraints and Alerts page, there is a calculation with an active Minimum constraint. The result of the calculation is below the constraint value.

Solution: Do either of the following:

• Clear the Active check box under the Minimum header to disable the constraint.

• Change the constraint value in the Value column.

Network Calculation calculation has solution value value which is above fixed value amount

In the Constraints and Alerts page, there is a calculation with an active Fixed constraint. The result of the calculation is above the constraint value.

Solution: Do either of the following:

• Clear the Active check box under the Fixed header to disable the constraint.

• Change the constraint fixed value in the Value column.

Network Calculation calculation has solution value value which is above maximum amount

In the Constraints and Alerts page, there is a calculation with an active Maximum constraint. The result of the calculation is above the constraint value.

Solution: Do either of the following:

• Clear the Active check box under the Maximum header to disable the constraint.

• Change the constraint value in the Value column.