Read Me Document

QuickLinks Web Page Whats New in v6 Extend Product Line Purchasing an Extend Product Training and Technical Support Extend User Forum Contacting Imagine That! Release Notes for Version 6

Plus specic information about:

e The Extend Demo e The LT (Limited) Version e Extend RunTime e Extend Player e RunTime/Player Model Development

(click on a topic)

Extend ReadMe QuickLinks Web Page Find the information you need quickly by visiting our QuickLinks page at www.imaginethatinc.com/quick_links.html. Whether you are new to simulation, new to Extend, or a long-time Extend customer, this page will facilitate your search for general simulation information, product descriptions and features, modeling tips & techniques, etc. Whats New in v6 Please go to www.imaginethatinc.com/prods_features_v6.html to see a list of whats new. Product Line The Extend family of simulation packages includes Extend CP, Extend OR, Extend Industry, and Extend Suite. The model Demo.mox shows you examples of these products. For more information, go to www.imaginethatinc.com/prods_prodline.html Purchasing an Extend Product To purchase additional Extend licenses or to upgrade to a more advanced Extend package, please use the Order Form that was installed on your computer when you installed Extend. You may also download an order form at www.imaginethatinc.com/prods_order.html or contact Imagine That! at 408.365.0305 (USA) or sales@imaginethatinc.com Extend Training and Technical Support The Support menu at www.imaginethatinc.com has product updates, links to training dates and locations, a resource caf for blocks and models, frequently asked questions, and more. You may also contact us with your support or training questions by telephone: 408.365.0305, fax: 408.629.1251, or email: support@imaginethatinc.com Extend User Forum Talk directly to other simulationists in the Extend E-Xchange, the virtual meeting room where you can exchange ideas, discuss simulation techniques, and post issues. Its free! Go to www.extenduser.com Contacting Imagine That, Inc. Dont forget to check the Extend web site www.imaginethatinc.com for up-to-date news and information on Extend...new releases, new or enhanced blocks, sample models from Imagine That! and Extend users, frequently asked questions, shows well be attending, and more. You may also contact us directly at:

Imagine That, Inc. 6830 Via Del Oro, Suite 230 San Jose, CA 95119 USA 408.365.0305 (telephone) 408.629.1251 (fax) extend@imaginethatinc.com www.imaginethatinc.com
page 2

Extend ReadMe Release Notes The following Release Notes reect the differences between the printed documentation and the current release of Extend v6. Changes to the Users Guide O113 The maximum number of attributes per item has been increased from 300 to 500. A11 You can now choose in the Preferences command to save Print Setup information with the model. A20 and E99 The Lock Model command has been enhanced to include password protection. The password is saved with the model; the only way to unlock a password-protected model is to choose the Lock Model command again and enter the password. To password-protect a model, choose the Lock Model command in the Model menu. In the dialog that appears, enter a password into the Enter Password eld and enter it again into the Repeat Password eld. The optional "Lock Hblocks" checkbox in this dialog determines whether or not the hierarchical blocks on the locked model will be openable. If you check this box, double clicking on a hierarchical block in the locked model will not open its worksheet window. To unlock a password-protected model, select the Lock Model command and enter the password. Note: if you locked your model but have forgotten the password, you will NOT be able to unlock the model le. A36 In Appendix B, Upper Limits, the Number of attributes for a discrete event item is 500. A36 In Appendix B, Upper Limits, there should be a line item for the Maximum length of a popup menu, which is 20 strings or 5100 characters. A41 In Appendix C, Cross-Platform Considerations, the last paragraph mentions the MacWin Converter. Use the Tools submenu of the Library menu to access the Converter. A57 In the Discrete Event and Manufacturing libraries we added encapsulated referencing technology for blocks that reference other blocks. This is used in blocks that have "connectionless" connections (Queue Resource Pool, Release Resource Pool, Throw, Catch, statistics and Shift blocks, as well as blocks that use shifts). Choosing this option limits the number of blocks displayed in the search popup. If the search identies duplicate blocks, it only displays the block that is the closest hierarchically. This reduces the number of blocks visible in the popup menu and forces the connectionless connections within a hierarchical block to be local to that hierarchical block. (Many thanks to the folks at Boeing for their suggestions, sample code, and testing of this feature.) A57 We added direct export to Excel for the statistics blocks. Summarized results can now be sent automatically to a new worksheet at the end of every simulation run. A57 We also added a last column is run number option for the statistics blocks.

