Aspen Petroleum Supply Chain

V10

Release Notes
Version Number: V10
June 2017
Copyright (c) 2017 by Aspen Technology, Inc. All rights reserved.

Aspen Petroleum Supply Chain, Aspen PIMS, Aspen Unified PIMS, Aspen Petroleum Scheduler, Aspen Refinery
Multi-Blend Optimizer, Aspen Report Writer, Aspen Refinery Report, Aspen Excel Integration Utility and the aspen
leaf logo are trademarks or registered trademarks of Aspen Technology, Inc., Bedford, MA.

All other brand and product names are trademarks or registered trademarks of their respective companies.

This document is a guide for using AspenTech's software. This documentation contains AspenTech proprietary and
confidential information and may not be disclosed, used, or copied without the prior consent of AspenTech or as set
forth in the applicable license agreement. Users are solely responsible for the proper use of the software and the
application of the results obtained.

Although AspenTech has tested the software and reviewed the documentation, the sole warranty for the software
may be found in the applicable license agreement between AspenTech and the user. ASPENTECH MAKES NO
WARRANTY OR REPRESENTATION, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THIS
DOCUMENTATION, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR
PURPOSE.

Aspen Technology, Inc.

20 Crosby Drive
Bedford, MA 01730
USA
Phone: (1) (781) 221-6400
Toll Free: (1) (888) 996-7100
URL: http://www.aspentech.com
Contents
About These Release Notes .....................................................................................5
Related Documentation .....................................................................................5

New Features ..........................................................................................................7

Aspen PIMS .....................................................................................................7
Aspen Assay Management .................................................................................8
Aspen Unified PIMS ..........................................................................................8
Aspen Olefins Scheduler....................................................................................8
Aspen Petroleum Scheduler ...............................................................................8
Dock and Pipeline Scheduling Enhancements .............................................9
UserCalc Modifications ............................................................................9
Changes to Existing Functionality .............................................................9
Aspen Refinery Multi-Blend Optimizer .................................................................9
Aspen Blend Controller Interface ...................................................................... 10
Aspen Petroleum Supply Chain Planner ............................................................. 10

Software Fixes ......................................................................................................13

Aspen PIMS ................................................................................................... 13
Aspen Assay Management ............................................................................... 16
Aspen Petroleum Scheduler ............................................................................. 17
Aspen Refinery Multi-Blend Optimizer ............................................................... 19
Aspen Report Writer ....................................................................................... 19
Aspen Petroleum Supply Chain Planner ............................................................. 20

Known Issues........................................................................................................21
Aspen PIMS ................................................................................................... 21
Advanced Optimization Perform Option Clarification.................................. 21
Aspen Unified PIMS ........................................................................................ 21
Installation on a Non-Domain Environment.............................................. 21
Submodel Unit Simulations.................................................................... 21
Running Large Number of Cases (>1000) Fails ........................................ 21
AUP Assay Management – Use of Custom Tags for Pure Components.......... 22
Custom Splitter Towers Display Incorrectly.............................................. 22
Aspen Assay Management ............................................................................... 22
Selection of Incorrect Temperature Units May Cause Invalid Results or Crash22
Aspen Petroleum Scheduler (APS) and Aspen Refinery Multi-Blend Optimizer (MBO)23
Access Models...................................................................................... 23
Use of USE_LOG_UTC flag and Concurrent Users...................................... 23
Aspen Petroleum Scheduler ............................................................................. 23
User without access rights can modify control variable list on an event screen23
Aspen EIU – Importing volume based inventory in the weight based model . 24
Build Ref tab on Submodel Dialog – Display issues ................................... 24

Aspen Petroleum Supply Chain V10 Release Notes iii

 Pipeline Dialogs – Missing post and prep times......................................... 24
Pipeline Scheduling – Line fill data not saved if baseline is changed to earlier
time ................................................................................................... 24
Pipeline Scheduling – Weight based pipeline movements........................... 24
Pipeline Scheduling – Automation........................................................... 25
Pipeline Scheduling – Excel Integration and Edit in Excel ........................... 25
Do not Use Copy and Paste to Create a New Pipeline Out-of-Service Event.. 25
Oracle Model Issue ............................................................................... 25
Crash Occurs When Trying to Simulate using Oracle 12............................. 25
Aspen Report Writer ....................................................................................... 26
Aspen RenameTags ........................................................................................ 26
Aspen Refinery Multi-Blend Optimizer ............................................................... 26
Refresh Issue – Product Pipeline Related Events....................................... 26
Aspen Petroleum Supply Chain Planner ............................................................. 26
PSCP may crash when closing Map Window ............................................. 26

iv Aspen Petroleum Supply Chain V10 Release Notes

About These Release Notes