page 3

Extend ReadMe In27 In the Industry section, step 7 should read: To use the new times you added to the data, click the Select button to choose the Step 1 Time eld in the rst Get Attribute (DB) block and the the Step 2 Time eld in the second Get Attribute (DB) block. In36 In the Industry section, in step 4, the picture of the Get Atribute (DB) dialog is not correct. The picture should show that the Attribute name: Product is associated with the Table Products. In36 In the Industry section, step 8 is missing. It should be: 8. Congure all the Get Attribute (Db) blocks following the Select DE (5) block to read the attribute named Product and the Get Attribute (Db) blocks to their right to read the attribute Step. Congure the Change Attribute block to increment the attribute Step by a value of 1. In37 In the Industry section, change the third paragraph to read: Congure the Change Attribute block (following the Combine (5) block) to increment the "Step" attribute by 1. Then connect the Exit and Write DB blocks you used in Database Tutorial #2 to the bottom output of the Select Output (5) block, as shown in the Tutorial 3 model worksheet on page In34. The model is now complete and ready to run. Changes to the Developers Reference Note for Block Developers The Extend version 6 compiler has many enhancements and optimizations. For optimal performance, we recommend that you recompile any blocks that you built in earlier versions. Before you do this, please note that version 6 is not backward compatible and blocks compiled in v6 cannot be read by earlier versions of Extend. Therefore, we strongly recommend you make backup copies of your libraries before you recompile them in Extend 6. D10 The maximum length of a popup menu increased to 20 strings (5100 characters). D37-39 There are 2 new Message Handlers that send messages to individual blocks: IconViewChange. Sent when the user, or a ModL function call from a block, changes a blocks view or the class of blocks in a model. If the user aborts this message with an abort statement, the change is not made to the view or class. BlockTableInfo. Sent by some of the blocks to query data table size. Not sent by Extend. D170 The function GAPopupMenu now allows any size string array, not just string15.

(continued on the next page)

page 4

Extend ReadMe

The following functions or function descriptions were added after the manual was printed: Function isSimulationPaused() Description Returns I I

Returns a TRUE if the simulation is paused or is about to pause. ListDisposeAll(long Disposes all linked lists in a block. Returns TRUE if blockNum) the block doesnt exist or the lists have already been disposed. OLEDispatchGetDispID Given a function/variable Name, returns the DispID. (long dispHandle, string This function is the same as OLEGetDispID except theName) that it is expecting a DispHandle instead of a block number and dialog item name. OLEObjectIsRegistered Checks to see if a specic CLSID is already regis(string clsid) tered. It returns TRUE if the CLSID is already in the registry and FALSE if it is not. PauseSimForSave() Pauses the current running active model for saving. This allows the user to save the model while paused and enables the Continue Simulation command discussed on page E224, Saving Intermediate Results. Note: The PauseSim function does a pause immediate which is useful for debugging, but will not allow saving the model. The model can be saved by using the Save menu command or the SaveModel() function. ODBCCongData Calls the Windows API SQLCongDataSource() Source(long fRequest, function with the entered arguments string szDriver, string szAttributes) GetDialogItemInfo(long blockNum, string variableNameStr, long which) Returns TRUE if which qualities are true for the dialog item: 1: hidden 2: enabled 3: display only

page 5

Extend ReadMe The following functions were changed after the Developers Reference was printed: Function AppendPopupLabels ListGetDouble ListGetLong ListGetString ListSetDouble ListSetLong ListSetString PlaceBlock Description Now accepts up to 5100 characters. Descriptions are missing the following information: If elementIndex is passed in as a value less than zero, it refers to the current newly created, but not yet added, item. If elementIndex is zero or greater it is used as an index value into the specied list.