These Release Notes describe the Aspen Petroleum Supply Chain (PSC) V10
family of products which includes Aspen PIMS, Aspen Petroleum Scheduler,
Aspen Olefins Scheduler, Aspen Refinery Multi-Blend Optimizer, Aspen Report
Writer and Aspen Blend Controller Interface. This document includes:
 New features
 Known Issues

Related Documentation
In addition to these Release Notes, AspenTech provides the following
documentation for the Aspen Petroleum Supply Chain V10 family of products:
 Aspen Petroleum Supply Chain Installation Guide
 Aspen PIMS Integration – User Guide
 Aspen Petroleum Scheduler Integration – User Guide
 Aspen Refinery Multi-Blend Optimizer Integration – User Guide
 Aspen PIMS Help
 Aspen Unified PIMS Help
 Aspen Petroleum Supply Chain Planner Help
 Aspen Petroleum Scheduler Help
 Aspen Refinery Multi-Blend Optimizer Help
 Aspen Report Writer Help
 Aspen Blend Controller Interface Help

Aspen Petroleum Supply Chain V10 Release Notes 5

New Features

This section describes the new features in the Aspen Petroleum Supply Chain
family of products. Products that are not specifically listed indicate there
were no major feature changes to these products included in this release.

Aspen PIMS
The following enhancements and improvements are included in the V10
release of PIMS:
 Aspen PIMS Platinum has been subsumed into Aspen Unified PIMS and
can no longer be accessed directly from PIMS
 PIMS EE has been sunset.
 New MIP Setting
The Enable MIP Warm Start setting has been added on to the MIP
options tab of the Xpress L.P. Model Settings dialog box. This setting
helps to improve efficiency (speed) of MIP runs, especially for large MIP
models by warm-starting the first MIP iteration from the state of the MIP
variables in the input solution.
 New TRANCOL options
o V10 now allows generation of TRANCOL reports for PIMS-AO
executions. These reports can be viewed using the new AO Marginal
Analysis Viewer which allows you to perform what-if scenarios by
seeing results when swapping independent and dependent variables.
o The Create XLPTC File option has been added that allows you to
generate a TRANCOL file without writing to the database, thus saving
valuable storage space.
 Assay Table Spreadsheet
The ASSAYS input spreadsheet has been added to the Model Tree
Tables tab. You can perform standard spreadsheet operations on the
ASSAYS spreadsheet from the Navigation tree as well as through the
Assay Management system.
 New Automation Method
The automation method RunParametricAnalysis has been added that
allows you to run Parametric Analysis.

Aspen Petroleum Supply Chain V10 Release Notes 7

 Aspen Assay Management
The following enhancements were added to Assay Management for the V10
release:
 Fractionation Model Enhancements
Allows calibration of SI factors from plant test-run data. This is the most
significant enhancement to Assay Management for V10. By enabling you
to calibrate the fractionation model SI factors, PIMS crude cutting data will
reflect the current state of plant operation, resulting in improved accuracy
of the planning model.
 PIMS Integration Enhancements
Increase application speed by eliminating redundant data transfers. This
saves significant time when working with PIMS models that include a large
number of crudes.
 Improved Ease of Importing Assay Data
An improved AspenTech formatted Excel File template simplifies assay
data importing. This template includes dropdown lists of available options
for country, properties, and units – shortening the time required to
prepare paper assays and eliminating manual entry errors.
 New Assay Reporting
Characterized assay results can now be exported to Excel in the form of a
typical assay report for the purpose of easly communicating assay data
across your organization.

Aspen Unified PIMS

Aspen Unified PIMS is a new product for V10. Features from aspenONE PIMS
Platinum have been subsumed in this product.

Aspen Olefins Scheduler

AOS has been sunset.

Aspen Petroleum Scheduler

The following V10 enhancements apply to APS only.
 aspenONE PIMS Platinum is sunset in V10 and therefore can no longer be
accessed from Petroleum Scheduler
 A new option, Crude Audit Basis, has been added to the Settings dialog
box. This option allows you to select from volume or weight. What is
selected is how quantities appear on the Audit Inventory dialog box. In
addition, a CONFIG keyword, CRD_AUDIT_BASIS, has been added to the
CONFIG table that also sets the Audit Inventory basis.
 A new CONFIG keyword, OXE_MAX_VALUE_LIMIT, has been added.
This keyword allows you to set a maximum value that will be processed

8 Aspen Petroleum Supply Chain V10 Release Notes

 when using OXE. If a cell value is larger than this value, it will not be
processed.
 A new setting, Calculate Limits, has been added to the Material
Pools dialog box that allows the system to automatically calculate trend
limits for specific types of material pools.

Dock and Pipeline Scheduling Enhancements

 Addition of #AUTO section on new Voyages worksheet to invoke user
defined functionality from the Voyages dialog box.

UserCalc Modifications
 Now supported for Dock Scheduling Crude Receipt, Non-crd
Rcpt (PRODRCPT) and Product Shipment events. Pipeline
Scheduling events regarding receipts and shipment also support
UserCalc.
 Route input section has been added
on CRDRCPT, PRODRCPT and PLSHIP UNITS worksheets to handle route
input, displacement segment , displacement tanks and forward rate input.

Changes to Existing Functionality

 If the PUB_BIAS_RESULTS keyword is set to 'Y' in the CONFIG table,
period bias results are published to the _ZBIASRESULTS table. Previously
bias results were published to the _BIASRESULTS table.
 The Crude Basis option on the Settings dialog box has been changed
to Crude Assay Basis to clarify that the option specifically affects the
basis associated with Crude Assays.

Aspen Refinery Multi-Blend

Optimizer
The following V10 enhancements apply to MBO only.
 A new setting, Calculate Limits, has been added to the Material
Pools dialog box that allows the system to automatically calculate trend
limits for specific types of material pools.

Aspen Petroleum Supply Chain V10 Release Notes 9

 Aspen Blend Controller
Interface
The following V10 enhancement applies to BCI:
The following Controller Types are no longer supported and therefore will no
longer appear in the Bend Controller Type dropdown list:
 Pro-Blend-T
 Pro-Blend
 Blend-QC-Y
 Aspen Blend PIMS
These formats are associated with the old .pim model file which is no longer
used.

Aspen Petroleum Supply Chain

Planner
The following V10 enhancements apply to PSCP:
Mapping technology is significantly improved in this release. New mapping, in
the form of Leaflet files, allows for easier results analysis. A summary of
these enhancements follows.
 Leaflet maps allow for easier zooming, mouse panning, node selection,
keyboard panning and box-zooming; use these features as you would any
browser application without having to access Edit menu commands.
 New map layers from ESRI online base maps.
Map improvements that apply to all map types visible on the Results window
include:
 Numbers appear on the segment and transport lines
o For transport lines costs or activities are displayed based on the
new View menu option Show Cost (Transport Only).
o For segment lines, total used capacity for the associated segments is
displayed.
o Time-weighted-averages for ratable data over multiple periods can
be displayed.
o Activity number is a time-weighted-average or a sum of activities
depending on report data basis.
o Cost number is always a sum of total costs.
 Clicking on a node highlights associated values in green in the details
pane below the map. The Summation area updates to show the sum of
the associated row entries.
 For case comparison results, visible numbers for segment and transport
activities display the difference between the two cases.

10 Aspen Petroleum Supply Chain V10 Release Notes

  For maps with period data
o For each period, the number associated with the line is sum of
activities/costs of the associated segments or transports
o For all periods, if report is on total basis, the number is a sum of
activities/costs for selected periods
o For all periods, if the report is on a ratable basis, the number is a time
weighted average of activities associated with the line for all
selected periods
The following options and enhancements have been added to the Results
Window View menu and toolbar:
Icon View Menu Description
Option

Show Number
with Arrow Displays numbers with Transport and Segment
lines.
 For transport lines costs are displayed
 For segment lines, total used capacity
for the associated segments is displayed.
Show Cost Shows the cost associated with the transport arc.
(Transport Option is disabled if Show Number with
Only) Arrow is not selected.
Show Total Shows total cost as well as activity total for
Cost activities; if not selected, does not show cost
totals; cost totals are always on a total basis
and can be in the form of total spending or total
revenue depending on the active view (e.g, which
tab is selected). Total costs appear in
the Summation toolbar area.
Show Empty Show all nodes even if they are empty and
Unlinked unlinked. If not selected, empty and unlinked
nodes are hidden.
Find All Shows all connections from a selected node to a
Connections destination, including all intermediaries; the full
path for a particular node are shown. If this option
is not selected, only the direct links to/from a
selected node are visible.
Highlight Available only when comparing cases. Show only
Material with materials where values are different, in other
Differences words where non-zero changes occur.
Aggregate Available only when comparing cases. Display
Real Numbers numbers as real values, not absolute values, thus
displaying the actual change in total volume; if
option not selected, values appear as absolute
numbers.

Additional toolbar enhancement

 Filters allow you to perform type ahead search input and also multi-
selection within all dropdown filters.
 Filters now support range selection. You can check/uncheck an item and
then hold down Shift to select additional items in a range.

Aspen Petroleum Supply Chain V10 Release Notes 11

 Changed map behavior
 Clicking on a node highlights all associated row entries in the results
window; there is no need to select All Nodes to update the summation
window.

 To improve visual usability, you can show either segments or