Description is missing the following information: If the neighbor eld is lled in with a block number of a block already on the worksheet, then the xPixel, yPixel values are relative to the location of the neighbor. Otherwise if neighbor is -1 (no neighbor) they are absolute worksheet coordinates. RandomCalculate There are additional distribution codes: ExtremeValue1A 20 ExtremeValue1B 21 JohnsonSB 22 JohnsonSU 23 Laplace 24 Rayleigh 25 InverseWeibull 26 Logarithmic 27 Hypergeometric 28 Chisquared 29 PowerFunction 30 RandomCheckParam This function now has more error return codes: -8 Arg1 is negative or less than 1.0e-15 -9 Arg2 is negative or less than 1.0e-15 -10 Arg3 is negative or less than 1.0e-15 -11 Arg1 >= Arg2 -12 Arg1 > 1.0 -13 Arg2 > 1.0 -14 Arg3 > 1.0 UserParameter Description is missing the following information: Displays the prompt string and default string, then returns either the entry typed, or the default string if there was no user entry, or the empty string ("") if Cancel was clicked.

page 6

Extend ReadMe About The Extend Demo The Demo CD is designed for people who want to evaluate the Extend line of products. The CD installs a demonstration version of all the Extend products, manuals in .pdf format, and example models that illustrate the Extend product line: Extend Suite, Extend Industry, Extend OR, and Extend CP. The use of the Extend Demo software is covered by a License Agreement; see the Extend Demo and Player License Agreement for complete terms. The Demo Application The Demo application allows you to explore the features and capabilities of Extend. With the demo you can: e Build models (up to a maximum size of 25 blocks). e Run models of any size (even bigger than 25 blocks). e Change values in block dialogs and view simulation results. e Build and save your own custom blocks. However, you cannot: e Save model changes. e Print worksheets in the demo application. e Access the source code of some of the libraries of blocks. Example Models The le Demo.mox contains a selection of sample models for each Extend product. You can open this le and all the other Extend models using the Open command in the File menu. Example models are designed to help you evaluate Extend. With them you can: e Learn about Extend capabilities such as optimization, hierarchy, built-in authoring environment, activity-based costing, and interacting with Microsoft Ofce and other applications. e Explore additional applications such as Proof Animation (for professional level animation) and Stat::Fit (for distribution tting). These two programs are included in the Extend Suite package for Windows. e Determine which Extend product is right for you: Extend Suite, Extend Industry, Extend OR, or Extend CP. (Note: The Suite and Industry products are only available for Windows operating systems; the Extend OR and Extend CP products are available for either Windows or Macintosh OS.) Extend Manuals The Extend manuals are in .pdf format and are located in the Documentation folder within the Extend folder. The Users Guide provides instruction on how to run and build a model, use the Extend libraries, and more. The Developers Reference is for those who want to modify Extend blocks or build their own blocks. (Note: These les are structured the same as the printed manuals that ship with the full Extend product. Thus, there will be differences between the documentation and the capabilities of the Demo application.)

page 7

Extend ReadMe About the LT (Limited) Version of Extend The LT product is a limited version of the Extend family of simulation packages. It is designed for students doing coursework with Extend, as a companion to a book, or for people who are evaluating Extend and want more capabilities than the Demo application. For Windows the LT is Extend Suite, for Macintosh the LT is Extend OR. The Extend LT Application The LT version has many capabilities. For example, you can: e Build models, up to a maximum size of 75 blocks. e Run models of any size (even bigger than 75 blocks). e Change values and save simulation results. e Build and save your own custom blocks. e Print model worksheets, block dialogs, and so forth. However, there are some limitations: e The models you build are limited to a maximum of 75 blocks. You can, however, run pre-built models of any size. e The LT version expires 180 days after its rst use. e Printed documentation is not included. The LT version includes documentation in .pdf format; you can also purchase printed manuals. e The BPR, Manufacturing, and Industry libraries have their block code protected. However, you have access to the code of the rest of the library blocks. e There is no upgrade path and technical support is limited to installation questions. Example Models The LT version includes numerous sample models designed to help you build models and learn about Extend features and capabilities. e Tutorial models show you how to open, build, run, print and save models. e Other examples allow you to explore Extend capabilities such as optimization, hierarchy, built-in authoring environment, activity-based costing, and interfacing with Microsoft Ofce and other applications. e Example models can also serve as templates for building your own models, supplying pre-built model segments you can copy and paste where wanted. Extend Manuals The LT version includes .pdf manuals located in the Documentation folder within the Extend folder. The Users Guide provides instruction on how to run and build a model, use the Extend libraries, and more. The Developers Reference is for those who want to modify Extend blocks or build their own blocks. (Note: These les are structured the same as the printed manuals that ship with the full Extend product. Thus, there will be differences between the documentation and the capabilities of the LT application.)