transport arcs or neither on a map. You cannot display both at the
same time.
New Map related settings
 You can now customize map font and number formatting from
the Program Options Map tab.
 A tolerance level can be set when displaying a case comparison map that
is separate from the number of decimal places. The Zero
Tolerance option has been added to the Select Solution Cases dialog
that allows you to set a zero tolerance value. Values that are less than or
equal to the entered value will be treated as zero.

Additional Enhancements for V10:

 New Automation Method
GetOutputDatabaseFilePath() has been added that returns the full path to
the current results database.
 New setting to display simplified tooltips
The Don't use custom tooltips option has been added to
the Workaround tab on the Program Options dialog box to help solve
an issue where tooltips may not display consistently.
 Matrix Browser
Significant improvements have been made to matrix loading speed.

12 Aspen Petroleum Supply Chain V10 Release Notes

Software Fixes

Petroleum Supply Chain V10 Suite applications include several software fixes
that further improve the product. This section summarizes those fixes.

Aspen PIMS
This section describes the software fixes to PIMS.
id Headline
CQ00457301 Property Transfer Failure in the Global Optimization
CQ00469565 Different row status for CCAPAT1 row if multistart is ON or OFF
CQ00471567 Case solves differently using multi-start when solved alone vs
when solved with case stack
CQ00478769 Unexpected W904 and W915
CQ00486190 Error in Viscosity Reporting of Streams
CQ00492982 DR Model won't generate - creating illegal characters to handle
VPRICE entries
CQ00507241 MPIMS Model crashes on XNLP\XLP when runs out of memory
CQ00511507 Inconsistent ABML performance
CQ00511806 Discrepancy between Multistart and regular run report
CQ00520759 MIP convergence issue
CQ00535598 Error when using multi-processing
CQ00579799 Trancol and Sensitivity Analysis is not available in PIMS-AO
CQ00615737 Need a way to set and save preferred setting for different
types of PIMS AO runs
CQ00675449 Model Archive issue
CQ00687084 Unable to generate .txt report for local model
CQ00688992 Index out of bounds
CQ00689485 Different behavior of Eps in CaseParallel with LOADSOL
CQ00692303 Clean up functions in SQL DB (similar to access database -
user login specific) - UC02
CQ00692604 No diagnosis message in .xlr file for Infeasible problem with
Multi Start in V8.7 CP9
CQ00692984 Stop/cancel case runs by users at any time

Aspen Petroleum Supply Chain V10 Release Notes 13

 id Headline
CQ00692987 MIP - advanced start to improve MIP solve time
CQ00693596 Weight & Vol. basis yields display for sub-model units not
available
CQ00693597 Blends recipe display not available
CQ00694602 SMC Refresh Log file incomplete for intersection of added row
and added column
CQ00694631 Solution Evaluation Unhandled exception has ocurred in your
application with polish regional setting
CQ00695770 PIMS-AO: XLP First solve INF with GOMS on, OPT with GOMS
off
CQ00695938 The lack of balance in submodel - Full Solution report
CQ00696361 AM reads CASE tables before opening
CQ00696363 Duplicate mapping of assay tables and strange behaviour
during cleanup.
CQ00696621 Submodel Calculator Not getting Opened in X-PIMS Model with
Extended Tags - Error - Unable to open Table <SUBMODEL>
CQ00696928 Parametrics with PROCLIM & BLNSPEC
CQ00699712 XLP: Case runs OK run alone but is infeasible in case stack.
CQ00699915 Eliminate parametrics analysis pop dialog box with showing all
values zero
CQ00700050 PIMS-AO does not identify missing spreadsheets during model
execution or when reading the files
CQ00702091 ABML does not obey ABMLOPT for all correlations
CQ00702882 Cleanup model deletes LP basis file assigned to an input
solution
CQ00703395 Trancol xls not created if no other reports selected in options
CQ00703398 Multi-Start Parallel is not working with the Trancol reports
CQ00703688 Trancol Marginal Viewer Needs Ability to Filter Rows and
Columns Separately
CQ00704024 Model Setting to Create Trancol XLPTC File without Writing to
the Database
CQ00704236 When changing an open model from DR to AO some values
seem to be stuck
CQ00705467 Flexcel not reading file w/commented out data
CQ00705735 PIMS-AO Output Diagnostics / XLR Viewer Crashes
CQ00705879 WBALHYR is out of balance in AO V9.0 due to incorrect
FBLNHRY coefficient in the matrix for gas
CQ00706246 Objective functions wrong in solution report for AO multi
period model
CQ00706342 Published Plan using PIMS Publish Adapter contains StateType
as Actual for some Items
CQ00706770 PIMS AO VPOOL problem - VPOOL is not being applied to SELL
in AO
CQ00706795 Activity in DR matrix file is missing after running model in AO
CQ00708880 PIMS 8.8.3. crashes - COM event issue
CQ00708891 Error message in PIMS AO due to MODEL case keyword
CQ00709211 Execution Error: Failed to validate the SolutionID in

14 Aspen Petroleum Supply Chain V10 Release Notes

 id Headline
PrSolutionID table.
CQ00709356 Issue with broken non-linear equation
CQ00709926 Global DISABLE entries inconsistent about removal of stream
from GSUPPLY
CQ00715395 PPIMS report generation problem in AO - zero value for
periods added through case
CQ00715558 Include a message in the installer that EIF adapter is needed
if use SQL database output in PIMS
CQ00716102 Recursion related errors when AOCOST/ACPRICE is present for
ALK
CQ00717073 Issues with External model derivatives when using
Input/Output mapping
CQ00719329 CASE comparison - remember the last selection
CQ00725515 Add Parametric Analysis to automation methods in PIMS
CQ00726007 Excel pop-up message when running
CQ00726008 Missing coefficient in PIMS AO
CQ00726825 Margin doesn’t include constant portion of inventory cost.
CQ00727199 Issue with 3NF Case file for BOP
CQ00727782 Problem with 3rd Normal form of Table CASE in AO
CQ00729523 Unable to determine reason for execution error (E732:
VOL/Wgt mismatch)
CQ00730332 PIMS Crashes with External Models and Swing Cut Gradient
CQ00731100 Model infeasible on removing inactive crude from shortcut
distillation
CQ00732689 Case stack run solves differently than 1st solve during multi-
start
CQ00733484 XLP Error message with apparently OK structure
CQ00734499 PCALCed values not carrying through based on change to base
stream in CASE table
CQ00734933 Difference between OBJFN and Global Non Discounted
Objective in economic summary rpt
CQ00735209 PIMS DR crashes with customer model
CQ00735771 Period objective function wrong in .mdb in multiperiod AO
CQ00735980 INVT column does not work in Table DISPLAY
CQ00735984 Inconsistent OBJ in Database - add warning msg
CQ00735998 Dialogs appearing during run by automation
CQ00736761 Objective function wrong in Down report for multi-period
model
CQ00737398 Capacity Limit Symbol < > Missing in Across Submodel
Reporting
CQ00737687 Error for Case Comparison after PA runs-"The given key was
not present in the dictionary."
CQ00737709 Warning message- table too large to display in PIMS grid
(e.g., table GROUPS). -- Flag Popup
CQ00738609 3rd Normal Multi-Plant Case Files with CP4
CQ00738635 Unified PIMS (Athena) Beta users requesting update to case

Aspen Petroleum Supply Chain V10 Release Notes 15

 id Headline
selection from the case hierarchy
CQ00740141 SPG value of whole crude (instead of value in ISPGXXX row)
is taken when using Automatic Volume/Weight Quality
balancing
CQ00741877 Request to access Assay Excel file from PIMS model tree
rather than from Assay Management
CQ00742765 PBONUS structure not built in PPIMS if there is not a non-
periodic spec on the corresponding quality
CQ00743410 SummarySolution reports always have time unit = DAY - even
when settings say otherwise (Hr or Year)
CQ00744474 Group structure missing for blend in V8.8 CP04
CQ00746999 Warning message "Writing SKED....."
CQ00748593 Parametric Crash (XPROD and 16+ cases)
CQ00748637 Issue with PBONUS table for SPG property - issue with AO, not
DR
CQ00750755 Solution Index Report Not Generated
CQ00750980 PIMS crashes when adding files to local model navigation tree
CQ00752714 Lower bounds of new NLEs have variable MIN&#39;s set to -
1e+30
CQ00753157 MPIMS/AO: Errors not including DEPOT related columns in AO
CQ00755026 Lingering model structure when remove submodel

Aspen Assay Management

This section describes the software fixes to Assay Management.

ID Headline
CQ00605833 Enable option to generate cutting results for all crudes or modified
crudes
CQ00697891 Fix issue on copying GC data from excel and pasting to GC input
form.
CQ00742492 Fix issue on RVP calculations for crude blending
CQ00753144 Fix issue on adding new crudes and deactivating existing crudes at
the same time in the PIMS Assay Table

16 Aspen Petroleum Supply Chain V10 Release Notes

 Aspen Petroleum Scheduler
This section describes the software fixes to APS.

ID Headline

CQ00419902 Audit Inventories & Qualities Interface