page 8

Extend ReadMe About The Extend RunTime Version Extend RunTime allows you to use models that others have built in the full version of Extend. You can install the RunTime version from the Extend CD or from the Extend RunTime CD. The RunTime version is a single-user license, so each customer needs to purchase a serial number to activate their RunTime application. Capabilities of the RunTime Version: e Run models built in the full version and obtain graphical and tabular outputs. e Change parameters (values) in a model and run the changed simulation. e See animation in the model if the model has animation in it and Show Animation is selected in the Run menu. e Import and/or export les and interface through the serial ports, provided the RunTime model has these features. e Print models, dialogs, and so forth. e Save changes made to the model. e RunTime model developers can personalize the RunTime startup screen. Limitations of the RunTime Version: e Models must be developed in the full version of Extend. e You can neither change the models structure nor build your own models. Blocks (the components of the model) can not be added to or removed from the RunTime models nor can connections between the blocks be altered. e You cannot build your own blocks or access the structure and dialog editor of an existing block. Therefore, you cannot modify icons, change a block's programmed behavior, add or delete dialog items, or make other structural changes. e The RunTime application can only read RunTime versions of the Extend libraries. e There is no upgrade path. e Technical support is limited to installation questions. For support or information about the models, please contact the person who developed your models. Additional Information When you received your RunTime models, you may have also received an ex_name.txt le. RunTime model developers can use this le to provide their contact information. If you have it, install the ex_name.txt le into your RunTime folder. When you launch Extend RunTime, the model Developer's contact information will appear in the application's start-up screen. For technical support or information about the RunTime models, please contact your RunTime model Developer. If you develop models for others to use with the RunTime version of Extend, please see the section titled Notes to Developers of RunTime and Player Models.

page 9

Extend ReadMe About the Player Version of Extend Like the Runtime version, the Extend Player allows you to run models that others have built in the full version of Extend and make changes to those models. Unlike the RunTime version, you cannot save your changes or print. The Extend Player is available as a free download from our web site at www.imaginethatinc.com. Capabilities of the Player Version: e Run models built in the full version, and obtain graphical and tabular outputs. e Change parameters (values) in a model and run the changed simulation. e See animation in the model if the model has animation in it and Show Animation is selected in the Run menu. e Import and/or export les and interface through the serial ports, provided the Extend model has these features. The Limitations of the Player Version: e e e e You cannot save changes to the models. You cannot print model worksheets, dialogs, or reports. Models must be developed in the full version of Extend. You can neither change the models structure nor build your own models. Blocks (the components of the model) can not be added to or removed from the models nor can connections between the blocks be altered.

e You cannot build your own blocks or access the structure and dialog editor of an existing block. Therefore, you cannot modify icons, change a block's programmed behavior, add or delete dialog items, and so forth. e The Player application can only read RunTime versions of the Extend libraries. e There is no upgrade path. e Technical support is limited to installation questions. For support or information about the Extend models, please contact the person who developed your models. Licensing Information This Player version of Extend is licensed to you by Imagine That, Inc. and its use is covered by a License Agreement. You may download the Player for free from our web site and use it for your personal use. However, unless you have obtained the prior written consent of Imagine That, Inc. you may not include the Player on a CD-ROM or any other media nor place the Player for direct download from your web site. (You may, however, place a link from your web site to our. web sites location for downloading the Player.) See the Extend Demo and Player License Agreement for complete terms.