CQ00432520 Need to be able to locate UBML.DLL somewhere other than in
%PROGRAM FILES%
CQ00505950 Crude Tank volume exceeds the maximum allowable
CQ00545394 Strange rendering of Gantt when using dual mode flowsheets and
Gantts
CQ00591185 APS and MBO does not save changed values in table view windows
to the model
CQ00690717 When closing a model, login and archive are still displayed in the
file menu
CQ00691989 Strange Behavior - Crude Unit Material Pool
CQ00693461 _CRDRUN entries do not match between 7.3 and 8.8
CQ00695781 Export blends and Export from SBO publish different results.
CQ00696195 V7.3 Orion Issues
CQ00698234 APS crashes when using a shared working folder - simultaneous
users updating derived events log causes crash
CQ00698262 Linked Unit Operation Events jump dates when the model is
save/refreshed
CQ00700046 Crude tank property report in Report Wizard
CQ00700412 Pipeline Fills updated by macros are not refreshed in APS
CQ00701508 Crude tanks show differences in model
CQ00702011 _CRDRUNS values are different for crudes 0CL and 0LH; Changes
in Periods
CQ00703050 Trend limits change issues
CQ00703379 When using tons in pipeline crude receipt, crude inventory in a
pipeline is corrupted
CQ00703840 Changes the dependent variable field for events
CQ00704377 APS issue when changing value in SMC file
CQ00705346 Different/Multiple results in PL batches model - v8.7 CP6
CQ00705441 #MACRO in User Calc for v8.7 pipeline events not executing when
adding a new event
CQ00705686 Unable to open MSCDVD_V9.0_x64.msi / setup.exe
CQ00705856 Dock Model Error
CQ00707106 The default end date in the Events Reconciliation Dialog Box is not
today, but the end of the scheduling period
CQ00707573 Max No of open Event setting to 1 makes the application to crash

Aspen Petroleum Supply Chain V10 Release Notes 17

 ID Headline

CQ00709378 Material Pool Trend Limits are being corrupted when a material
pool is build from pure streams
CQ00711445 Links to Dock events disappear on copying to new case
CQ00715268 Event conflicts shown against linked pipeline events
CQ00715271 Sum of Components dont add up to 100%
CQ00719782 Save button issue on unchanged events
CQ00724400 Quantity dependent event with start link creates save errors.
CQ00724610 After deleting a case, entries in the publish tables for that case are
not being deleted
CQ00724895 APS losing start links
CQ00725216 Circular link bug in 8.8
CQ00725945 Trends are not properly refreshed when I hit MAX VOL through
Right Click Max VOL for the Crude Run Event
CQ00726564 APS changing Min Max values for quantity dependent events with a
start link
CQ00727258 Misleading Dialog Box while switching cases of a Non-Dock model.
CQ00729254 V8.8 unnecessary tables updates
CQ00729456 Min/Max limits set on pool definition are not respected 8.8
CQ00730131 Additional entries into the ATOrionEventResources table for
product pipeline events
CQ00730559 EventsColl Remove Automation Call
CQ00732932 Issue With MaxVol On a particular Crude Run event
CQ00733108 Critical issue - _Crude_XREF table
CQ00733944 Event Import will crash after importing a second data source
CQ00740893 Long labels are offset in the blend details window
CQ00743047 V7.3 imports always in volume, 8.8 looks at crude basis
CQ00744218 APS Audit Changes functionality not as designed for Import
Events on Unit Operations
CQ00745886 Parameter baseline is not read if the model has offset hours
CQ00749740 Units Workbook Creates Trendline that causes issues

18 Aspen Petroleum Supply Chain V10 Release Notes

 Aspen Refinery Multi-Blend
Optimizer
This section describes the software fixes to MBO.

ID Headline
CQ00496505 Horizontal zoom on the Gantt chart cannot be smaller than a
day. Provide a smaller limit, like 4 hours
CQ00554590 PROP_BAL table failed to store data: Cannot insert explicit
value for identity column
CQ00594468 ethanol% should be available for all Gasoline Types
CQ00698675 Cannot set Default Composition for a product
CQ00707371 Published events remain after event is deleted and schedule is
republished
CQ00707590 MBO component rundown - values changing
CQ00710629 MBO "Component Rundowns..." "Copy from APS" incorrect for
tanks
CQ00715888 Linked events not properly processed by the
Integration/Import/Events display.
CQ00732916 How to use a material pool for blend component in MBO and
maintain correct inventory
CQ00735152 MBO crashes when optimizing blend rundown events in Blend
Group
CQ00741087 PimsBci.bci fails to connect to SQL Server DB
CQ00751491 Issue after importing events

Aspen Report Writer

This section describes the software fixes to Report Writer.

ID Headline
CQ00710740 Report Writer Issue with Macros/Excel (Office 2016)
code
CQ00732312 ARW issue with changes to template
CQ00733968 APS reports are not working

Aspen Petroleum Supply Chain V10 Release Notes 19

 Aspen Petroleum Supply Chain
Planner
This section describes the software fixes to PSCP.

ID Headline
CQ00477752 DPO Case comparison feature should have a switch to limit
displayed differences to column/row activity values
CQ00701181 A bug while sorting DJ column in Results Window
CQ00731237 Add new automation property to return full DB path
CQ00734688 Make the box-zooming option more discover-able to the
user
CQ00739246 Matrix structure and associated warning are not correct
CQ00757321 Results window map occasionally lock up and show an error
message
CQ00757936 New map gets a makeover after clicking the "Leaflet" or
"Esri" link in the lower right corner of the map view
CQ00759354 PSCP registry entries from older version didn't get cleaned
after software uninstall

20 Aspen Petroleum Supply Chain V10 Release Notes

Known Issues

This section covers known issues associated with the Petroleum Supply Chain
V10 release. Issues are organized by product.

Aspen PIMS
Advanced Optimization Perform Option
Clarification
For Perform options associated with AO functions, only execution results
associated with the currently requested function is displayed. All other AO
execution results are not included. To see all results, use the View option.

Aspen Unified PIMS

Installation on a Non-Domain Environment
If the system on which Unified PIMS is installed is a workgroup environment
(non-domain), you will not be able to browse for domain users to assign roles
associated with the site, models and assay libraries to others.

Submodel Unit Simulations

Issue: When a submodel starts with a large number of degrees of freedom
(the difference between number of variables and number of equations) the
algorithm used to square the submodel may fail to complete before the
system times out. As a result, the simulation may fail to open.
Resolution: Reduce the number of degrees of freedom by decreasing the
number of variables.

Running Large Number of Cases (>1000) Fails

Issue: Running a large number of cases may fail to execute properly.
Resolution: The ability to run a large number of cases is highly dependent
on hardware limitations as well as customizing AUP software settings. Please
contact AspenTech Support and reference Knowledge Base Article Number

Aspen Petroleum Supply Chain V10 Release Notes 21

 44619 “How to Resolve Case Execution Issues at Various Concurrency
Settings” for best practices when running a large number of cases.

AUP Assay Management – Use of Custom Tags for

Pure Components
Issue: If you create pure components with custom tags, the system may not
be able to associate those tags with known pure components. In this case,
the system will assign default IBP to FBP values. Erroneous or unanticipated
results may consequently appear due to invalid calculations.
Resolution: AUP assay management can distinguish several pure
components tags such as NC1, NC3, NC4 and IC4 and assign appropriate IBP
to FBP values. Use these known tags to ensure IBP and FBP values are
correctly used.

Custom Splitter Towers Display Incorrectly

Issue: Custom splitter towers with multiple feeds do not display correctly in
a distillation mode.
Resolution: Custom Splitter towers can only have a single feed per mode. If
multiple feeds are present, they will not be displayed correctly. Redefine the
splitter tower so there is only a single feed.

Aspen Assay Management

Selection of Incorrect Temperature Units May
Cause Invalid Results or Crash
CQ00763558
Issue: When using the Setup Wizard to transfer PIMS Assay Table data to
Aspen Assay Management, you must ensure that the correct temperature unit
is selected for each product (cut) on the Define Cut Points step. If an
incorrect temperature unit is selected, the assay data will be transferred
based on an incorrect unit. The data and characterization results will be
incorrect and meaningless. Under certain conditions, such as there are more
than 3 products (cuts) under 36 C., errors may occur during characterization
and the results will not be suitable for use in generating cutting results for
PIMS. Selection of incorrect units when used in conjunction with Distillation-
based separation method, may cause a crash to occur.
Resolution: Select the correct temperature unit for each product (cut)
during setup.

22 Aspen Petroleum Supply Chain V10 Release Notes

 Aspen Petroleum Scheduler
(APS) and Aspen Refinery
Multi-Blend Optimizer (MBO)
Access Models
There is a known compatibility issue when running Office 365 on Windows 10
or Windows 8.1 and using Access databases. Without performing the
following, you will not be able to open your databases.

Note: The steps below will work for both 32 or 64 bit versions of Office 365.
If running the 64 bit version of Office 365, another option is to create a DSN
for each database and skip the steps below.
Please follow the steps below:
1 Download the Microsoft Access Database Engine 2010 Re-
distributable from the following location:
http://www.microsoft.com/en-
us/download/details.aspx?displaylang=en&id=13255
Click Download and select AccessDatabaseEngine.exe.
2 Click Next to start the download process. The executable can be found in
your Downloads folder.
3 Once downloaded, install AccessDatabaseEngine.exe by right-clicking
and selecting “Run as Administrator”. Follow the instructions. You can
also run the installation by double-clicking on the file.
The installation installs an associated driver that you can see under
Control Panel | Programs | Programs and Features.
Example: Microsoft Access database engine 2010
After completing the steps above, you will be able to open .mdb databases
through the application.