page 10

Extend ReadMe Notes to Developers of RunTime and Player Models You may want to share your Extend models with customers or others who do not have the full version of Extend. The Extend RunTime and Player versions are a perfect solution. They allow you to distribute Extend models and libraries to those who do not have Extend. In order to test your libraries and models in the RunTime/Player format, you will need to purchase an Extend RunTime license or download a Player version. You may purchase a RunTime CD or you may purchase a RunTime serial number and install the RunTime les from the CD that installs the full version of Extend. In either case, you need a serial number to activate the RunTime application. Those who use your models will need to purchase their own RunTime license or download the free Player version from the Imagine That! web site at www.imaginethatinc.com. So that other people can run and use your models, you need to convert your custom libraries (if any) to RunTime format, customize the startup screen with your contact information (RunTime only), and deliver your models to the end user. Converting Your Libraries to RunTime Format The RunTime and Player versions require that the libraries used by your models be in RunTime format. The RunTime CD and the Player download include RunTime versions of all of the standard Extend libraries. If you build custom libraries, you will need to convert your libraries to RunTime format so that they are: e Readable by the RunTime or Player versions of Extend. e Unreadable by Extend when running as a full version. (The full version of Extend can open a model that uses RunTime libraries, but Extend will then convert to RunTime mode.) e Protected so that block source code is removed and cannot be accessed. To convert your custom built libraries to RunTime format: e Extend libraries are platform specic. Library conversion must be done on the model users platform. For example, the Windows RunTime version can only read libraries that have been converted to RunTime format on the Windows platform. e In the full version of Extend, choose "Convert to RunTime Library..." in the Tools command of the Library menu. e Select the library for conversion. Extend will make a copy of the library, convert it to RunTime format, and save it in the same location as the original library. e Libraries converted to RunTime format keep the same name as the original, but add the extension .lrx (Windows) or .rt (Macintosh). e Since the name is the same, models you distribute with the RunTime version of Extend will recognize the RunTime libraries as if they were the originals. However, the full version of Extend will not be able to open RunTime libraries unless it is in RunTime mode.

page 11

Extend ReadMe

Customizing the RunTime Startup Screen (RunTime version only) You can customize an Extend RunTime startup screen with up to four lines of text. For example, you can have your name and telephone number appear on the startup screen so that the model user can contact you. To customize the startup screen of a RunTime application that is already installed on your computer, use the RunTime Startup Screen Editor command in the Tools section of the Library menu. To give end users a text le that will display your custom information in the RunTime applications they install on their computers, do the following: e Install a RunTime version of Extend so you can test your customization. e Open either the NotePad accessory (on Windows) or the SimpleText or TeachText application (on Macintosh) and type up to 4 lines of custom text. e Save the le as "ex_name.txt", typed exactly as shown here. e To test the customization, place a copy of the "ex_name.txt" le into your ExtendRunTime folder and launch Extend RunTime. e When the RunTime application is launched, your text will appear on the startup screen and the text le will disappear. (That is why you need to use a copy of the customization le.) e Give the copy of the "ex_name.txt" le to the end user along with your model(s) and custom libraries. The end user will need to purchase an Extend RunTime application to run your model les. e Instruct the end user to install Extend RunTime and copy the "ex_name.txt le into their ExtendRunTime folder. Delivering Your Files and Documentation to the End User As the model developer, it is your responsibility to supply the RunTime or Player user with sufcient information to install and use your models. Please be sure to include the following items: e Your Extend model(s). e Your custom libraries, in RunTime format. e Any extensions required by your models (note that the RunTime CD includes the Extend extensions). e A copy of the ex_name.txt text le you created to customize the RunTime startup screen with your contact details (RunTime only; see above). e Instructions for installing your les and using your model(s).

page 12