Use of USE_LOG_UTC flag and Concurrent Users

When the USE_LOG_UTC flag is set and two users are working on the same
APS/MBO model at the same time, modified the same event, the conflict
dialog is shown even if the user accepted the changes from the other user.

Aspen Petroleum Scheduler

User without access rights can modify control
variable list on an event screen
CQ0075659
CQ00717047

Aspen Petroleum Supply Chain V10 Release Notes 23

 Issue: User rights have changed starting with V8.8. APS now allows ALL
users to perform “What-If” scenarios irrespective of user rights when making
changes to an event screen. Changes however cannot be saved to the
database unless the user has the appropriate rights. The following message
displays when attempting to save, “x number of events will not be saved…”.
Resolution: If you wish to save changes on an event screen, be sure you
have the appropriate user rights.

Aspen EIU – Importing volume based inventory in

the weight based model
CQ00715769
CQ00696328
Issue: EIU does not allow importing of volume based Crude inventory into a
weight based model
Resolution: Convert crude inventory to weight based when using EIU

Build Ref tab on Submodel Dialog – Display issues

CQ00722995
The grid column sizes are not persisted when resized and must be resized
each time you return to the dialog.

Pipeline Dialogs – Missing post and prep times

CQ00752677
Post and Prep time fields are missing on a Pipeline Crude Receipt and
Pipeline Product Injection dialogs.

Pipeline Scheduling – Line fill data not saved if

baseline is changed to earlier time
CQ00762109
If a line fill date is set and then the baseline date or model start date is
changed prior to that date, APS does not save or ask the user if they wish to
save.

Pipeline Scheduling – Weight based pipeline

movements
CQ00715764
CQ00702887
CQ00726204
Issue: APS has limited functionality to handle weight based pipeline
movements. Therefore, there may be performance issues.
Resolution: Convert pipeline events to volume based events.

24 Aspen Petroleum Supply Chain V10 Release Notes

 Pipeline Scheduling – Automation
APS does not allow accessing of the following pipeline event types via
automation:
 Pipeline Product Injection
 Pipeline Out of Service
 Pipeline Fill Destination change

Pipeline Scheduling – Excel Integration and Edit

in Excel
APS does not allow accessing any pipeline event types via Excel Integration
Utilities or Edit in Excel.

Do not Use Copy and Paste to Create a New

Pipeline Out-of-Service Event
Issue: Copying and pasting an out-of-service event to create a new event of
this type is not supported. Using cut and paste will cause the system to
crash. This type of event affects numerous other associations that cannot be
simply duplicated.
Resolution: Create a new Out-Of-Service event in the usual way by going
to Events | Add Event | Pipeline Out-of-Service.

Oracle Model Issue

Issue: Oracle models will not work correctly with a lowercase username for
database connection. Behavior is not consistent and crashes may occur.
Resolution: Change the username to upper case for database connection.

Crash Occurs When Trying to Simulate using

Oracle 12
Issue: Inability to simulate when using Oracle 12.
Resolution: A necessary component has been deprecated with Oracle 12.
Oracle Client 11g contains the required component. You will therefore need
to do the following:
1. Download the Oracle Client 11g installation.
2. Start the installer and select Custom as the installation type then click
Next.
3. Skip the software updates and click Next.
4. On the Available Product Components page, select Oracle Objects
for OLE.
5. Complete the installation for the component.

Aspen Petroleum Supply Chain V10 Release Notes 25

 Aspen Report Writer
Aspen Report Writer is not compatible with and therefore will not run when
using 64-bit versions of Microsoft Office, for example, Office 2010 64bit.

Aspen RenameTags
Use of Aspen RenameTags.exe is not supported in this release. Changing
tags using RenameTags may not consistently modify all tags in all tables.

Aspen Refinery Multi-Blend

Optimizer
CQ000700818

Refresh Issue – Product Pipeline Related Events

Issue: Product pipeline related events may not display properly after
creating a case or when multiple users are working on these events at the
same time.
Resolution: Save changes and re-open the model to reload the display data
correctly.

Aspen Petroleum Supply Chain

Planner
CQ00764242

PSCP may crash when closing Map Window

Issue: PSC may crash when attempting to close in the following situation:
If changes are made to the map in the Results Window and you attempt to
close PSCP and do not first see the confirmation dialog on saving changes to
the Results Window, the system may crash.
Resolution: After initiating a close command, you must confirm whether or
not to save changes from the Results Window. If you do not see a
confirmation dialog, toggle windows control until the dialog appears.

26 Aspen Petroleum Supply Chain V10 Release Notes