Home

SIMPROCESS User`s Manual Appendices

1. a Pl 4 Inverted Weibull Distribution Plot for InW 0 0 1 0 2 0 1 0 8 4 1 0 0 7 0 9 0 8 0 6 g 07 3 gt E gos 06 amp 3 s ll 2 0 4 05 Y 8 amp as 04 amp 035 J 2 4 0 2 0 14 0 1 0 0 0 0 0 0 25 5 0 MEL 10 0 12 5 15 0 S al Petey Tre rete 00 Value PDF CDF x Probability density function and cumulative density function for an inverted Weibull distribution with loca tion 0 scale 1 and shape 2 Syntax InW location scale shape stream The inverted Weibull distribution continuous could be used to model the time required to perform some task The mean and variance are finite only if shape gt 2 If the random variable X has an inverted Weibull distribution with location 0 scale b and shape a then Y 1 X has a Weibull distribution with scale 1 b and shape a The location parameter is 0 Parameter restrictions are scale gt 0 0 and shape gt 0 0 SIMPROCESS User 5 Manual 55 Appendix D Statistical Distributions Johnson Sp Distribution f Johnson SB Distribution Plot for JSB 0 0 1 0 2 0 2 0 1 N H Probability N ao on o2 oa o4 o5 06 07 os 09 1 0 Value PDF CDF Probability density function and cumulative density function for a Johnson Sg distribution with minimum 0 maximum 1 shape1 2 and shape2 2 Syntax JSB minimum
2. SIMPROCESS Users Manual 178 Appendix H Simulation Results File Type of Labels Statistics Descriptions tokentotalborn Only the last Number of entities being value is generated recorded tokentotalalive Only the last Number of entities still value is residing in the system recorded tokentotalkilled Only the last Number of entities value is destroyed recorded UDV delay Observation Statistic of the specified based attribute UDV level Time weighted Statistic of the specified attribute Resources resrccap Time weighted Units of resources i e capacity resrcidle Time weighted Units of idle resources resrcbusy Time weighted Units of busy resources resrcmaintenance Time weighted Units of resources not available Unplanned Downtime resrcdown Time weighted Units of resources not available Planned Downtime resrcreserved Time weighted Units of reserved resources byactivitybusy level Time weighted Units of busy resources at the specified activity byshiftbusy level Time weighted Units of busy resources during the specified shift Connectors SIMPROCESS User s Manual 179 Appendix H Simulation Results File Type of Labels Statistics Descriptions tokentotalin Only the last Number of entities value is entered this connector recorded tokentotalhere Only the las
3. InterruptEntity SequenceNum INTEGER BOOL Interrupts the Entity specified by Receive Transfer STRING EAN SequenceNum The Receive Transform parameter is the name of the Local Receive Transform Activity that will receive the in terrupted Entity Returns TRUE if the interrupt is successful See Method InterruptEntity INTTOBINARY number INTEGER STRING Converts a non negative integer number to a binary string SIMPROCESS User 5 Manual 105 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description g p INTTOSTR number INTEGER STRING Converts an integer number to a string InvokeWebService ContinueOnError BOOLEAN STRING Invokes an operation or method or STRING BOOL on a Web Service See Method WSDL URL STRING EAN InvokeWebService for more Service Name STRING INTE information Service Port Type Name GER STRING REAL or Operation Name STRING ANYOBJ Parameter Values Optional STRING BOOLEAN INTEGER REAL or ANYOBJ LN X REAL REAL Returns the Natural Log of X LOG10 X REAL REAL Returns the base 10 Log of X MapKeyExists Map ANYOBJ BOOL Returns TRUE if the designated Key INTEGER REAL EAN Map contains the specified Key BOOLEAN STRING ANY OBJ MAXOF list of numbers REAL INTE REAL or Returns the maximum number in GER INTE the given list Return type is the all the
4. At moi Diffuse Inspect Reject Import Troubleshooting The table below gives sample error messages from the simprocess log file along with possible causes SIMPROCESS Users Manual 22 Appendix A Importing Version 2 2 1 Models If the error message gives a specific Activity type such as Assemble Batch etc there is usually something missing from the properties for that Activity The errors listed below are the most common The last four are not specific to a particular Activity type If errors persist contact SIMPROCESS Technical Support at simprocess caci com for assistance TABLE 1 Import Errors and Causes Error Cause Error in schedules for Generate Generate1 in imported model Feedback Entity field is blank in a Gener ate schedule Error in Activity properties of Activity Inspect1 in imported model Wafer A Connector or Pad has the same name as the Activity listed 2 2 1 and 2 2 2 only Error in Dummy Connector gt in imported model Wafer A Connector is missing a name 2 2 1 and 2 2 2 only SPDOM selectSingleNode exception javax xml trans form TransformerException misquoted literal expected sin gle quote A name has a single quote Error in Connector Rejects in imported model Wafer Two Connectors have the same name 2 2 1 and 2 2 2 only SIMPROCESS User s Manual 23 Appendix A Importing Version 2 2 1 Models Importin
5. for either argument indicates that the Date Time from the Run Settings should be used for that argument Start and End use the format MM DD YYYY HH MM SS MSEC USEC NSE C The formats MM DD YY and YYYY MM DD can also be used for the date portion of Start and End The Time portion of Start or End can be omitted If omitted midnight is assumed Also if Time is included values for smaller time units can be omitted For example the time portion can just be 08 00 All time values to nanoseconds are not required SIMPROCESS User s Manual 119 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SetStartEnd Name STRING NONE Sets the Start Date Time and or the Start STRING End Date Time of a Generate Activ End STRING ity a specific Entity generation schedule of a Generate Activity the Downtimes of a Resource or a global Resource Downtime Over rides the Start Date Time and End Date Time values specified in those places This method can only be used in the Start Run Expression The Name parameter must be the name of a Generate Activity a Resource modifies all the Down time schedules assigned to the Resource or a global Resource Downtime modifies the Downtime of all Resources assigned to this global Resource Downtime To specify the name of a Generate Schedule use the name of the Gener ate Activity combined with t
6. Method Name Arguments Return Description OpenSpreadsheet Mode STRING OBJECT Open the specified spreadsheet File Name STRING file and return the file stream ob StopOnError Optional ject Mode can be input or out BOOLEAN put The File Name String can contain path names if the user wants to explicitly tell SIMPRO CESS where the file resides If path separators e g on other systems or in Windows are used the program assumes the user is providing a complete and valid file path Ifno path separa tors are detected in the file name the Model s folder is where the files will reside Note that double backslashes must be used in file paths instead of a single back slash When StopOnError is used and is FALSE if an error occurs the System Attribute UNDE FINED is returned and the simu lation is not stopped OUTPUT Takes zero or more arguments NONE Display the specified arguments separated by commas Type in the Output dialog Functions can be REAL BOOLEAN including nested functions that INTEGER or STRING result in any of the argument types can be used in the OUT PUT statement PlotValue Plot OBJECT NONE Adds a data point to the specified Dataset INTEGER Dataset of the plot Datasets are X Value INTEGER or REAL numbered beginning with 0 Y Value Trace only INTE Trace plots require an X Value GER or REAL and a Y Value Histogram plots only use the X Value SIM
7. Method Name Arguments Return Description GetActivityByEnti Activity Name STRING REAL Returns the value of the tyStatistic Entity Name STRING requested Activity Name and Statistic STRING Value Type STRING Replication INTEGER Entity Name statistic Statistic is one of the statistics types for Activities listed in the Labels column of the table in Appendix H See Statistic Types Value Type is either Avg StDev Min Max Count or RunLength The value for Rep lication cannot be larger than the current replication simulating A Replication of 1 returns the aver age of replications and a Replica tion of 2 returns the sum of replications GetArray Value Array OBJECT REAL Returns from the designated Index INTEGER INTE array the value at the specified Index2 INTEGER GER indices Note that the array indi IndexN INTEGER BOOL fee EAN ces are zero based Attempting to STRING get a value from an element of a Ge STRING or ANYOBJ array that OBJECT has had no value assigned will result in an error SIMPROCESS User 5 Manual 94 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description GetAttributeStatistic Attribute Name STRING REAL Returns the value of the Value Type STRING f requested Attribute Name Attri Replication INTEGER bute Name must be unique among the att
8. Probability density function and cumulative density function for a lognormal distribution with mean 2 and standard deviation 1 Syntax Log mean standard deviation stream or LogACM mean standard deviation stream The lognormal distribution could be used to model the time required to perform some task when large values sometimes occur It is always skewed to the right and it has a longer right tail than the gamma or Weibull distributions The lognormal distribution is closely related to the classical normal distribution see the book Simulation Modeling and Analysis Third Edition by Law and Kelton 2000 for details Furthermore the parameters of the lognormal distribution namely mean and standard deviation correspond to the lognormal distribution and are not the mean and standard deviation of the corresponding normal distribution Parameter restrictions are mean gt 0 0 and standard deviation gt 0 0 SIMPROCESS User 5 Manual 46 Appendix D Statistical Distributions Poisson Distribution o b fe 35 40 Value PDF CDF iS r Al lt gt OOOO O Plot for Poi 2 0 1 0 275 10 0 250 0 9 0 225 ain Sja 0 200 a7 17 f z 0 175 a 5 0 150 5 a 0 5 y 0 125 3 0 100 ga 0 075 o3 F 0 050 0 2 Poisson distribution with mean 2 Syntax Poi mean stream or PoiACM mean stream The Poisson distribution discrete with mean m is the di
9. REALTOSTR realnum Or to display it in the status bar STATUS Number of orders currently held in Gatel0 is Num berIn where the expressions above are placed on the Activity Gate10 Method UpdateDashboardLabel To use this method you need to assign a Dashboard to your model which contains a TextLabel To assign Dashboards refer to Assigning Dashboards Five arguments are required for this method The first is Dashboard Name This is the name used when you assigned the Dashboard to your model You may also use the name of the Dashboard s file without any path and without the spd extension although this is not recommended since it negatively impacts performance The second argument is the Host or IP Address where a Dashboard Server is expected to be receiving messages for the assigned Dashboard This value must match the one entered when the Dashboard was assigned It is important to note that SIMPROCESS compares the values and not their meanings While localhost and127 0 0 1 refer to the same system i e they have the same meaning they are not the same values to SIMPROCESS The third argument is the port on which a Dashboard Server is expected to be receiving messages for the assigned Dashboard This value must also match the one entered when the Dashboard was assigned The fourth argument is the name of a Graph on the assigned Dashboard of type TextLabel The name is anuneditable field displayed on th
10. Value Type is either Avg StDev Min Max Count or RunLength A Replication of 1 returns the aver age of replications and a Replica tion of 2 returns the sum of replications Value Type STRING Replication INTEGER GetConnectorByEn Connector Name STRING REAL Returns the value of the tityStatistic Entity Name STRING Statistic STRING Value Type STRING Replication INTEGER requested Connector Name and Entity Name statistic Statistic is one of the statistics types for Connectors listed in the Labels column of the table in Appendix H See Statistic Types Value Type is either Avg StDev Min Max Count or RunLength The value for Rep lication cannot be larger than the current replication simulating A Replication of 1 returns the aver age of replications and a Replica tion of 2 returns the sum of replications SIMPROCESS User 5 Manual 96 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description GetCostStatistic Period Name STRING REAL Returns the value of the Cost Object 1 STRING Cost Object 2 STRING Cost Object 3 Optional requested Period Name Cost Object 1 Cost Object 2 and optionally Cost Object 3 Cost STRING Cost Type STRING Object 1 can be the name of a Value Type STRING Resource an Activity or an Org
11. 07 gt 0 200 2 06 amp 5 0 175 5 pej 8 0 150 E a e amp 0 125 04 E T 0 100 HE 0 075 0 2 0 050 0 025 C 0 1 0 000 J z 0 0 00 os 10 15 20 25 30 35 40 45 50 Value PDF CDF L 4 Probability density function and cumulative density function for a binomial distribution with trials 5 and probability 0 5 Syntax Bin trials probability stream or BinACM trials probability stream The binomial distribution discrete with parameters trials t a positive integer and probability p can be thought of as the distribution of the number of successes in t independent Bernoulli trials where success occurs on each trial with a probability of p and failure occurs on each trial with a probability of 1 p A binomial distribution with trials 1 is called a Bernoulli distribution with probability p SIMPROCESS User 5 Manual 52 Appendix D Statistical Distributions Negative Binomial Distribution Negative Binomial Distribution th i Plot for NgB 5 0 5 1 0 14 o p o o f H H f w i So oa 073 30 09 E 0 08 06 amp o 0 07 05 9 0 06 3 5 0 05 Oe 0 04 oF 0 03 02 0 02 0 01 0 1 0 00 0 MAn n mea 0 0 a tah ee ke ee ee tere Te a l E e o e b E i S i als I aa Value PDF CDF L nO T 7 Probability density fu
12. Parameter Name STRING Parameter Value STRING BOOLEAN INTEGER REAL SQRT X REAL REAL Returns the square root of X STATUS Same as OUTPUT NONE Display the specified arguments in status bar StopSimulation NONE NONE Completely stops a running simu lation Any remaining replica tions are not simulated STRLEN inString STRING INTE Returns the length of the string GER inString SIMPROCESS User 5 Manual 122 Appendix F SIMPROCESS System Attributes and Methods Method Name SIMPROCESS System Methods Arguments Return Description STRTOINT inString STRING INTE GER Converts a string consisting only of numbers with no decimal in the string to an integer STRTOREAL inString STRING REAL Converts a string of numbers in cluding a decimal to a real SUBSTR positionl position2 INTE GER String STRING STRING Returns the substring of String from position to position2 in clusive Note that the first posi tion is 1 instead of 0 SystemTime None Returns the current system time in milliseconds as the difference between the current time and midnight 1 Jan 1970 UTC TAN X REAL Returns the TANgent of X TimeOfDay Timeunit Optional STRING Valid time units are Years Months Weeks Days Hours Minutes Seconds Milliseconds Microseconds Nanoseconds Time unit strings are case sensitive Returns the current time of da
13. Replication INTEGER Model Cost Object 2 can be the name ofan Activity an Entity or an Org Node Cost Object 3 is only used when requesting an Org Node by Resource cost Thus the combination of Cost Object 1 and Cost Object 2 can be Resource and Entity Resource and Activity Activ ity and Entity or OrgModel and Org Node If Cost Object 1 is an OrgModel name Cost Object 2 must be an Org Node name and Cost Object 3 must be a Resource name Cost Type options are Variable or Absorption Value Type is either Avg StDev Min or Max for Replication 1 If Repli cation is 1 or greater the maxi mum value is returned no matter what is entered for Value Type A Replication of 1 returns the aver age of replications and a Replica tion of 2 returns the sum of replications SIMPROCESS User 5 Manual 97 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description GetEntity Gate Resource or Entity OBJECT Returns a reference to the Entity OBJECT being held at the specified Gate Index INTEGER Activity waiting for the speci fied Resource or being held as part of the specified Entity s batch Index indicates the posi tion in the appropriate queue and must be greater than or equal to 1 and less than or equal to the number of Entities being held at the Gate activity obtained b
14. SIMPROCESS System Attributes Attribute Name Attribute Type Description System Level Model Get OBJECT Reference of the Model being simu lated Self Get OBJECT Reference of the Model Element itself Background Get BOOLEAN TRUE if the model is being simulated without the GUI FilePath Get STRING Complete file path to the model s directory including the trailing sep arator Replication Get INTEGER Current replication number UNDEFINED Get OBJECT Returns an undefined object Entity Type Name Get STRING Name of the Entity Priority Both INTEGER Default priority for Entity instances of this type NumberIn Get INTEGER Number of Entity instances of this type currently in the system NumberCreated Get INTEGER Number of Entity instances generated for this type NumberDisposed Get INTEGER Number of disposed Entity instances of this type Number Waiting Get INTEGER Number of Entity instances of this type waiting for resources NumberOnHold Get INTEGER Number of Entity instances of this type holding for condition SIMPROCESS User s Manual 71 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Attributes Model Elements Attribute Name Get Attribute Description Set Type Interrupt Both BOOLEAN Determines whether Entity instances of this type will interrupt
15. SIMPROCESS System Attributes and Methods sIMPROCESS Expression Input Enter INTEGER value for variable MylInteger OK Cancel SIMPROCESS Expression Input Enter REAL value for variable MyReal Lok Cancel Method INPUT INPUT prompts the user for a single variable input The variable must be a locally defined variable user defined Attribute or System Attribute with type Set or Both Unlike READ INPUT allows the user to include their own message For example assume the Entity Attribute NextPath is an INTEGER Attribute INPUT Enter a value from 1 to 5 Entity NextPath The above example will provide an input prompt requesting the user to input an Integer value for Entity NextPath Type checking is done on the value entered to ensure the values are compatible Only enter an Integer if the variable is type INTEGER If the value is not compatible an error is displayed and anew value must be entered In the example above the message says that the value should be between and 5 The INPUT statement will not validate that the value is within that range It will only validate that the entered value is an INTEGER If an empty String is used for the message a default message will display There is also an option to stop the simulation Below is how the above example displays Input for Entity NextPath x Enter a value from 1 to 5 Entered value must be
16. the fit is rejected IID Identically and independently distributed In simulation identical means that observations are made from a hypothesized distribution of values that does not change over simulated time Independent means that observations of one replication are not correlated with other observations i e if one observation has a value of X then the next observation is probably close to X Image Editor An editor that contains graphs tables or text for viewing the results of a statistical analysis Integer valued Domain A domain whose range is the set of integer numbers KS Acronym for Kolmogorov Smirnov KS goodness of fit test A goodness of fit test that uses the D statistic to evaluate the goodness of fit The KS goodness of fit test creates an empirical distribution for the data The empirical distribution assigns a probability of 1 N to each data point where N is number of data points in the data set The D statistic is computed as the maximum difference between the cumulative distribution function of the empirical distribution and the cumulative distribution function of the probability distribution being tested SIMPROCESS User s Manual 66 Appendix E Statistical Tools Glossary Kurtosis Characterizes the relative peakedness or flatness of a distribution relative to the normal distribution A data set with positive kurtosis has a sharper peak than a normal distribution while a data set with negative k
17. Arguments Return Description g p Attribute AttributeName STRING OBJECT DEPRECATED Use GetAt tributeValue and SetAt tributeValue instead Returns the reference to the specified Attri bute AttributeName follows the same convention as specifying Attributes in Expressions That is qualifiers Entity Entity Type and Model might be required be fore the Attribute name such as Entity StartTime The object owning the Attribute can be spec ified by including a colon and the name of the object in At tributeName For example Attri bute Time Dispose1l would return the Attribute named Time from the Activity Disposel The object reference can be an Entity Type Resource or Activity Note that using the object name is the only way to retrieve Resource Attributes BasicDateTime None STRING Returns the current date and time of the simulation in MM DD YYYY HH MM SS for mat Beep MasterEditor NONE Makes a beep sound BINARYTOINT Binary Value STRING INTE Returns the integer value of a bi GER nary string BREAKPOINT None NONE Suspends simulation and displays simulation status See Method BREAKPOINT CEIL X REAL INTE Returns the smallest integer not GER less than X SIMPROCESS User s Manual 82 Appendix F SIMPROCESS System Attributes and Methods Method Name SIMPROCESS System Methods Arguments Return Description ChangeColor ActName STRING
18. RealVal BoolVal Write to the file as SIMPROCESS User s Manual 132 Appendix F SIMPROCESS System Attributes and Methods This is a test for ReadFromFile 123 67 89 TRUE CloseFile closes the file the IOStream pointed to CloseFile IOStream For example CloseFile Model MyOutStream CloseFile Model MyinStream Close the files myoutput dat andmyinput dat respectively Typically you will place CloseFile in the End Trial Expression especially if you put OpenFile in the Start Trial Expression Method READ READ prompts the user for a single variable input Also see Method INPUT The variable must be a locally defined variable i e a system attribute or a user defined attribute such as a Model Activity Resource or Entity attribute cannot be referenced directly Example MyInteger INTEGER MyREAL REAL READ MyInteger READ MyREAL The above example will provide an input prompt requesting the user to input an Integer value for MyInteger and the next read statement will prompt the user to input a REAL value for MyREAL Type checking is done on the values entered so the user should make sure the values are compatible i e don t enter hello dolly when prompted to enter an integer If the value is not compatible an error exception is thrown and the simulation stops The prompts for the above example would look as follows SIMPROCESS User 5 Manual 133 Appendix F
19. SetActivityExpres ActivityName STRING NONE Applies SIMPROCESS Expres sion ExpressionType STRING sion code in the specified Expres Expression STRING sion parameter to the specified Activity This method can only be used in the Start Run Ex pression Define Model Expres sions or Define Model Expressions button on the Model Toolbar ExpressionType is case sensitive must be valid for the type of Ac tivity specified The Expression parameter should be the complete Expression code in a single STRING or the complete file name with no path of the file that contains the Expression code If the Expression parameter is a file the file must located in the mod el s directory SetArray Value Array OBJECT NONE Sets the value at the specified in Index1 INTEGER dices of the specified array Note Index2 INTEGER that the indices are zero based IndexN INTEGER Value REAL INTEGER BOOLEAN STRING or OB JECT SIMPROCESS Users Manual 113 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SetAttributeValue AttributeName STRING NONE Sets the value of the specified At Value REAL INTEGER tribute AttributeName follows BOOLEAN STRING or OB the same convention as specify JECT ing Attributes in Expressions That is qualifiers Entity Enti ty Type and Model might be re quired before the Attribute name such as Entity
20. be adjusted left or right by clicking and dragging SIMPROCESS Users Manual 159 Appendix F SIMPROCESS System Attributes and Methods END IF IF ActivatedByTrigger AND NumberIr a Expression Model Attributes Entity Types All Entity Types Resources Activities Connectors i NumberCreated NumberDisposed NumberOnHold Interrupt Next Statement All Entity Types lists all the defined Entity Types along with the number of instances of each type currently in the simulation At the end it gives the total number of Entities in the simulation SIMPROCESS User s Manual 160 Appendix F SIMPROCESS System Attributes and Methods IF ActivatedByTrigger AND NumberIr a Expression Model Attributes Entity Types EXD IF co Product SUPPLIES 1 SUPPLIES 2 SUPPLIES 3 Trigger Triggert Trigger2 Trigger3 Total Entity Count ROO ON S R s ojloln ojojo N The Resources tab displays the model Resource tree Selecting a Resource displays the user defined and system attributes for the selected Resource SIMPROCESS Users Manual 161 Appendix F SIMPROCESS System Attributes and Methods Po OC oe Se A te ge Pee oe ee E BREAKPOINT Analyzer 1 i IF ActivatedByTrigger AND Numberl a Expression Model A
21. continuous could be used to model the time required to perform some task If a gamma distribution has parameters mean m and shape a then b m a is a scale parameter A gamma distribution with mean m and shape is an exponential distribution with mean m When shape is a positive integer the gamma distribution is an Erlang distribution Parameter restrictions are mean gt 0 0 and 0 0 lt shape lt 100 0 SIMPROCESS User 5 Manual 42 Appendix D Statistical Distributions Beta Distribution m gt gt Beta Distribution Plot for Bet 1 5 5 0 0 0 1 0 1 2 75 a 2 50 0 9 2 25 0 2 2 8 A 2 00 07 3 E 2175 o6 amp 3 1 50 3 2 O59 hee mJ 1 25 048 1 00 3 T 0 75 mar 0 50 0 2 0 25 0 1 0 00 0 0 0 0 0 1 0 2 0 3 0 4 05 0 6 0 7 0 8 0 9 1 0 Value PDF CDF E d Probability density function and cumulative density function for a beta distribution with shape1 1 5 shape2 5 0 minimum 0 0 and maximum 1 0 Syntax Bet shapel shape2 minimum maximum stream or BetACM shape1 shape2 minimum maximum stream The beta distribution continuous could be used to model the time required to perform some task when the possible values are restricted to the finite interval minimum maximum minimum gt 0 0 maximum gt 1 0 and maximum gt minimum Parameter restrictions for shapel and shape2 are shapel gt 0 0 and
22. 2 Any processalternative Processname Alternativename Ifthe process is a Master Process Master Processes the specified alternative for the Master Process will be applied to all copies Number of replications Replications 5 Design for committing the results to the SIMPROCESS database Design My Design Scenario for committing the results to the SIMPROCESS database must be used if Design is used Scenario My Scenario Option to save the model after the parameters are set thus the next time the model is opened in SIMPROCESS the model parameters set by command line or properties file retain their latest value Save True the absence of this option is equivalent to Save False Can set the starting and or ending date and time of the model Absence of the time portion indicates midnight Start 1 1 2005 End 1 1 2006 08 00 00 Note Design and Scenario should not be used on Linux since the SIMPROCESS database is an Access database and is not available for Linux systems Also Design and Scenario should not be used on Windows if MS Access is not installed Setting Options on Command Line Any parameters to be set must follow the model on the command line For example SPRunSimulation C Program Files SIMPROCESS models Demos Purchasing spm Model NumProdAPersonnel 6 Model NumProdBPersonnel 4 Purchasing Centralized Functional Replications 2 Design 2 Reps Scenario Scenario 1 Save True Parameters that have s
23. 51 Binomial Distribution ccssssssssssccscsssssssssccscsssssssssscceseseees 52 Negative Binomial Distribution csscccssscscsscsscssescesseees 53 Inverse Gaussian Distribution cccccssssssssssssccsscssssssseceeees 54 InVeErted WElDUMl crcsisceicseccdendesicsisvesdensccssceseessossesecssocssenesVexseesessses 55 Johnson SB Distribution ssccccccscssssssssssscccscssssssssscessesees 56 Johnson SU Distribution sccccccccscssssssssssscccscssssssssscessseees 57 Log Logistic Distribution ccsccccsccccsssccccsscsccsssccesssscesseees 58 Log Laplace Distribution csscccsscccssscccsscssssssccssssscesseees 59 Pearson Type V Distribution c sscccssscccscscessesccsssscssseees 60 Pearson Type VI Distribution ccssscscscscssscscsssescessesees 61 Random Walk Distribution cccccssssssssssssscccssssssssccesees 62 Empirical Distribution 6 005 lt sssvsssvsnsssessssovacsdaraessserssveresecteonsceactecss 63 Appendix E Statistical Tools GIoSSArY sssssssssssssooessoossssoosessoosessossesooecsooosesseseso 64 Appendix F SIMPROCESS System Attributes and Methods ssccsseeeees 70 System Attributes oe ssiccss scstssecctencecsvcnustescocevensnasences tenonssenedeecsncsenas 71 STIMPROCESS System Methods csscccsssccsssseccssescssseseees 81 System Method Examples scccsssccssssccsssecsscssescsssesees
24. 9 ES 0 75 o u Aqigegoid aaneinuns So w 0 50 4 o 8 0 25 9 Hn 0 00 4 So Value PDF CDF 4 Probability density function and cumulative density function for a PertBeta distribution with minimum 1 mode 5 maximum 10 and lambda 4 Syntax Per minimum mode maximum lambda stream The PertBeta distribution continuous can be used instead of the triangular distribution as a model for the time required to perform some task The distribution produces a smooth curve and takes on values in the finite interval minimum maximum minimum gt 0 0 mode gt minimum and maximum gt mode with values near the mode being most likely to occur Subjective estimates of the three parameters are obtained from subject matter experts The mean of a PertBeta distribution is only equal to the mode when the distribution is symmetric The lambda parameter is optional and defaults to 4 SIMPROCESS User 5 Manual 40 Appendix D Statistical Distributions Exponential Distribution f Exponential Distribution e Plot for Exp 1 0 1 Probability 5 o9 o o o N wW p5 uo a Aqiqeqoud apenn 9 ry kad 0 0 o5 10 15 20 25 3 0 35 4 0 45 Value PDF CDF E A Probability density function and cumulative density function for an exponential distribution with mean 1 Syntax Exp me
25. A string containing the Service Name to be invoked as given in the WSDL file In a typical WSDL file there will be a lt service gt element it may optionally be name space qualified see note 1 near the end of the WSDL file with a name attribute that will provide the value to use here e Service Port Type Name A string containing the name of the service s port type This will appear in a lt port gt element that is a child of the lt service gt element above and the name attribute there will provide the service port name Body namespace URI A string containing the URI used for the body namespace Note that this is a URI nota URL A URI can be a URL or it can be an identifier of another sort It could be a string such as urn foo or perhaps dispatcher wsd as is the case in our Dis patcherService WSDL file In a typical WSDL file it can be found on the root element s targetNamespace attribute or the xmlns tns attribute often in both Though every WSDL will likely provide a value it will not always be critical to successfully invoking the service method however It s best to provide it just to be certain SIMPROCESS User 5 Manual 147 Appendix F SIMPROCESS System Attributes and Methods e Method namespace URI A string containing the namespace URI of the method operation to be invoked The lt port gt element mentioned above see the Service Port Type Name parameter will include a b
26. Appendix D Statistical Distributions Triangular Distribution 5 P Triangular Distribution ax Plot for Tri 2 0 6 0 8 0 1 0 325 ue 0 300 0 9 zl 0 275 0 8 0 250 2 0 225 Die ae E 0 200 0 6 amp ieee 8 0 175 05 9 E 0 150 ge 0 125 04 S 0 100 o3 f 0 075 0 2 0 050 0 025 0 1 0 000 5 0 0 20 25 30 35 40 45 50 55 60 65 70 75 80 Value PDF CDF Probability density function and cumulative density function for a triangular distribution with minimum 2 mode 6 and maximum 8 Syntax Tri minimum mode maximum stream or TriACM minimum mode maximum stream The triangular distribution continuous is typically used as a rough model for the time required to perform some task when no real world data are available A triangular distribution takes on values in the finite interval minimum maximum minimum gt 0 0 mode gt minimum and maximum gt mode with values near the mode being most likely to occur Subjective estimates of the three parameters are obtained from subject matter experts The mean ofa triangular distribution is only equal to the mode when the distribution is symmetric SIMPROCESS User 5 Manual 39 Appendix D Statistical Distributions PertBeta Distribution rc pl PertBeta Distribution Plot for Per 1 0 5 0 10 0 4 0 1 m J i So 8 Ny o o a 1 00 Probability
27. D Statistical Distributions Random Walk Distribution r SS a gt 4 Random Walk Distribution _ h So Plot for RnW 0 0 1 0 3 0 1 0 75 ne 0 70 0 65 0 9 0 60 8 0 55 2 0 50 07 3 gt E 20s 06 amp 5 0 40 5 2035 0 5 7 g 0 30 04 g 0 25 0 20 03g 0 15 0 2 0 10 at 0 05 0 00 4 gt 9 9 06 05 10 45 gt 20 25 aa as 40 45 Sar SS Ba Value PDF CDF g m Probability density function and cumulative density function for a random walk distribution with location 0 scale 1 and shape 3 Syntax RnW location scale shape stream The random walk distribution continuous could be used to model the time required to perform some task Parameter restrictions are scale gt 0 0 and shape gt 0 0 SIMPROCESS User 5 Manual 62 Appendix D Statistical Distributions Empirical Distribution G yy Tabular Distribution Plot for AutoFit1 E E i 7 SS 1 0 0 175 4 0 9 0 150 Ea S 0 125 0 7 z Eg 06 amp 9 0 100 8 4a 05 9 2 3 amp 0 075 o4 SF E 0 050 4 0 3 2 02 0 025 0 1 0 000 J lo 0 J Ge G7 5 en OLR 7 n gt a LG Value PDF CDF S 4 Empirical distributions are not found on the SIMPROCESS distribution list An empirical distribution can only be created by an Auto Fit dist
28. E E E E E PO 10 0 9 0 9 0 8 08 g is 0 07 3 E 0 6 0 6 2 i 5 A oO 995 05 Y f 3 20 4 04 g Z 0 3 03 F 0 2 0 2 0 1 0 1 i 0 0 0 0 MAAA A S A a S A a a e145 wie iz eon conor Value PDF CDF E i Probability density function and cumulative density function for a log Laplace distribution with location 0 scale 1 and shape 2 Syntax LLp location scale shape stream The log Laplace distribution continuous could be used to model the time required to perform some task The mean and variance are finite only if shape gt 2 Parameter restrictions are scale gt 0 0 and shape gt 0 0 SIMPROCESS User 5 Manual 59 Appendix D Statistical Distributions Pearson Type V Distribution la gt Pearson Type V Distribution Plot for PT5 0 0 1 0 2 0 1 13 1 0 1 2 0 9 sala 0 8 1 0 2 0 9 MHZ Z ss E 08 0 6 2 o7 a fe 0 7 0 5 y 06 3 0 5 04 S 0 5 amp oi o3 F 0 3 0 2 0 2 0 1 0 1 0 0 gt etl D2 a aS ez e Stones As ie iz ib i9 20 21 Value PDF CDF Probability density function and cumulative density function for a Pearson type V distribution with location 0 scale 1 and shape 2 Syntax PT5 location scale shape stream The Pearson type V distribution continuous could be used to model the time required to perform some task The mean and varianc
29. GetEntityBySequenceNum 42 IF entity lt gt UNDEFINED AND NOT entity InBatch IF entity Processing status InterruptEntity 42 Transfer1 END IF END IF SIMPROCESS User 5 Manual 166 Appendix F SIMPROCESS System Attributes and Methods Method InterruptActivity Interrupts the Activity or Activities if multiple Activities have the same name specified by Activity Name If no Entity State parameters are specified or an Entity State parameter is All Entities processing waiting for Resources or holding for a condition are interrupted The Receive Transform parameter isthe name ofthe Local Receive Transform Activity that willreceive the interrupted Entities See Transfer Activity for information on the Transfer Activity Returns the number of Entities interrupted See InterruptDemo spm in the ExpressionDemos directory Entities are interrupted according to the same rules as InterruptEntity However there are no runtime errors due to Entities already interrupted because of Resource downtime or Entity preemption Entities in these states are simply ignored Entities are interrupted in the reverse order that they entered the Activity This is so Entities waiting for Resources do not attempt to obtain Resources when those Entities processing with Resources are interrupted Thus Entities waiting for Resources are interrupted before Entities that are processing Up to two Entity State parameters ma
30. GetFromMap RemoveFromMap ClearMap GetMapKey GetMapSize These methods areused to createand manipulate hashmaps CreateMap creates ahashmap that stores REAL INTEGER BOOLEAN STRING or ANYOBJ values PutinMap places a keyed value into a hashmap The key can be of type REAL INTEGER BOOLEAN STRING or ANY OBJ The value must match the type used in CreateMap GetFromMap retrieves a value froma hashmap without removing the value from the hashmap RemoveFromMap retrieves a value from a hashmap and removes the value andits key from the hashmap ClearMapremovesall values from the hashmap along with their associated keys GetMapSize and GetMapKey are usually used when iterating through a map An Attribute with a Mode of Object must be defined to create a hashmap For example assume there is a Model Attribute named Map with Mode Object with Do Not Reset Before Each Replication selected The following statement should go in the Start Run Expression of the Model Expressions Model Map CreateMap ANYOBJ This creates a hashmap that will store any type of object Use PutinMap to place values in the hashmap Forinstance assume that there are several activities that will needto bereferenced throughout the model Certain decision points will required knowledge of how many entities are currently in these activities The following could go into the Start Simulation expression of each activity PutInMap Model Map Name Self This places each
31. INTEGER Cancel Stop Simulation Note that appended to the message is a reminder to enter an INTEGER A similar reminder is added SIMPROCESS User 5 Manual 134 Appendix F SIMPROCESS System Attributes and Methods when the variable is type REAL If the variable is type STRING no validation occurs If the variable is type BOOLEAN only the selection of True or False is offered Input for ContinueProcessing mo z Continue manufacturing process Trug Irug Cancel Method HALT HALT terminates the current replication or simulation When used with no parameters the current replication is ended and the next replication begins This is similar to using the Maximum Entity Count on the Dispose Activity HALT with parameters terminates the simulation in an error condition The value of the parameters are displayed in an error dialog This statementis useful for debugging and stopping simulations at certain conditions in the model when developing a complex model You may prefer the use of OUTPUT and ALERT statements to notify you of happenings in the model but the HALT is there if you need it Example HALT ends current replication HALT Encountered error in Delay5 terminates simulation Method RemoteCall RemoteCal11 is aplug in capability that can be licensed separately from CACI to allow users to make calls to external applications from within the expression scripts ofa SIMP
32. Integer value must be entered for a Variable with type INTEGER Location to display the dialog is optional The Location must be one of the major points on the compass N S E W NE NW SE SW or center C If no Location is spec ified the dialog will be centered SIMPROCESS User s Manual 104 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description InterruptActivity Activity Name STRING INTE Interrupts the Activity or Activi Receive Transfer STRING GER ties if multiple Activities have the Entity State Optional same name specified by Activity STRING Name If no Entity State parame Entity State Optional ters are specified or an Entity STRING State parameter is All Entities processing waiting for Resourc es or holding for a condition are interrupted Entities that are al ready interrupted due to Resource downtime or Entity preemption are not affected The Receive Transform parameter is the name of the Local Receive Transform Activity that will receive the in terrupted Entities Up to two En tity State parameters may be specified Allowable values are All Processing Waiting ForResource or Holding ForCondition If the specified Activity is a Process all Activi ties within the Process are inter rupted Returns the number of Entities interrupted See Meth od InterruptActivity
33. Model MyClass returnNothing Note that the method does not return a value return type is void so the function must be assigned to a BOOLEAN variable Also this example uses a previously instantiated class stored in the Model Attribute MyClass Method ActivateGenerate ActivateGenerate starts the generation of Entities by a Generate Activity For this method to work correctly the Generate Activity must not be active This is accomplished by setting the start date Start End tab to a date that is past the end date of the simulation For instance if the simulation is scheduled to end on 1 1 2005 then the start date of the Generate Activity must be 1 1 2005 or later Note that this is the start date of the Generate Activity not the start date ofa particular schedule within the Generate Activity When the appropriate conditions are met in the simulation for the Generate Activity to start issue the command along with the name of the Generate Activity It is important that the name of the Generate Activity be unique ActivateGenerate Generate2 TheExpressionDemos directory hasasamplemodelnamedActivateGenerate spm Ifthis directory is not part of the SIMPROCESS model1s directory it can be downloaded at www simprocess com Methods ReleaseEntity Gate GetEntity EntityExists These methods are used in conjunction with Gate Activities ReleaseEntity is used to release a specific Entity that is being held at a Gate Activity
34. NumberCreated NumberDisposed NumberWaiting NumberOnHold Interrupt Activity Information Name Build Shipment 2 HasParent Parent Entity NumberAccepted NumberReleased NumberWaiting NumberOnHold EE EEE Tee a Bam a Ta a mas net De as Dae E E a LastDelay ActivatedByTrigger gt AutoRelCount a LAutoRelease true Nex Statement Next BREAKPOINT Finish Expression Disable BREAKPOINTS Stop Simulation Line 2 The Model Attributes tab displays the status of all model attributes SIMPROCESS User s Manual 158 Appendix F SIMPROCESS System Attributes and Methods ereacont se a as z IF ActivatedByTrigger AND NunberIr a Expression Model Attributes Entity Types Resources Activities Connectors Attribute Value ao 1 AvgMilesPerHour 45 0 lt uua r Next Statement Next BREAKPOINT Finish Expression Disable BREAKPOINTS Stop Simulation Line 2 The Entity Types tab lists all the Entity Types defined in the model along with an extra entry called All Entity Types Selecting an Entity Type displays all the user defined and system attributes for that selection Note that this tab and all remaining tabs contain a divider between the items to select on the left and the table with the selected information on the right Again as with the main divider it can
35. Resource Name Get STRING Name of the Resource Activity Get OBJECT Reference of Activity currently trying to assign or free this Resource if any Capacity Get REAL Resource capacity Entity Get OBJECT Reference of current Entity instance being processed by the Activity trying to assign this Resource if any LastDowntime Get REAL Duration of most recently initiated downtime NumberWaiting Get INTEGER Number of Entities waiting for this Resource StartDowntime Get REAL Time most recently initiated down time started UnitsBusy Get REAL Number of units of the Resource in busy state UnitsDown Get REAL Number of units of the Resource not available because of the application of a downtime UnitsIdle Get REAL Number of units of the Resource in idle state Connector Name Get STRING Name of the Connector NumberAccepted Get INTEGER Number of Entities so far entered the Connector NumberReleased Get INTEGER Number of Entities exited the Con nector NumberIn Get INTEGER Number of Entities currently on the Connector LastDelay Get REAL The value most recently initiated delay SIMPROCESS User 5 Manual 74 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Attributes Model Elements Attribute Name Get Attribute Description Set Type NextDelay Set REAL Change the value of the next delay ONLY AllFutureDela
36. client code such as the RemoteCall in SIMPROCESS to do a lookup and find the server by a name that was binded to the actual server class that is running on the remote server The Java code is as follows package com caci demo import java rmi import java rmi server import ptolemy plot import ptolemy plot plotml SIMPROCESS User s Manual 138 Appendix F SIMPROCESS System Attributes and Methods public class SPServerDemoServer public static void main String args try System out printin Constructing Server implementations SPServerDemoImpl d1 new SPServerDemoImpl1 System out println Binding server implementations to registry Naming rebind serverdemo dl System out println Waiting for invocations from clients catch Exception e System out println Error e SPPlotDemo java defines the plotting class that is instantiated in the SPServerDemoImp1 java class The Java code is as follows package com caci demo import ptolemy plot import java awt GridBagLayout import java awt GridBagConstraints SIMPROCESS Users Manual 139 Appendix F SIMPROCESS System Attributes and Methods import javax swing JFrame public class SPPlotDemo extends JFrame Plot myPlot null boolean first true SPPlotDemo String yLabel String xLabel Instantiate the plot myPlot new Plot Set the size of the toplevel window t
37. debugging There are many instances when it may be useful to pause the model to check the status of the simulation but primarily BREAKPOINT statements can be used to e Catch model anomalies e Verify Expression operation The first example below used to explain the dialog tabs shows using a BREAKPOINT statement to catch a model anomaly In this particular portion of the model order fulfillments are held in Gate Activities until a truck is available Trucks leave every 12 hours and there should always be fulfilled orders waiting for shipment A problem with the model is indicated if a truck arrives and there are no orders waiting to be shipped 2or gt ops 20 Dispatch Truck a gt f Build Shipment 2 Q _ eS Build Shipment 1 The truck arriving is modeled by an Entity that is generated every 12 hours This Entity and its clone are sent to the Trigger pads of the Gate Activities Since the Gate Activity ignores a trigger if there are no Entities in the Gate SIMPROCESS will not indicate that there is a problem with the model that is there are no orders waiting to be shipped when the truck arrives However placing the following Expression is in the Accept Entity Expression of each Gate Activity allows this problem to be immediately indentified if it occurs IF ActivatedByTrigger AND NumberIn 1 BREAKPOINT END IF This Expression checks to see if the Entity entering the Gate is entering by the Trigger pad a
38. distribution discrete with probability p can be thought of as the distribution of the number of failures before the first success in a sequence of independent Bernoulli trials where success occurs on each trial with a probability of p and failure occurs on each trial with a probability of 1 p SIMPROCESS User 5 Manual 50 Appendix D Statistical Distributions Pareto Distribution gt S Pareto Distribution _ eo Plot for Par 1 0 2 0 1 2 00 4 1 0 0 9 1 75 0 8 Q 1 50 075 3 2 1 25 o6 amp 5 3 1 00 O59 3 3 a 0 4 0 75 e 03 F 0 50 0 2 0 25 0 1 he 7 0 0 10 15 20 25 30 35 40 45 50 SS 60 65 70 Value PDF CDF E I Probability density function and cumulative density function for a Pareto distribution with location 1 and shape 2 Syntax Par location shape stream The Pareto distribution continuous could be used to the model interarrival times of customers e g messages when the traffic is bursty The mean and variance are finite only if shape gt 2 Parameter restrictions are location gt 0 0 and shape gt 0 0 SIMPROCESS User 5 Manual 51 Appendix D Statistical Distributions Binomial Distribution P z Binomial Distribution Plot for Bin 5 0 5 1 0 325 1 0 0 300 0 275 03 0 250 0 8 2 0 225
39. in the model directory When simulating the model the contents of this subdirectory will be included in the classpath The classes directory can contain e Any number of JAR files containing packaged Java classes and related resources to which the model may refer Compiled Java classes in directories representing their package structure along with any related resources to which the classes may refer Individual compiled Java class files considered to be in the default package although this is not recommended JAR files and class files can be used simultaneously with a model When to Use classes Subdirectory The ExternalCall1 System Method supports the use of Java classes in this subdirectory see Method ExternalCall Others may be added in the future As recommended above the classes subdirectory should be used in preference to either of the other described mechanisms Java Extension Mechanism and ext Directory except when specifically necessary or impractical not to do so Why Use classes Subdirectory Even if multiple models need to share the same set of classes and or JAR files this subdirectory should be used in order to make model sharing easier Since a model can carry its own background and icon images see Importing Graphics Image Files and carry its own external Java classes the need for instructions on how to place class files and import images is eliminated Instead the model file and its like named direct
40. in this directory for more information on the TimeServer SIMPROCESS User 5 Manual 34 APPENDIX D Statistical Distributions The following pages give a brief description of the standard statistical distributions available in SIMPROCESS as well as their required parameters Some of the distributions also have a version from the Apache Commons Math library see commons apache org proper commons math These are listed below along with their SIMPROCESS designation in parentheses Beta BetACM Binomial BinACM Exponential ExpACM Gamma GamACM Lognormal LogACM Normal NorACM Poisson PoiACM Triangular TriACM Uniform Integer IntACM Uniform Real UniACM Weibull WeiACM Most of the parameters for continuous distributions can be classified on the basis of their physical or geometric interpretation as being one of three basic types location scale or shape parameters The following discussion is taken from the book Simulation Modeling and Analysis Third Edition by Law and Kelton 2000 SIMPROCESS User s Manual 35 Appendix D Statistical Distributions A location parameter specifies an abscissa x axis location point of a distribution s range of values usually is the midpoint e g the mean of a normal distribution or lower endpoint e g location for a Pearson type V distribution of the distribution s range As changes the associated distribution merely shifts left or right without other
41. installed simply choose the Import UML Model from the Tools menu in Rational Rose In some cases due to slight differences in the aspect ratio of the graphics in SIMPROCESS and the Rational Rose tools minor visual clean up of the imported Activity Diagram may be required The following is a simple SIMPROCESS model that is exported to UML B SIMPROCESS Professional Edition File Edit Layout View Create Define Simulate Report Experiment Tools Window Help DEEE XeOxn Bt GH VEO Oz es Generatel Dispose Save of umitest complete The above SIMPROCESS model would look like the following in Rational Rose SIMPROCESS User 5 Manual 186 Appendix Exporting to UML amp Rational Rose untitled Activity Diagram Logical iew umltest F D EET IE a AEE T Fe r SIMPROCESS User s Manual 187 Appendix Exporting to UML Rose Use Cases SIMPROCESS provides the capability for the user to connect nodes activities on the SIMPROCESS model directly to a Rose Use Case Diagram This allows for a seamless flow from business process modeling and simulation analysis in SIMPROCESS to systems models in Rose Exported HTML views of the SIMPROCESS models Export are directly linked to Rational Rose exported HTML models This gives stakeholders a seamless wide area review of the business process models with Rose Use Case models SIMPROCESS models typically include both ma
42. its reference to its Parent Entity See Split and Join Activities for more information A runtime error will occur if InterruptEntity is used on an Entity that is part of a batch or is already interrupted due to Resource downtime see Defining Downtime Schedules of Resources or Entity preemption see Defining an Entity Entities delaying ona Connector cannot beinterrupted However no runtime error will occur FALSE will be returned Note that the Entity System Attributes InBatch Processing WaitingForResource and HoldingForCondition can be used to determine the state of an Entity before using InterruptEntity See System Attributes This method requires knowing the SequenceNum of a specific Entity so if there is potential for interrupting an Entity there must be a way to keep track of the SequenceNumn This can be done using Attributes Arrays Maps or parent child relationships For example assume a clone Entity is created at a Split Activity and the original Entity may need to interrupt the clone The SequenceNum of the clone can be saved in an Attribute on the original entity Alternatively if the clone needs to interrupt the original then Entity Parent SequenceNum can be used status BOOLEAN status InterruptEntity Entity Parent SequenceNum Transfer1 If less is known about the Entity to be interrupted it may be necessary to check conditions entity ANYOBJ status BOOLEAN entity
43. maximum shapel shape2 stream The Johnson Sp distribution continuous could be used to model the time required to perform some task when the possible values are restricted to the finite interval minimum maximum The density function is skewed to the left symmetric or skewed to the right if shape1 gt 0 shapel 0 or shapel lt 0 respectively The Johnson Sp distribution is closely related to the classical normal distribution see the book Simulation Modeling and Analysis Third Edition by Law and Kelton 2000 for details Parameter restrictions are shape2 gt 0 0 and maximum gt minimum SIMPROCESS User 5 Manual 56 Appendix D Statistical Distributions Johnson Sy Distribution Johnson SU Distribution Plot for JSU 0 0 1 0 2 0 2 0 1 0 55 1 0 0 50 0 9 0 45 0 8 nan g 0 40 07 3 gt 0 35 a 0 6 2 2 0 30 Oo 2 0 5 9 0 25 3 Se a4 S 0 20 T 0 15 03 F 0 10 0 2 0 05 0 1 0 00 00 10 05 0 0 0 5 1 0 1 5 2 0 25 3 0 35 4 0 45 50 55 Value PDF CDF E d Probability density function and cumulative density function for a Johnson Sy distribution with location 0 scale 1 shape1 2 and shape2 2 Syntax JSU location scale shapel shape2 stream The Johnson Sy distribution continuous could be used to model a random variable that can take on any value between minus infinity and plus infinity The density function is skewed t
44. numbers in list must GER same as the input list be of the same type MINOF list of numbers REAL INTE REAL or Returns the minimum number in GER INTE the given list Return type is the all the numbers in list must GER same as the input list be of the same type SIMPROCESS Users Manual 106 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description OpenApplication Application STRING NONE Opens the specified Application File Name Optional and optionally the specified File STRING Name within the Application The Application parameter must include the full path to the appli cation s executable file A full path is not required if an applica tion recognized by SIMPRO CESS is used For example if Excel is the default spreadsheet application for opening the Stan dard Report in a spreadsheet Excel can be used for Applica tion The optional File Name in dicates where the file to open is located If it does not contain any path separator characters i e backslashes on Windows slashes on other systems it is assumed to be in a folder named for the model in the same location from which the model was opened If path separators are used the pro gram assumes the user is provid ing a valid absolute path Note that Windows paths require dou ble backslashes instead of single backslashes OpenDatabase Propertie
45. replica tion See Building SQL Statements for information on defining a SQL statement Rep lication must be between and the number of replications de fined for the simulation or be 1 for average of replication results WriteToFile File Stream OBJECT Write the values of the listed vari list of variables ables to the output file specified by the File Stream WriteToSpreadsheet File Stream OBJECT Write the value of the Value pa Sheet Name STRING rameter to the output spreadsheet Cell Reference STRING file specified by the File Stream Variable STRING REAL Cell Reference is a single String INTEGER or BOOLEAN that contains the typical spread sheet method for identifying a cell e g A1 SIMPROCESS Users Manual 124 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Description WriteToSpreadsheet File Stream OBJECT DEPRECATED Use WriteTo Sheet Name STRING Spreadsheet with Cell Reference Row INTEGER instead Writes the value of Vari Column INTEGER able to the specified sheet row Variable STRING REAL and column of the output spread INTEGER or BOOLEAN sheet file specified by the File Stream WriteToSpreadsheet Name STRING Executes a predefined spread Replication INTEGER sheet with the requested replica tion See Building a Spreadsheet Export for informa tion on defining a spreadsheet Replication mus
46. the processing of a lower priority Entity Entity instance Name Get STRING Name of this Entity Activity Get OBJECT Reference of Activity this Entity instance resides in AcceptTime Get REAL Time Entity enters an Activity or Pro cess ActivityTime Get REAL Total time Entity was in an Activity whether waiting on hold or process ing Does not apply to Processes BatchSize Get INTEGER Number of Entity instances in this Entity s batch CreateTime Get REAL Time the Entity instance was created End Wait Both BOOLEAN TRUE if Entity wait for Resources was interrupted by Max Wait time EnterTime Get REAL Time the Entity instance entered the current Activity HasParent Get BOOLEAN TRUE if the Entity instance was cre ated by a Split Activity HoldingForCon Get BOOLEAN TRUE if the Entity is in a hold state at dition an Activity InBatch Get BOOLEAN TRUE if the Entity is part of a Batch Interrupt Both BOOLEAN Determines whether this Entity instance will interrupt the processing of a lower priority Entity LastDelay Get REAL Last processing delay time at an Activity SIMPROCESS User s Manual 72 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Attributes Model Elements Attribute Name Get Attribute Description Set Type Max Wait Both REAL Maximum time Entity will wait for Resource allocation Default is 0 0
47. the WSDL file and require generation and compilation of Java code to call it This simply isn t possible in a runtime environment As a result we ve had to select the best all around means of offering access to Web Services via SOAP In the future as available tools for runtime examination of WSDL files improve perhaps SIMPROCESS will be able to improve the SOAPCall statement to provide still greater capabilities SIMPROCESS User s Manual 149 Appendix F SIMPROCESS System Attributes and Methods Method InvokeWebService The InvokeWebService statement allows SIMPROCESS models to invoke operations or methods on Web Services The older SOAPCall statement should now only be used for a Web Service using the older rpc encoded form as newer technologies no longer support this type of operation The InvokeWebService statement requires a minimum of 5 parameters In addition if the operation being invoked expects parameters values should be provided for each The following is a list of the InvokeWebService parameters and a description of each including where to find them in a typical Web Services Description Language WSDL file e ContinueOnError A BOOLEAN value indicating whether the simulation should continue processing if an error occurs If false an error terminates the simulation if true an error will be ignored It s generally wise to use a false value at least until debugging has been completed The parameter used can be a B
48. the table in descending order based on the values in that column The Activities tab display the model Activity tree andthe Connectors tab displays the model Connector tree Again selecting an item in the tree displays the items attributes Expression Model Attributes Entity Types Resources Activities Supply TopProcessO B Alt1 aici B At1 RECEIVE St i Order Come NumberReleased 1 Generate Or Which Facto To Factory 1 To Factory 2 c2 H 1 H s2 H 3 aor DEMAND1 SHIP4 _ ET _ Process116 m me es me Tas as bas et ae amet Tamed es races ae ees e a E lt ua Next Statement Stop Simulation Line 2 The buttons at the bottom of the dialog are used to control BREAKPOINT operation or manipulate item trees Resources Activities and Connectors tabs only The Next Statement button moves to the next statement in the Expression Comments and blank lines are ignored All tabs are updated This button works correctly only when the following conditions are true There is only one statement on each line of the Expression Each statement is fully contained on one line of the Expression e A line with an active statement cannot include a comment The Next BREAKPOINT button moves to the next BREAKPOINT statement in the Expression All tabs SIMPROCESS Users Manual 163 Appe
49. you start the simulation the server program will put up a plot window and plot the values SimTime andNumber Accepted in this example on the plot window The window will SIMPROCESS User 5 Manual 14 Appendix F SIMPROCESS System Attributes and Methods appear as follows on the server B L My Plot _ BIB ete Number Entities yo w a i i 1 h i i i h 0 20 40 60 80 100 120 140 160 Simulation Time in Hours If the server is not running your simulation will be stopped and you will receive a message dialog stating that the server connection could not be made similar to the following lt OOOO Object Delay Error trying to invoke a remote method call URLName oK rmi i localhost Object name serverdemo Method name putPlotData System r Exception message serverdemo If your parameters don t match in number and type RMI Exceptions will occur and a message dialog will be presented with the error You will notice in this example that the putPlotData method expects a Java double parameter and an int parameter The following is a mapping of the SIMPROCESS data types that are allowed on the RemoteCall parameters and how they map to Java data types SIMPROCESS Java REAL double STRING String SIMPROCESS Users Manual 142 Appendix F SIMPROCESS System Attributes and Methods INTEGER int BOOLEAN boolean Method External lCall ExternalCa11 is a plug in capa
50. 1 lt 1 0 SIMPROCESS User 5 Manual 48 Appendix D Statistical Distributions Uniform Integer Distribution fi hi tors ee oc OOOO O O O Plot for Int 7 16 1 0 10 l 1 0 0 09 y 0 9 0 08 08 a 0 07 0o75 a o 06 06 amp 5 3 0 05 05 e a 0 04 0 4 S T 0 03 o3 F 0 02 0 2 0 01 I 0 1 0 00 0 0 7 8 9 10 11 12 13 14 15 16 Value Probability density function and cumulative density function for uniform integer distribution with minimum 7 and maximum 16 Syntax Int minimum maximum stream or IntACM minimum maximum stream A uniform integer distribution discrete is equally likely to take on any integer in the finite interval minimum maximum where minimum and maximum are integers with minimum gt 0 and minimum lt maximum SIMPROCESS User 5 Manual 49 Appendix D Statistical Distributions Geometric Distribution j gt Geometric Distribution Plot for Geo 0 5 1 0 50 1 0 0 45 4 0 9 0 40 08 k 0 35 4 073 a E 0 30 06 amp 5 3 80 254 O50 3 y je amp 0 204 0 4 g J 0 15 03g 0 10 0 2 0 05 0 1 0 00 1 l r pp ee T o il 2 3 4 5 6 7 8 Value PDF CDF la 4 Probability density function and cumulative density function for a geometric distribution with probability 0 5 Syntax Geo probability stream The geometric
51. 2 2 demo model Wafer spm produced the following error in simprocess log Error in Activity properties of Activity Inspect1 in imported model Wafer This error means the problem occurred somewhere close to the Activity named Inspect In the image below notice the graphics of the imported model The layout shows that the text block is missing from the Process Layer2 Also the Pads are not in the proper place for Layer2 This indicates that the error occurred in the Process Layer since no properties for Layer2 were imported SIMPROCESS Users Manual 21 Appendix A Importing Version 2 2 1 Models P SIMPROCESS Professional ioj xj File Edit Layout View Create Define Simulate Report Experiment Tools Help Window Dalal e salej s lale me jl ow a NI Wafer Fabrication Proc e np FURNACE PHOTO Wafer Starts ETCH Layer 1 Layer 2 To solve this open the model in SIMPROCESS 2 2 2 or 2 2 1 If you do not know exactly where the Activity named is you can use the Find Activity feature of the Activity Browser to find it Notice that there is a Connector named Jnspect as well as the Activity named Jnspect This is the cause of the problem Changing the name of the Connector or the Activity is the solution In this particular model this same Activity Connector combination is in Layer2 andneeds to be changed there as well This error caused by duplicate names will not occur with models saved in 2 2 3
52. 39 E ForestGreen 7 E Magenta 40 E LimeGreen 8 DarkGrey 41 E MediumForestGreen 9 E Grey 42 E MediumSpringGreen 10 E DarkRed 43 PaleGreen 11 E DarkGreen 44 E SeaGreen 12 DarkBlue 45 E YellowGreen 13 E DarkYellow 46 DarkSlateGrey 14 E DarkCyan 47 E DimGrey 15 E DarkMagenta 48 E Khaki 16 E Aquamarine 49 Maroon 17 E MediumAquamarine 50 Orange 18 IE CadetBlue 51 Orchid 19 HW CornflowerBlue 52 E DarkOrchid 20 DarkSlateBlue 53 E Pink 21 LightBlue 54 Plum 22 W LightSteelBlue 55 E IndianRed 23 E MediumBlue 56 E OrangeRed 24 E MediumSlateBlue 57 E VioletRed 25 HB MidnightBlue 58 E Sienna 26 E NavyBlue 59 E Tan 27 E SkyBlue 60 Turquoise 28 E SlateBlue 6l E DarkTurquoise 29 E SteelBlue 62 Violet 30 Coral 63 Wheat 31 E Firebrick 64 E GreenYellow 32 E Brown SIMPROCESS User 5 Manual 168 APPENDIX G External Event Files The Generate activity offers a File schedule This appendix describes the format for the event file associated with the File schedule SIMPROCESS User s Manual 169 Appendix G External Events Files General Rules for Event Files External event files define entity generation events If event files are referred to in a Generate activity SIMPROCESS reads the file at the beginning of a simulation run and schedules the generation of Entities as defined in the file Eachrecord line inan event file must adhere to certain syntax rules which are defined in
53. 97 D Distribution Beta 43 Erlang 44 Exponential 41 Gamma Geometric 50 Hyperbolic 51 Lognormal Normal Poisson 47 Triangular 39 Uniform 37 Weibull 45 S Statistical Distributions 35
54. Color STRING NONE Changes the color of the speci fied Activity Entity references are no longer allowed The key words Self Activity and Parent or the name of an activity is al lowed for ActName Note that a keyword must be input as a STRING such as Self The Color can be any of the 65 colors listed in the SIMPROCESS Color Table at the end of this appendix To clear a color setting enter Clear for the Color ClearMap Map OBJECT Clears all values from the speci fied map ClearPlot Plot OBJECT Clears the specified plot CloseDatabase Database Connection OB JECT Closes the specified database connection CloseFile File Stream OBJECT Closes the specified file CloseSpreadsheet File Stream OBJECT Closes the specified spreadsheet file Confirm MasterEditor Message STRING Displays a message in the Con firm dialog and waits for the user to respond OK returns TRUE CANCEL returns FALSE ConvertToDateTime NumberOfDays REAL INTEGER or STRING STRING Converts a number representing the number of days since January 1 1900 to a date and time in MM DD YYYY HH MM SS format Connector ConnectorName STRING OBJECT Returns the reference to the spec ified Connector Returns UNDE FINED if not found SIMPROCESS User s Manual 83 Appendix F SIMPROCESS System Attributes and Methods SIMPROCE
55. Files models Demos ExpressionDemos metamodel BPEL AddressModel CorporateInformation orgmodel Demos dashboardserver timeserver Installation Directory ReadMe SIMPROC Dispatc Dispatc Dispatc lax jar SPRunSimulation exe SPRunSimulation SPRunSimulation lax SIMPROC SIMPROC SIMPROC MetamodelEditor exe MetamodelEditor MetamodelEditor lax MetamodelEditor ico OrgMode OrgMode OrgMode OrgMode java2re Imutil Imutil txt ReadMe file with summary of changes ESS ico SIMPROCESS icon Windows only her exe Optional Dispatcher application Windows only her Optional Dispatcher application non Win dows systems her lax Optional Dispatcher application settings file Installer file SIMPROCESS with no GUI Windows only SIMPROCESS with no GUI non Windows Application settings file ESS exe SIMPROCESS executable Windows only ESS SIMPROCESS executable non Windows ESS lax Application settings file Metamodel Editor executable Windows only Metamodel Editor executable non Windows Application settings file Metamodel Editor icon Windows only OrgModel Editor executable Windows only lEditor exe lEditor OrgModel Editor executable non Windows lEditor lax Application settings file lEditor ico OrgModel Editor icon Windows only i dll Rose Java interface library Windows only exe Licensing file Windo
56. Gate returns a reference to a Gate Activity GetEntity returns a reference to an Entity being held in a Gate Activity GetEntity can also be used to return a reference to an Entity waiting for a Resource or return a reference to an Entity held SIMPROCESS User 5 Manual 144 Appendix F SIMPROCESS System Attributes and Methods in another Entity s batch EntityExists checks for the presence of a specific Entity at a Gate Activity For example gate ANYOBJ entity ANYOBJ i INTEGER goodRelease BOOLEAN gate Gate Gatel2 get reference to Gate activity FOR i 1 TO gate NumberOnHold entity GetEntity gate i get the entity at position i IF entity Attribute2 gt 100 0 release the entities that match the condition goodRelease ReleaseEntity gate entity SequenceNum IF NOT goodRelease notify of entity not released OUTPUT Entity entity SequenceNum not released from Gate gate Name END IF END IF END FOR EntityExists can be used to find the index position of a specific entity For example using the same Gate reference as the above example position INTEGER 42 is the SequenceNum of the Entity desired position EntityExists gate 42 IF position gt 0 entity GetEntity gate position goodRelease ReleaseEntity gate 42 END IF The ExpressionDemos directory has a sample model named ReleaseEntity spm If this directory is not part of the SIMPROCES
57. IMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file documentation file settings Win settings Linux Windows only SIMPROCESS User s Manual 30 APPENDIX C SIMPROCESS File Structure SPUserA pdf SPUserB pdf SPUserC pdf SPUserAppendices pdf Metamodel pdf OrgModel pdf Release jpg RoseExists dll license dat documentation fil documentation fil documentation fil documentation fil documentation fil documentation fil Splash image file SIMPROCESS Rose library Windows only license file obtained from CACI oooeoo o SPHelp Directory This directory contains the directories and files for the SIMPROCESS Help jre Directory This directory contains the Java Runtim
58. IMPROCESS types It then SIMPROCESS User s Manual 148 Appendix F SIMPROCESS System Attributes and Methods Notes 1 assumes that the operation s named parameter is of the corresponding SOAP type Only testing the SOAPCall statement with a specific operation will determine whether it can be used See note 6 for more information Depending on the developer of a Web Service and the toolset s used the element names appearing in a WSDL file may be qualified with a namespace For instance the structure of a WSDL file is mandated by standard which is sometimes referred to via namespace so that all the elements ina WSDL file may be qualified like lt wsdl definitions gt or lt wsdl operation gt When this approach is used there will be a namespace reference in an attribute on the root elementofthe WSDL file suchas xmlns wsdl http schemas xmlsoap org wsdl indicating the namespace prefix e g wsdl and the URI of the namespace Much of the above information is based on the assumption that WSDL file elements are not namespace qualified as is true of SSMPROCESS DispatcherService 2 A typical lt binding gt element optionally namespace qualified see note 1 will be immediately followed by a lt soap binding gt element with a style attribute SOAPCall only works with those having a value of rpc here if the style is document the SOAPCall statement cannot be used with this service 3 The l
59. If the file selected is a version 3 or higher file it will open However if the file is pre 2 2 1 an error dialog will appear Import Model Q Invalid 2 2 x model fle Model version must be 2 2 1 2 2 2 or 2 2 3 SIMPROCESS User 5 Manual 10 Appendix A Importing Version 2 2 1 Models Preparing Your Model For Import The import procedure reads a 2 2 1 2 2 2 or 2 2 3 model file and converts the information to XML that can be read by SIMPROCESS version 4 or higher However due to limitations in 2 2 1 and 2 2 2 files some preparation may be required For larger models it is recommended that they be opened and saved in 2 2 3 Without being saved in 2 2 3 importing the properties of an Activity Connector Pad etc from earlier version models depends upon the name of that item Therefore if there are duplicatenames atthe same level errors will occur andthe conversion will not becomplete Depending on the version of your model there are three or four primary steps in preparing your model for import The first item only applies to models that have not been saved in 2 2 3 e Make sure there are no duplicate names at the same level 2 2 1 and 2 2 2 only e Make sure certain special characters are not in names e Make sure all required fields are complete e Make sure all special graphics are imported before importing the model Duplicate Names 2 2 1 and 2 2 2 When checking the names be concerned with names that are at th
60. LEAN Value of Unbatch Nested Batches Batches a System attributes names must be input as shown They are case sensitive b Attributes in this category can be referenced in any expression SIMPROCESS User s Manual 80 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods SIMPROCESS System Methods Method Name Arguments Description X INTEGER or REAL Returns the absolute value of X The type INTEGER or REAL of the returned value will be the same type as the argument ActivateGenerate Generate Name STRING NONE If not already started starts the generation of Entities by the specified Generate Activity ACOS X REAL REAL Returns the ACOSine of X AddPlotLegend Plot OJBECT NONE Adds a legend to a plot created Dataset INTEGER through expressions CreatePlot Label STRING system method Datasets are Color Optional STRING numbered beginning with 0 The Label of the legend must be specified Specifying the Color is optional Alert MasterEditor NONE Display a message in the Alert di Message STRING alog and wait for the user to close this dialog ASIN X REAL REAL Returns the ASine of X ATAN X REAL REAL Returns the ATANgent of X ATAN2 Y REAL X REAL REAL Returns the ATANgent of X and Y SIMPROCESS User s Manual 8l Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name
61. MasterEditor This is the key word that must be there and input as shown The next two arguments are the Name and ID of the dynamic label defined in the Background Text Properties dialog The fourth argument is the color to be used in displaying this label The last argument is the value to be displayed It can be a constant or an attribute but the data type must match the Mode defined in Background Text Properties For example you want to display the number of Entities generated at a Generate Activity Assume you have already defined a dynamic label with the name total ID of 0 and data type of INTEGER In the Release Entity event of the Generate Activity add the following line UpdateDynamicLabel MasterEditor total 0 DarkBlue Num berGenerated The first parameter of this method must be MasterEditor and input as shown Methods OpenFile CloseFile ReadFromFile and WriteToFile OpenFile opens the file specified in the Filename field for either input or output The mode must be either input or output not case sensitive Input opens a file to read while output opens a file to write Any other specifications will lead to an error message Both arguments are STRING type i e they must be surrounded by quotation marks OpenFile returns an Object type value which is required in CloseFile ReadFromFile and WriteToFile methods OpenFile Mode Filename OBJECT By default SIMPROCESS will loo
62. NTEGER value REAL FOR i 0 TO 2 FOR j 0 TO 1 value DrawRealSample Log 10 1 10 SetArrayValue Model TimeArray i j value END FOR END FOR Values are retrieved from an array using GetArrayValue Assume the three origin locations are represented by 0 1 and 2 and the two destination locations are represented by 0 and 1 These are assigned to the Entity Attributes Origin and Destination local variables would also work Entity Origin DrawIntegerSample Int 0 2 11 Entity Destination DrawIntegerSample Int 0 1 12 Entity DelayTime GetArrayValue Model TimeArray Entity Origin Entity Destination Since arrays can also be of type ANYOBJ SIMPROCESS object references such as Activities Entities and Resources can be stored in an array For instance a particular Activity stored in an array could be referenced in any Expression since a Model Attribute can be used in any Expression Assume aCreateArray statement created aonedimensional ANY OBJarray assigned to the Model Attribute ActivityArray myActivity ANYOBJ myActivity Sibling Delay12 SetArrayValue Model ActivityArray 0 myActivity SIMPROCESS User s Manual 146 Appendix F SIMPROCESS System Attributes and Methods TheExpressionDemos directory has asample modelnamedCreateArray spm Thisdirectory can be downloaded at www simprocess com Method SOAPCall The SOAPCall statement provides SIMPROCESS
63. OCESS User s Manual 110 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description ReadFromSpread File Stream OBJECT NONE Read a value into the variable sheet Sheet Name STRING represented by the Value parame Cell Reference STRING ter from the input spreadsheet file Variable STRING INTE associated with the specified File GER REAL or BOOLEAN Stream Cell Reference is a single String that contains the typical spreadsheet method for identify ing a cell e g A1 ReadFromSpread File Stream OBJECT NONE DEPRECATED Use ReadFrom sheet Sheet Name STRING Spreadsheet with Cell Reference Row INTEGER instead Read a value from the Column INTEGER specified sheet row and column Variable STRING INTE of the input spreadsheet file asso GER REAL or BOOLEAN ciated with the specified File Stream The value is assigned to Variable REALTOSTR number REAL STRING Converts a real number to a precision INTEGER Option string If a precision is specified al the number is rounded to the specified precision Trailing ze roes are added if the decimal part of the number is less than the specified precision ReleaseEntity Gate OBJECT BOOL Causes the release of the Entity SequenceNum INTEGER EAN with the specified SequenceNum from the specified Gate The Gate parameter is obtained using the Gate System Method Re turns TRUE if the En
64. OOLEAN or a STRING as defined in the SIM PROCESS User s Manual When a string is passed any value when converted to lower case letters other than true will be considered false There are certain conditions which will result in an error regardless of this setting See Note 1 for additional information e WSDL URL A string containing a URL where the WSDL for the Web Service can be ob tained e Service Name A string containing the Service Name as given in the WSDL file In a typi cal WSDL file there will be a lt service gt element it may optionally be namespace qualified see Note 2 near the end of the WSDL file with a name attribute that will provide the value to use here e Service Port Type Name A string containing the name of the service s port type This will appear in a lt portType gt element also optionally namespace qualified and its name at tribute will provide the service port name e Operation method to invoke A string containing the name of the operation to invoke A typical WSDL file will have one or more lt operation gt elements as children of lt portType gt each having a name attribute with the operation s name e Additional parameters as required by the operation to be invoked If the operation expects parameters the remaining arguments provided to the InvokeWebService statement must match those in both number and type A WSDL file may include a reference to an external XML Schema file describ
65. PROCESS Users Manual 109 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description POSITION Stringl STRING INTE This method returns the starting String2 STRING GER position of String2 in String1 If String2 is not completely con tained in String1 it returns 0 POWER X REAL Y REAL REAL Returns X raised to the power of Y PutInMap Map ANYOBJ NONE Places the value in the specified Key INTEGER REAL map using the key as reference BOOLEAN STRING ANY OBJ Value INTEGER REAL BOOLEAN STRING ANY OBJ READ INTEGER REAL STRING INTE Reads a single variable into an or BOOLEAN GER identifier from a dialog prompt REAL The name ofthe identifier will be STRING presented in the dialog for the or BOOL user and the value entered will EAN be validated i e INTEGER type must be an integer value ReadFromDatabase Database Connection OB NONE Reads values based on the SQL JECT Statement from the database Result Set Name STRING specified by the connection The SQL Statement STRING values are placed in a Result Set with the given Result Set Name The Result Set Name should be unique for each ReadFromData base unless a Result Set is to be replaced ReadFromFile File Stream OBJECT NONE Read values for the listed vari List of variables ables from the input file associat ed with the specified File Stream SIMPR
66. R Stamp with Start Key and Stop Key Value Type is either Avg StDev Min Max Count or RunLength A Replication of 1 returns the aver age of replications and a Repli cation of 2 returns the sum of replications SIMPROCESS User s Manual 101 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description GetTotalCostStatistic Name STRING REAL Returns the total cost for the Cost Type STRING Value Type STRING Replication INTEGER requested Resource Entity or Activity Name If Name is Total then the total cost of all Resources is returned Cost Type is either Variable or Absorp tion Value Type is either Avg StDev Min or Max for Replication 1 If Replication is or greater the maximum value is returned no matter what is entered for Value Type A Replica tion of 1 returns the average of replications and a Replication of 2 returns the sum of replica tions ends the current replication and simulation continues with next replication If parameters are used the simulation is stopped with an error condition A dialog appears that contains the con tents of the parameter SIMPROCESS User s Manual 102 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return De
67. ROCESS Static and dynamic labels can experience the same results during conversion Although labels do not overlay a Process or Activity like a text block the imported labels may be smaller than desired Again this is due to vector fonts being eliminated To change a label just open up the properties and change the font attributes m Font Attributes j Font Name Arial Size fi 2 7 Color Black x Bold I Italic SIMPROCESS User 5 Manual 20 Appendix A Importing Version 2 2 1 Models Properties Import Results Ifthe model has been prepared properly there should be no errors during the import If errors do occur an error dialog will appear x Q Errors encountered during conversion process Model may not be complete Ifthe error dialog appears open the simprocess 1og file in the SIMPROCESS working directory see SIMPROCESS Working Directory This file will contain more detailed error messages The first error listed is the one to focus on Normally the error messages that follow the first one result from the first error The image below shows the top level of the 2 2 2 demo model Wafer spm This model will be used as an example for diagnosing errors in properties Wafer Fabrication Process Model FURNACE FURNACE METALIZE e mi PHOTO MASK gt ETCH ETCH CUT Stock Wafer Starts Layer 1 Layer 2 Finish As an example an import of the 2
68. ROCESS model This feature is apowerful way to make calls to user applications either custom developed or commercial products based on how the business process model and workflow is planned An example of this might be a model that represents a To Be business process flow for Human Resources where you intend to use acommercially available human Resources product such as Peoplesoft Lawson or Oracle Based on specific Activities in the model execution you could make expression script calls to a user written server that would feed the commercial application as a prototype to see if the product will align with the desired business process needs The server program could feed the application either from native calls to the product or via other interface technologies such as XML This capability will support analysis using models between the business functions and the system transactions that are required SIMPROCESS User 5 Manual 135 Appendix F SIMPROCESS System Attributes and Methods to support them TheRemoteCa11 provides the mechanisms to make calls toa Java RMI server that has beenregistered using the Java RMI Registry It is the responsibility of the user to develop the RMI server program and start the application The expression script method simply has to have the name of the server computer could be the same computer that the model is running on or could be a separate server over the network the server objectto
69. S model1s directory it can be downloaded at Wwww simprocess com Methods CreateArray GetArrayValue SetArrayValue These methods are used to create and manipulate multi dimensional arrays CreateArray creates a REAL INTEGER BOOLEAN STRING or ANYOBJ array Arrays of type REAL and INTEGER SIMPROCESS Users Manual 145 Appendix F SIMPROCESS System Attributes and Methods are initialized to zero BOOLEAN arrays are initialized to FALSE Arrays of type STRING and ANY OBJ are not initialized with any values GetArrayValue retrieves a value from an array and SetArrayValue places a value inanarray Note that ifGetArrayValue is used witha STRING or ANY OBJ array in which the requested element has not had a value assigned by SetArrayValue anetror willoccur An Attribute with a Mode of Object must be defined to create an array For example assume there is a Model Attribute named TimeArray with Mode Object Model TimeArray CreateArray REAL 3 2 This creates a two dimensional array for REAL numbers The first dimension has a length of 3 and the second dimension has a length of 2 The type of array REAL INTEGER etc must be entered as a STRING This array can contain the delay times for 6 routes 3 origin locations and 2 destination locations Use SetArrayValue to populate the array Note that array indices are zero based Also the type of the value passed to the array must match the type of the array i INTEGER j I
70. SS System Methods Method Name Arguments Return Description COS X REAL REAL Returns the COSine of X CreateActivityMap None OBJECT Returns a map of all the Pro cesses and Activities The map key is the Name of each Process Activity so names must be unique to ensure the map con tains all Processes and Activities in the model CreateArray Type STRING OBJECT Returns an array of the specified Dimension INTEGER type REAL INTEGER Dimension2 INTEGER BOOLEAN STRING or DimensionN INTEGER ANYOBJ with the specified dimensions For example Cre ateArray REAL 2 2 returns a 2x 2 array for REAL numbers Arrays of type REAL and INTE GER are initialized to zero Arrays of type BOOLEAN are initialized to FALSE Arrays of type STRING or ANYOBJ are not initialized thus attempting to retrieve a value from an array element that has no value will result in an error SIMPROCESS User s Manual 84 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description CreateAttribute Name STRING NONE Creates an Attribute This Type STRING method can only be used in the Owner STRING Start Run Expression Define Mode STRING Model Expressions or Define Default Value INTEGER REAL BOOLEAN STRING or UNDEFINED ArraySize Optional INTE GER DoNotReset Optional BOOLEAN StatType Op
71. SS Users Manual 17 Appendix A Importing Version 2 2 1 Models Connectors are created by clicking on the layout Every click point creates a right angle In the 2 2 2 example below this is how the feedback loop is created blue Connector EJ SIMPROCESS Professional Feedback 5 x File Edit Layout View Create Define Simulate Report Experiment Tools Help lela a zile ale Generatel Dispose4 Notice that in the imported model the feedback Connector from Branch3 to Delay2 overlays the Connector from Delay2 to Branch3 This is because the Connector from Branch3 to Delay2 took the default path Thus this Connector will need to be deleted and redrawn Converting Connectors using the vertices of the corners created strange results due to the change in coordinate systems Using the default Connector between Activities means only special Connectors need to be redrawn SIMPROCESS User 5 Manual 18 Appendix A Importing Version 2 2 1 Models ip File Edit Layout View Create Define Simulate Report Experiment Tools Help Window Data a esia EA Pecoatieatk EEk e Generatel At Delay2 Branch3 e gt Dispose4 Text Blocks Static Labels and Dynamic Labels Text blocks are labels that can display on Processes or Activities In earlier versions of SIMPROCESS the font used for text blocks was a vector font The font would scale as
72. SS published model on the disk drive or web server When navigating the SIMPROCESS published HTML model moving the mouse pointer over a SIMPROCESS activity node that has been connected to a Rose Use Case Diagram as described in this section gets a Javascript popup that links directly to the Rose published HTML Use Case Diagram automatically This capability is very useful for wide area review of business process models that have Use Case functional requirements attached to certain nodes in the SIMPROCESS model Hence the business process requirements and the system requirements are in context of each other using this technique SIMPROCESS User 5 Manual 190 APPENDIX J Running Models Without GUI SIMPROCESS models can be run without the SIMPROCESS Graphical User Interface GUI There are two executables in the SIMPROCESS directory SIMPROCESS and SPRunSimulation any extensions are platform specific The SIMPROCESS program starts the SIMPROCESS GUI required to build and edit models This GUI is typically used to run models as well However SPRunSimulation can be used to run a SIMPROCESS model without the GUI A valid license dat file is required to run SIMPROCESS and SPRunSimulation The same license file is used for both Since access to the GUI is not available results of the run must be automatically output to the SIMPROCESS database see SIMPROCESS Database user created files or a user created database Statistics collected
73. Set STRING Name of the Connector to be taken by the next Entity NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources Clone Group I II amp III NumOutEntities Both INTEGER Number of Entities to output per Con nector NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources Delay Group I II amp III NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources Dispose Group I amp II MaxCount Both INTEGER Number of Entities disposed to signal End Simulation event NumberDisposed Get INTEGER Number of Entities so far disposed at this Activity Free Resource Group I amp II Gate Group I II amp HI ActivatedByTrig Get BOOLEAN Checks if the expression is activated ger by an Entity entering from the Trigger Pad AutoRelCount Both INTEGER Number of Entities for threshold release AutoRelease Both BOOLEAN Whether threshold release is on BatchEntities Both BOOLEAN Value for whether to batch released Entities SIMPROCESS User s Manual 77 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Attributes Model Elements Attribute Name Get Attribute Description Set Type BatchEntityType Both OBJECT Type of Entity to create when a Batch occurs Note that when BatchEntity Type is used to set the Entity Type for the Batch the name o
74. StartTime The object owning the Attribute can be specified by including a colon and the name of the object in AttributeName For example At tribute Time Disposel would return the Attribute named Time from the Activity Disposel The object reference can be an Entity Type Resource or Activity Note that using the object name is the only way to retrieve Resource Attributes SIMPROCESS User s Manual 114 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SetEntityExpression EntityTypeName STRING NONE Applies SIMPROCESS Expres ExpressionType STRING sion code in the specified Expres Expression STRING sion parameter to the specified Entity Type This method can only be used inthe Start Run Expression Define Model Expres sions or Define Model Expressions button on the Model Toolbar ExpressionType is case sensitive and must be a valid Entity In stance Expression type Ini tialize Entity Accept Entity Interrupt Pro cessing Resume Pro cessing Release Entity orDispose of Entity The Expression parameter should be the complete Expression code in a single STRING or the complete file name with no path of the file that contains the Expression code If the Expression parameter is a file the file must located in the model s directory SIMPROCESS User s Manual 115 Appendix F SIMPROCESS Sy
75. User s Manual Appendices SIMPROCESS Release 5 CACI EVER VIGILANT Copyright 2002 2015 CACI INC FEDERAL All rights reserved No part of this publication may be reproduced by any means without written permission from CACI The information in document is believed to be accurate in all respects However CACI cannot assume the responsibility for any consequences resulting from the use thereof The information contained herein is subject to change Revisions to this publication or new editions of it may be issued to incorporate such change SIMPROCESS is a registered trademark of CACI INC FEDERAL Table of Contents Organization of the SIMPROCESS Documentation Set ss00e 6 Appendix A Importing Version 2 2 1 Models sssscccsssssccssscecsssssecessssseees 9 Import Procedures ssssssccs cases scestesandccpesescascesnesedesotesscdssacestsesesiecces 10 Preparing Your Model For IMport sscssssessssssssssseesees 11 Graphical Import Results se sseossooesoossooessossseessoossoossoossssesssose 14 Properties Import Results csccccsssccssscccssscccssescssssseeesenes 21 Importing Document Files scssccsssesssscssscsssessssesssessssseess 24 Appendix B Activity Summary TAD cisssiscsiasssscsivecasvessssecconasuseseecesunavessexesenases 25 Appendix C SIMPROCESS File Structure ccccsccccsscccssccccsccccsscccsssceccssccees 28 Appendix D Statist
76. Wei 3 0 1 0 1 La 1 0 sgl 0 9 1 0 z 0 8 0 9 0 8 0 7 0 7 0 6 0 6 0 5 0 5 Probability 0 4 Iqeqo4d apenn 0 4 Oss 0 3 lt 0 2 0 2 0 1 0 1 0 0 5 i 0 0 0 1 0 2 0 3 0 4 0 5 0 6 0 7 0 8 0 9 1 0 1 1 1 2 13 1 4 15 16 17 18 19 Value PDF CDF x A Probability density function and cumulative density function for a Weibull distribution with shape 3 and scale 1 Syntax Wei shape scale stream or WeiACM shape scale stream The Weibull distribution continuous could be used to model the time required to perform some task It is also sometimes used to model the time to failure of a piece of equipment A Weibull distribution with parameters shape 1 and scale b is an exponential distribution with mean b The Weibull distribution is skewed to the left when shape gt 3 6 Parameter restrictions are shape gt 0 0 and scale gt 0 0 SIMPROCESS User 5 Manual 45 Appendix D Statistical Distributions Lognormal Distribution Lognormal Distribution Plot for Log 2 0 1 0 1 0 55 47 1 0 0 50 0 9 0 45 7 0 8 0 40 4 e 0 7 5 0 35 4 Z 06 0 30 T E os 6 0 25 2 je 04 0 20 amp 0 15 Eley 0 10 0 2 0 05 0 1 0 00 7 0 0 0 0 05 1 0 15 2 0 25 3 0 3 5 4 0 Value PDF CDF x
77. ach observed values i e EX2 if this is observation based For time weighted it is the summation of the square of each observed value multiplied by the time that this value has persisted in i e D X AT Count This is the number of observations recorded when the statistic was collected Average This is the average of the statistic SIMPROCESS User s Manual 177 Appendix H Simulation Results File Std Deviation This is the standard deviation of the statistic Statistic Types The table below gives the descriptions of the statistic types within SIMPROCESS Type of Labels Statistics Descriptions Entities tokendelay Observation Total cycle time i e sum based of wait hold and pro cess tokenwaitdelay Observation Time waiting for avail based able resource tokenholddelay Observation Time waiting for condi based tion to be reached tokenprocessdelay Observation Time processing i e at based specified duration tokentraveldelay Observation Time traveling across based connectors tokenlevel Time weighted Number of entities in system tokenwaitlevel Time weighted Number of entities wait ing for available resource tokenholdlevel Time weighted Number of entities wait ing for condition to be reached tokentravellevel Time weighted Number of entities trav eling across connectors tokenprocesslevel Time weighted Number of entities in process i e at duration
78. activity into the hashmap with the name of the activity as the key to the value the activity itself Note that the keys must be unique Thus iftwo activities being placed into the hashmap have identical names only the last one placed in the hashmap will be there The last one put in the map will replace the previous entry Assume intheAccept Entity expression ofa Branch Activity we need to determine the appropriate path for the incoming Entity based on information from the Activities in the hashmap In this example there are two Activities in the hashmap Call Wait Queue and Calls In Service GetFromMap can be used to retrieve each Activity and check each Activity s status callWait ANYOBJ SIMPROCESS User s Manual 152 Appendix F SIMPROCESS System Attributes and Methods callService ANYOBJ callWait GetFromMap Call Wait Queue callService GetFromMap Calls In Service IF callWait NumberIn gt 100 AND callService NumberIn gt 25 Entity Reject TRUE END IF RemoveFromMap also returns the value stored in the hashmap but it also removes the value from the map Thus if the statements below were used the next entity entering the Branch Activity would get an error since the Activities no longer exist in the hashmap callWait RemoveFromMap Call Wait Queue callService RemoveFromMap Calls In Service RemoveFromMap should be used when the values in the hashmap are temporary
79. al processes ONLY It STRING returns the reference to the child Activity or process with the specified name Returns UNDEFINED if not found Replenish Group I amp II Resource Split Group I II amp MI NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources Synchronize Group I II amp II NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources NumberOnHold Get INTEGER Number of Entities at this activity holding for condition Transfer Group I amp II Transform Group I II amp II NumOutEntities Both INTEGER Number of output Entities NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources TransformEntity Both OBJECT Type of Entity to create when a Type Transform occurs Note that when TransformEntityType is used to set the Entity Type for the Transform the name of the Entity Type STRING instead of the Entity Type itself should be used For example Trans formEntityType Entity 1 SIMPROCESS User s Manual 79 Appendix F SIMPROCESS System Attributes and Methods Model Elements SIMPROCESS System Attributes Attribute Name Attribute Type Description Unbatch Group I II amp HI NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources RetainBatchedEn Both BOOLEAN Value of Retain Batched Entities tities UnbatchNested Both BOO
80. an stream or ExpACM mean stream The exponential distribution continuous is commonly used to model interarrival times of customers to some system when the arrival rate is approximately constant over the time period of interest It is also sometimes used to model the time to failure of a piece of equipment The mean of an exponential distribution is a scale parameter and must be greater than 0 0 An exponential distribution with mean m is a gamma distribution with mean m and shape 1 An exponential distribution with mean m is a Weibull distribution with shape 1 and scale m If interarrival times of customers have an exponential distribution with mean m then the number of arrivals in any time interval of length t has a Poisson distribution discrete with mean m SIMPROCESS User 5 Manual 4 Appendix D Statistical Distributions Gamma Distribution p Gamma Distribution Plot for Gam 2 0 5 0 1 o e o DD w w a a u Q a G A See See aS an N O oO Probability uO Oo A S D u Aqyigeqoud apenn o H un w 0 10 o S 0 05 9 Hin 0 00 o 0 0 0 5 1 0 15 2 0 2 5 3 0 3 5 4 0 4 5 Value PDF CDF Probability density curve and cumulative density function for a gamma distribution with mean 2 and shape Syntax Gam mean shape stream or GamACM mean shape stream The gamma distribution
81. and Methods HALT No Employees for technician type name END IF Create the resource with the selected name and units CreateResource name FLOAT units FALSE FALSE FALSE FALSE Set the downtime to a predefined global downtime SetResourceDowntime name Technician Downtime Set the hourly cost cost GetResult Set HourlyCost SetResourceCost name cost PerTimeUnit Hours Set up expressions for the Resources sql Select ExpressionId From ExpressionUse Where ExpressionOwnerId INTTOSTR id ReadFromDatabase Model Database ExpUseSet sql WHILE GetNext ExpUseSet expressionId GetResult ExpUseSet ExpressionId IF expressionId gt 0 Get the expression and set it in the Resource sql Select From Expressions Where ExpressionId INTTOSTR expressionId ReadFromDatabase Model Database ExpSet sql IF GetNext ExpSet expressionType GetResult ExpSet ExpressionType expressionText GetResult ExpSet ExpressionText SetResourceExpression name expressionType expressionText END IF END IF BREAKPOINT END WHILE techName TechnicianType INTTOSTR id Put the name of the Resource into a map keyed by TechnicianTypel 2 etc PutInMap Model TechnicianNameMap techName name END WHILE When a BREAKPOINT statement is encountered in an Expression and BREAKPOINT statements have been activated see Expression Option
82. apters are e SIMPROCESS Organization and Resource Models e SIMPROCESS OrgModel Editor e Assigning OrgModels e Using OrgModels with SIMPROCESS APPENDIX A Importing Version 2 2 1 Models Version 2 2 1 or 2 2 2 models cannot be opened using File Open Earlier version models must be imported to version 4 This is done using File Import Version 2 2 1 Model Model versions earlier than 2 2 1 cannot be imported These models must be saved in 2 2 1 or 2 2 2 before they can be imported into version 4 However it is recommended that models be saved in 2 2 3 before importing SIMPROCESS 2 2 3 is a special Student version Import Utility that is designed to prepare models for import to version 4 The 2 2 3 Student version can load and save models from versions of SIMPROCESS earlier than 2 2 1 The special Student version of SSMPROCESS 2 2 3 is available at www simprocess com Earlier version models must be imported because the structure of SIMPROCESS and the structure of a SIMPROCESS model file has changed Version 3 and higher model files are XML files Thus they can be read by any XML parser SIMPROCESS User 5 Manual 9 Appendix A Importing Version 2 2 1 Models Import Procedures To import a model select File Import Version 2 2 1 Model and choose the model to import fa Import Version 2 2 1 SIMPROCESS Model Look in models 2 pma File name Open Files of type SIMPROCESS Models spr
83. ation of Entities by the specified Generate Activ ity DecreaseCapacity Resource Name STRING NONE Decreases the capacity of a Re Units INTEGER or REAL source by the units specified DeleteFile File Name STRING BOOL Delete the specified file or direc EAN tory Returns TRUE if the action is successful The File Name in dicates where the file or directory is located If it does not contain any path separator characters i e backslashes on Windows slashes on other systems it is as sumed to be in a folder named for the model in the same location from which the model was opened If path separators are used the program assumes the user is providing a valid absolute path Note that Windows paths require double backslashes in stead of single backslashes DisplayPlot Plot OBJECT NONE Displays the specified plot A Plot can also be displayed by us ing the Menu Report Display Real Time Plots or by using the Display Plots button on the tool bar SIMPROCESS User s Manual 90 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description DisposeResultSet ResultSetName STRING NONE Disposes a Result Set created by ReadFromDatabase DrawIntegerSample Statistical Distribution INTE Draws a sample of type integer STRING GER from the specified statistical dis tribution DrawRealSample Statistical Distribution REAL Draws a sampl
84. be called theremote method to call andthe parameter list that matches the remote procedure in the user written server Example mybool BOOLEAN mybool RemoteCall rmi localhost server demo putPlot Data SimTime Self NumberAccepted Inthe example above aremote server application this one happens to berunning onthe same computer as the model hence the localhost URL address called server demo is looked up using the Java RMI registry and the putPlotData method is called with two parameters SimTime and NumberAccepted where NumberAccepted is the number of Entities accepted in the Activity See System Attributes The following is a description of the server application showing the actual Java code needed to implement this example This textisnotacompletereferenceto RMI programming andwerecommend you reference any of the many Java published materials on RMI java sun com isa good place to start The following is a list of the source Java programs that demonstrate the RemoteCall interface The files are located in the SPUser SampleFiles directory SPServerDemo java defines the server class and the methods that will be called from the expression script The Java code is as follows package com caci demo import java rmi import java util import ptolemy plot import ptolemy plot plotml public interface SPServerDemo extends Remote boolean putPlotData double simtime int totalEnti
85. ber of Replications value in the Run Settings This method can only be used inthe Start Run Expression Define Model Expres sions or Define Model Expressions button on the Model Toolbar SetResourceCost ResourceName STRING NONE Sets one of the costs of the speci Cost REAL fied Resource CostType can be CostType STRING PerEntity PerUnit PerTimeUnit TimeUnit STRING or Fixed If PerTimeUnit is the CostType then TimeUnit must be one of the valid SIMPRO CESS time units Hours Min utes etc If Fixed is the CostType then the TimeUnit must be Weekly Montly Quar terly Half Yearly or Yearly TimeUnit is not required if the CostType is PerEntity or PerUnit Note that if the Resource is con sumable then only PerEntity and PerUnit are valid CostTypes SetResource Down ResourceName STRING NONE Applies a global Resource Down time DowntimeName STRING time Define Resource Down times to the specified Resource This method can only be used in the Start Run Expression De fine Model Expressions or Define Model Expressions button on the Model Toolbar SIMPROCESS User s Manual 117 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SetResourceExpres ResourceName STRING NONE Applies SIMPROCESS Expres sion ExpressionType STRING sion code in the specified Expres Expression STRING sion parameter to the specifie
86. bility that can be licensed separately from CACI to allow users to make calls to external Java classes from within the expression scripts ofa SIMPROCESS model When calling an external Java class from an Expression using this statement it may be necessary to add compiled Java class files to the classpath used by SIMPROCESS See SIMPROCESS and External Java Classes for information on how to add external Java classes to the SIMPROCESS classpath Since ExternalCa11 is a function a value will be returned If the method called in the external class does not return a value return type is void SIMPROCESS will return the value TRUE thus the method should be assigned to a BOOLEAN local variable or attribute Only valid SIMPROCESS data types can be returned STRING BOOLEAN INTEGER REAL ANYOB J For types other than ANYOBJ see previous table in RemoteCall section for comparable Java data types ANYOBJ can be any valid Java class The ExternalCall function requires two parameters class or class name and method name Any parameters after the first two are considered to be parameters to the method being called The first parameter must be the fully qualified name of a class such as com acme stuff MyClass or it may be a previously created class instance stored in an Attribute of type Object If a class name is provided and the second parameter is the simple name of the class then a constructor with no arguments will be called and the res
87. cess that matches the input name To clear a color setting enter Clear for the color The following changes the color of the Activity Delay4 to Red ChangeColor Delay4 Red The following changes the color of the current Activity or Process to Blue ChangeColor Self Blue The following changes the color of the parent Process of the current Activity or Process to Yellow ChangeColor Parent Yellow The following clears the color setting of the Activity ChangeColor Sales Process Clear The ability to change colors of Entities is no longer supported For example the following code will now produce an error ChangeColor Entity Brown To change the color of the Activity icon to green if there is no Entity in it in the Activity s Release Entity event add IF NumberIn 0 ChangeColor Self Green END IF SIMPROCESS Users Manual 127 Appendix F SIMPROCESS System Attributes and Methods Methods ShowSystemAttributes and ShowUserAttributes These methods display all the system defined and user defined attributes with their current values of thecalling elementin the standard output window For example to display the system defined attributes of an Activity when an Entity enters in the Activity s Accept Entity event put ShowSystemAttributes All the system defined attributes and values are listed in the standard output window In a
88. cumentation set consists of four manuals gt Getting Started With SIMPROCESS SIMPROCESS User s Manual e SIMPROCESS Metadata Manual SIMPROCESS OrgModel Manual All of the manuals can be opened directly from the Help SIMPROCESS Manuals menu Also each manual includes this section which provides links to the chapters in every manual Press the Control key when clicking any link to open the linked file in anew window For Windows systems in order for links between manuals to work properly Adobe Acrobat or Acrobat Reader must be used to view the manuals Getting Started The Getting Started With SIMPROCESS manual is a must for first time SIMPROCESS users This manual can also be used for evaluation purposes The chapters are e Business Process Modeling With SIMPROCESS e Installation Building Your First Model With SIMPROCESS e Evaluating Alternatives With SIMPROCESS e Demonstration and Reference Models User s Manual The User 5 Manual is divided into four parts with each part being a separate file Part A is an excellent reference for beginners and casual users This part contains detailed documentation of the basic and intermediate functions of SIMPROCESS The chapters are e Process Modeling and Analysis with SIMPROCESS e SIMPROCESS Basics e Statistical Modeling Constructs e Activity Modeling Constructs e Resource Modeling Constructs e Graphical Modeling Constructs e Activity Based Costing e Statistical Outp
89. d Resource This method can only be used in the Start Run Ex pression Define Model Expres sions or Define Model Expressions button on the Model Toolbar ExpressionType is case sensitive and must be a valid Resource Ex pression type Start Simu lation Start Trial Get Resource Free Resource Start Downtime End Downtime End Trial or End Simulation The Ex pression parameter should be the complete Expression code in a single STRING or the complete file name with no path of the file that contains the Expression code If the Expression parameter is a file the file must located in the model s directory SetResourceShift ResourceName STRING NONE Applies a Resource Shift Define ShiftName STRING Resource Shifts to the specified Resource This method can only be used in the Start Run Ex pression Define Model Expres sions or Define Model Expressions button on the Model Toolbar SIMPROCESS User s Manual 118 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SetSimulationStart Start STRING NONE Sets the Start Date Time and or End End STRING the End Date Time for the model Overrides the Start Date Time and End Date Time values in the Run Settings This method can only be used in the Start Run Expression Define Model Expres sions or Define Model Expressions button on the Model Toolbar An empty STRING
90. ddition any related elements system attributes or user defined attributes will be listed in the output window as well For example ifthe ShowUserA ttributes method is called from the expression scriptin an Activity event such as Accept Entity the Entity that is within scope will also have its user defined attributes listed The same goes for Resources being assigned Model level user defined attributes are listed no matter what elements are within scope Method SimTime This method returns the current simulation time in hours unless a time unit parameter is provided The return value is REAL type For example Entity StartTime SimTime StartTime is a REAL global Entity instance attribute of type REAL The allowable time units are provided as a string parameter and are case sensitive The allowable time units are Years Months Weeks Days Hours Minutes Seconds Milliseconds Microsec onds Nanoseconds An example using the time units is as follows Mytimeunit STRING Mytimeunit Weeks OUTPUT My time unit in weeks SimTime Mytimeunit OUTPUT My time unit in months SimTime Months Methods OUTPUT and STATUS To display a message in the standard output window SIMPROCESS User s Manual 128 Appendix F SIMPROCESS System Attributes and Methods OUTPUT Number of orders currently held in Gatel0 is Num berIn realnum REAL OUTPUT The String value of realnum
91. during the run can be accessed using System Methods See Accessing Statistics During Simulation The Standard Report can be generated automatically after the run by selecting Generate Standard Report after run on the Statistics Collection dialog See Generating Standard Reports From Experiments To run a model with SPRunSimulation either execute commands from a command prompt or create a batch file or a shell script The command must include SPRunSimulation and the complete path to the model that is to be run as shown in this example for Windows SPRunSimulation C Program Files SIMPROCESS models Demos Purchasing spm The above is the simplest form for running a model without the GUI However model parameters see Globally Defining an Attribute from the Menu and process alternatives can be set as well as the number of replications In addition the simulation results can be automatically placed in the SIMPROCESS User s Manual 191 Appendix J Running Models Without GUI SIMPROCESS database and the model can be saved These options can be set either on the command line or by using a properties file Available Options The following options can be set on the command line or in a properties file The format of the option is always the name of the option followed with no spaces by an equals sign followed with no spaces by the value Any global attribute designated as a model parameter Model NumResource1
92. e TechnicianType time Put the name of the Resource i quantity _ Put InMap Model TechnicianNameMay expressions END WHILE Fs 7a resName DisposeResultSet Exp et status false units 5 pe Model NusTechniciantypes lt 0 expressionType Free Resource End simulation with error sql Select From Expressions Where Expression d 2 HALT No technician types define cost 20 0 END IF icon lt og techName n Finish Expression Disable BREAKPOINTS Stop Simulation Line 75 The Finish Expression button resumes execution of the Expression but ignores all remaining BREAKPOINT statements in the Expression This button causes the dialog to close and resumes the simulation The Disable BREAKPOINTs button closes the dialog and disables all BREAKPOINT statements in the model so the simulation runs without interruption This button does not change the setting of Enable BREAKPOINT Statements on the Expression Options tab of the Run Settings Thus if the model is run again the BREAKPOINT statements are active unless Enable BREAKPOINT Statements is deselected Once the BREAKPOINT statements have been disabled there is no way to reactivate them during the current run The Stop Simulation button closes the dialog and stops the simulation The Expand All and Collapse All buttons are available whenever the Resources Activities or Connecto
93. e Environment referenced by the SIMPROCESS program ext Directory This directory is a secondary location for adding external Java classes to SIMPROCESS The pre ferred location is the classes directory within a model s directory see Model Specific Java Additions and Method ExternalCall for more information dispatcher Directory This directory is only created if SIMPROCESS and Dispatcher is selected during installation The files are for using SIMPROCESS with a Web service See SIMPROCESS Dispatcher pdf for more information dispatchermodels Directory This directory is only created if SIMPROCESS and Dispatcher is selected during installation Model files that are to be opened and run through the SIMPROCESS Dispatcher must be located in this directory Uninstall_SIMPROCESS Directory Contains the uninstaller and related files Working Directory Directory for files and folders requiring write permission See SIMPROCESS Working Directory UserPreferences xml created on first run user preferences stored here UserFiles jar created when importing application graphics and SIMPROCESS User 5 Manual 31 APPENDIX C SIMPROCESS File Structure icons or when saving Libraries Experiments xml created when experiments are defined or imported All log and err files SPUser Directory sProcDB properties database connection properties required to use the SIMPROCESS database mysql sPr
94. e are finite only if shape gt 2 The Pearson type V distribution is closely related to the gamma distribution see the book Simulation Modeling and Analysis Third Edition by Law and Kelton 2000 for details Parameter restrictions are scale gt 0 0 and shape gt 0 0 SIMPROCESS User 5 Manual 60 Appendix D Statistical Distributions Pearson Type VI Distribution f Pearson Type VI Distribution x Plot for PT6 0 0 1 0 3 0 4 0 1 0 9 1 0 0 9 0 8 0 7 0 6 0 5 Probability rS 0 4 in mqeqoad apenn 03 F 0 2 0 2 0 14 0 1 00 05 10 15 20 25 30 35 40 45 50 55 60 65 70 Value PDF CDF Probability density function and cumulative density function for a Pearson type VI distribution with location 0 scale 1 shapel 3 and shape2 4 Syntax PT6 location scale shapel shape2 stream The Pearson type VI distribution continuous could be used to model the time required to perform some task The density function can take ona wide variety of shapes because it has two shape parameters shapel and shape2 The mean and variance are finite only if shape2 gt 2 The Pearson type VI distribution is closely related to the beta distribution see the book Simulation Modeling and Analysis Third Edition by Law and Kelton 2000 for details Parameter restrictions are scale gt 0 0 andshapel gt 0 0 SIMPROCESS User 5 Manual 61 Appendix
95. e from a BOOL File Spreadsheet or Database EAN Input Source If the value is a STRING number a REAL number will be returned even if the number has no fractional portion A BOOL EAN will be returned if the value from the File Spreadsheet or Database equals ignoring case TRUE or FALSE All other val ues are returned as a STRING See Input Sources for more information on Input Sources SIMPROCESS User 5 Manual 99 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description GetMapKey Map ANYOBJ INTE Returns from the designated map Index INTEGER GER the key specified by the index REAL BOOL EAN STRING ANYOBJ GetMapSize Map ANYOBJ INTE Returns the number of objects in GER the specified map EAN of a Result Set Returns TRUE if the Result Set has more values GetResource Resource Name STRING NONE Creates a get Resource request Units STRING INTEGER or for an Activity REAL Tag Optional STRING GetResourceStatistic Resource Name STRING REAL Returns the value of the Statistic STRING Value Type STRING Replication INTEGER requested Resource Name statis tic Statistic is one of the statistics types for Resources listed in the Labels column of the table in Appendix H See Statistic Types Value Type is either Avg StDev Min Max Count or RunLengt
96. e of type real from STRING the specified statistical distribu tion ElapsedTime Units Optional STRING REAL Returns the amount of time Start STRING between the Start value and End End STRING value The Units is optional and can be any valid time unit Sec onds Minutes etc If omit ted the value returned is in the units set by Simulation Time Unit in Run Settings Start and End use the format MM DD YYYY HH MM SS MSEC USEC NSEC The formats MM DD YY and YYYY MM DD can also be used for the date portion of Start and End The DateTime function can be used for Start or End EntityExists Gate OBJECT INTE Checks the specified Gate activ SequenceNum INTEGER GER ity obtained using the Gate Sys tem Method for an Entity with the specified SequenceNum Returns the position number of the Entity in the Gate This can be used with the GetEntity Sys tem Method to return a reference to the Entity If the Entity is not being held in the Gate activity 0 is returned SIMPROCESS User 5 Manual 9 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description EXP X REAL REAL Returns e raised to the power of X ExternalCall Class STRING or OBJECT BOOL Executes a method of an external Method Name STRING EAN Java class Assumes the class is in Method Parameters as re REAL the appropriate package structure quired by externa
97. e properties dialog for the TextLabel when assigning a Dashboard and will be unique for that Dashboard The fifth argument is the value to be displayed on the TextLabel It can be of type INTEGER REAL STRING or BOOLEAN For example the Call Center model has assigned the Call Status spd Dashboard file using the name Call Status The assigned Dashboard designated a Server Address of localhost and port 5555 This Dashboard contains a TextLabel by the name of Text Label 4 During simulation you want to display the number of Entities generated at a Generate Activity In the Release Entity expression of the selected Generate Activity add the following line UpdateDashboardLabel Call Status localhost 5555 TextLa be1l4 NumberGenerated SIMPROCESS Users Manual 129 Appendix F SIMPROCESS System Attributes and Methods While this statement may be used with any TextLabel on any assigned Dashboard it is best used with those that have no Plot Values assigned to it In that way you may be certain that the value you place on the TextLabel via this statement will remain unchanged until a subsequent statement updates it Method UpdateDynamicLabel To use this method you need to define a dynamic label in the work area first To define a dynamic label refer to For a list of System Methods available in SIMPROCESS refer to SIMPROCESS System Methods Five arguments are required for this method The first one is
98. e same level ofhierarchy First make sure no Activities or Processes have the same name this should have already been enforced by SIMPROCESS 2 2 Second make sure no Connectors or Pads have the same name as another Connector or Activity Process Pads cannot have duplicate names on the same Activity or Process but they can have duplicate names across Activities Processes A Pad cannot have the same name as an Activity or Connector Finally make sure everything Activity Process Connector or Pad has a name Version 2 2 2 and earlier will allow you to have Connectors without names Noticein the example below there are duplicate Connector names One set of these names will need to be changed for the model to import correctly A simple solution would be to add a 1 to each Connector name on the right Note that once the model has been imported the names can be changed back to the original Connection Req onnecuon Transpor Ack The next example shows a Process with a Pad that has the same name The Process Send Queue has a Pad named Send Queue This will cause errors during import SIMPROCESS Users Manual lI Appendix A Importing Version 2 2 1 Models Batching Send Queue Send Queue Tee Special Characters Names of Activities Processes Connectors or Pads cannot have single quotes These characters will cause errors in the XML parser For instance the name Can t Process will cause errors Other characters to avo
99. el that demonstrates SIMPROCESS Input Sources see Input Sources ExpressionDemos Subdirectory This directory contains models that demonstrate some advanced features of SIMPROCESS available through the SIMPROCESS Expression Language SIMPROCESS Expression Demo Models pdf which is located in this directory has a brief explanation of each model metamodel Directory Directory containing SIMPROCESS metamodels Metamodels must be saved to or opened from this directory or a subdirectory of this directory BPEL Subdirectory Contains collection of Business Process Execution Language BPEL metamodels that can be used to include BPEL metadata in a model AddressModel Subdirectory Contains supporting data for AddressModel metamodel CorporateInformation Subdirectory Contains supporting data for CorporateInformation metamodel SIMPROCESS User 5 Manual 33 APPENDIX C SIMPROCESS File Structure orgmodel Directory Directory containing SIMPROCESS Organization and Resource Models OrgModels OrgModels must be saved to or opened from this directory or a subdirectory of this directory Demos Subdirectory Contains two demonstration OrgModels dashboardserver Directory This directory contains the files required to run a Dashboard Server See Displaying Dashboards timeserver Directory This directory contains the files required to run the SIMPROCESS TimeServer See Time Server and SIMPROCESS TimeServer pdf
100. eral values with imbedded blanks must be enclosed in quotation marks when included in event records Real numbers must include a decimal point SIMPROCESS User s Manual 170 Appendix G External Events Files e Records beginning with an asterisk are considered comments and are ignored by SIMPROCESS SIMPROCESS User s Manual 171 Appendix G External Events Files Event Record Description In the following syntax diagram Items in BOLD face must be entered exactly as shown e Items in italic face represent variables for which you must substitute a value e Items enclosed in brackets are optional Syntax time QUANTITY value ENTITY type ATTR name value Parameters Indicates that the ensuing value is to be added to the time of the last event processed time The time at which entities are to be created for this event record Specify either a specific date and time or a relative value Use the following format for a specific date and time mm ddlyyyy hh mm ss Where for example January 15 2007 at noon is represented as 01 15 2007 12 00 00 You can enter either real numbers or integers to indicate relative values real numbers are assumed to refer to hours while integers refer to days Forty eight hours after the start of simulation is shown as 48 0 Which is the same as two days after the start of the simulation 2 Forty eight hours after the previous entity gen
101. eration event 48 00r 48 00 or 2 SIMPROCESS User s Manual 172 Appendix G External Events Files Notes on specifying event time You can omit seconds when specifying the time SIMPROCESS assumes a zero for the omitted parameter e Do not specify a time in hh mm without a date unless you precede it with a plus sign Although SIMPROCESS will accept this value its interpretation is unpredictable For example acceptable formats are 48 0 48 hours after the start of simulation 48 00 48 hours after previous generation event e SIMPROCESS will accept a 2 digit value for the year It assumes that values over 49 refer to years in the 20th century and values under 50 refer to the 21st century QUANTITY value The number of entities to generate at the entity generation event Enter a number in place of value If QUANTITY is omitted SIMPROCESS uses the default Quantity value in the Generate Activity Properties dialog ENTITY type The type of entity to generate For Type enter an entity type name If the name includes blanks enclose the entire string in quotes If ENTITY is not specified SIMPROCESS uses the default Entity value in the Generate Activity Properties dialog ATTR name value Assigns values to globally defined attributes for entity instances You can assign values to any number of attributes in the VARS argument The value you specify must be consistent with the data type defined for the attr
102. es to the objects ina system transaction Activity diagrams do not provide the dimensions needed to do robust business process analysis such as dynamic modeling entity flow simulations resource utilization queueing theory and cost based business metrics SIMPROCESS User s Manual 184 Appendix I Exporting to UML SIMPROCESS focuses on the functional and business work flow including manual physical processes that have nothing to do with the system but need to be understood and modeled in order to build a system to support the business properly and not just on the system transactions This is made clear when looking at how activities such as delays splits joins batching unbatching assembling etc are described for behavior in a SIMPROCESS model These are representative of business activities that people do in carrying out their jobs regardless of what interaction they have with the system In addition SIMPROCESS looks at the resources entities and workflow as a complete dynamic model that allows visualization of how the business works both from manual steps and system interaction This is important in order to match up the business transactions with the system transactions SIMPROCESS hasa more functional and business view and focuses on activity based costing metrics throughput bottlenecks timing re work and other business performance metrics regardless of the system that is supporting the business This is why business and f
103. esult is displayed in a message box with OK and Cancel buttons Pressing OK will continue this process again while Cancel will end the process fContinue BOOLEAN valuel value2 maxval minval REAL fContinue TRUE WHILE fContinue valuel DrawRealSample Exp 30 0 value2 DrawRealSample Exp 30 0 maxval MAXOF valuel value2 minval MINOF valuel value2 valuel DrawRealSample Uni REALTOSTR minval REALTO STR maxval Beep MasterEditor fContinue Confirm MasterEditor The value is REALTO STR valuel END WHILE SIMPROCESS Users Manual 126 Appendix F SIMPROCESS System Attributes and Methods Method ChangeColor This method changes the color of a non bitmap icon Currently Activity icon Rectanglelcon and Process icon DefaultIcon can change color The SIMPROCESS Color Table contains the 65 colors available in SIMPROCESS The name ofan Activity or Process can be specified or Self Parent or Activity can be used to designate the Activity or Process Note that in earlier versions of SIMPROCESS pre 4 1 Self Parent and Activity did not require quotes Earlier version models using those keywords must be modified to include quotes for use with SIMPROCESS 4 1 or later versions If an Activity or Process name is used SIMPROCESS will attempt to change the color of every Activity or Pro
104. f the Entity Type STRING instead of the Entity Type itself should be used For exam ple BatchEntityType Entity1 LastRelCount Get INTEGER Number of Entities released in the previous threshold trigger release TrigNextRel Both INTEGER Value of the trigger release quantity at Count the next trigger TrigFutureRel Set INTEGER Change the trigger release quantity Count for all future triggered release hence forth NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources NumberOnHold Get INTEGER Number of Entities at this activity holding for condition Generate Group I NumberGener Get INTEGER Number of Entities generated at this ated Activity Get Resource Group I amp II Number Waiting Get INTEGER Number of Entities at this activity waiting for resources Join Group I II amp III BatchEntities Both BOOLEAN Value for whether to batch family members with original Entity NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources NumberOnHold Get INTEGER Number of Entities at this activity holding for condition SIMPROCESS User s Manual 78 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Attributes Model Elements Attribute Name Get Attribute Description Set Type Merge Group I amp II Process Group I amp II Child name Get OBJECT For hierarchic
105. f this function is called on the Activity expres sion then the system attributes for any Entity or Resource ele ments will also be included in the Output dialog ShowUserAttributes None NONE Display all the User Defined Attributes evaluated for the call ing elements and any related ele ments that are within scope i e if this function is called on the Activity expression then the user defined attributes for any Entity or Resource elements will also be included in the Output dialog SIMPROCESS User s Manual 121 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SimTime Timeunit Optional STRING REAL Return current simulation time in Valid time units are Years time units specified If no Months Weeks Days Hours parameter is provided time unit defaults to the Simulation Time Minutes Seconds Unit set in the Run Setti Milliseconds Microseconds E ere a Nanoseconds Time unit strings are case sensitive SIN X REAL REAL Returns the Sine of X SOAPCall ContinueOnError BOOLEAN STRING Invokes methods or operations or STRING on Web Services See Method Endpoint URL STRING SOAPCall for more Service Name STRING information Service Port Type Name STRING Body namespace URI STRING Method namespace URI STRING SOAP action URI STRING Method to invoke STRING Parameters Optional
106. fied number if Threshold Release ON _ Batch released entities aa Trigger Release Quantity if Trigger Release ON Generate Generates entities Entity type Start and End dates Quantity Schedule Type Interval Schedule Items Get Obtains resources to be held Resources Resource during several activities Tag attached to allocation Join Reunites entities divided ata Family Name Batch family members Split activity Resources Delay Merge Merges entities and routes them in a single stream Replenish Adds units to consumable Replenish actions Resource Resource resources and Units Split Divides one entity into sev Family name Copy Priority eral to model the division of Resources processing among several pey activities Synchronize Coordinates the release of Number of Pads Resources various entities Delay SIMPROCESS User s Manual 26 Appendix B SIMPROCESS Activity Summary Activity Description Required Parameters Non standard Options Transfer Transfers entities from one Send or Receive Most standard options are portion of a model to another Local or Remote not available without a connector or trans i f Connection fers an entity to another SIM PROCESS model Transform Transforms arriving entities Number of Output Entities Copy Attributes from one type to another and Output Entity type Resource releases one or more of the Delay new type Unbatch Separates a batched entit
107. for downtime policy op tions other than Interrupt There must be at least one set of Weekday StartTime and End Time parameters Allowable op tions for Weekday are Sunday Monday Tuesday Wednes day Thursday Friday or Saturday StartTime and End Time are in Hours StartTime must be greater than or equal to 0 0 and EndTime must be less than or equal to 24 0 EndTime can be 0 0 only if StartTime is 0 0 If both are 0 0 then the com plete 24 hour day is assumed Since StartTime and EndTime must be REAL 7 30 AM would be entered as 7 5 Up to seven groups of Weekday StartTime and EndTime can be included Note that the groupings do not have to be in Weekday order SIMPROCESS User s Manual 88 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description CreateWeeklyRe Name STRING NONE Creates a Weekly Resource sourceDowntime ResourceName STRING Downtime for a specific Re UnitsDown REAL source This method can only be Planned BOOLEAN used in the Start Run Expres DowntimePolicy STRING sion Define Model Expressions or ReleaseAll BOOLEAN Define Model Expressions button Weekday1 STRING on the Model Toolbar The StartTimel REAL DowntimePolicy can be Idle EndTimel REAL Interrupt or Empty These Optionally to options correspond to Start Weekday7 STRING Downtime w
108. g Document Files Versions of SIMPROCESS prior to 3 stored model documentation in files in the model folder These files will not import automatically The document feature has been improved in version 3 and higher No longer is the documentation stored in separate files In version 3 and higher it is part of the model file For the documentation to be part of the model the text must be RTF The files in earlier version models are ASCII if NotePad was used to create the text or some other format if another text editor such as MS Word was used To import these files they must first be saved as RTF This is easily done in MS Word There is also shareware available on the internet that will convert ASCII files to RTF http www jafsoft com asctortf The names of the files converted to RTF are not important to SIMPROCESS Once the files are RTF simply click the Document button on the item for import There is a Document button on all Activity Process entity and resource properties dialogs Also there is Model Documentation on the Define menu Clicking the Document button brings up an RTF editor B Document Process File Edit Format Til Monospaced bescription Process2 Inputs Output Category VA NVA Owner From the File menu choose Read from File This allows you to read in the RTF document files which makes the file a part of your model file This must be done for every documentation file that was created for your 2 2
109. h A Replication of 1 returns the aver age of replications and a Replica tion of 2 returns the sum of replications SIMPROCESS User 5 Manual 100 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description GetResourceByAc Resource Name STRING REAL Returns the value of the tivityStatistic ActivityName STRING requested Resource Name and oe Hype sees Activity Name statistic Value Type ep ication is either Avg StDev Min Max Count or Run Length A Replication of 1 returns the average of replica tions and a Replication of 2 returns the sum of replications GetResourceByShift Resource Name STRING REAL Returns the value of the Statistic Shift Name STRING requested Resource Name and m Toe a Shift Name statistic Value Type is epiication g either Avg StDev Min Max Count or Run Length A Replication of 1 returns the average of replica tions and a Replication of 2 returns the sum of replications GetResult Result Set Name STRING INTE Returns a value from a Result Database Field STRING GER Set Type of value returned is nee dependent on the type of values BAN i in the requested field of the STRING Result Set GetTimeStampStatis Start Key STRING REAL Returns the value of the Time tic StopKey STRING Value Type STRING Replication INTEGE
110. he classpath to locate individual classes In order to use some of the SIMPROCESS special features that use external Java classes certain aspects of the classpath need to be understood There are three specific ways that the classpath can be used to support external Java classes in SIMPROCESS e Java Extension Mechanism e Model Specific Java Additions e ext Directory Please note that there are specific recommendations for when to use one over another as not all of them are equal SIMPROCESS User 5 Manual 194 Appendix K SIMPROCESS and External Java Classes Java Extension Mechanism The Java Extension Mechanism provides a way of adding things to the classpath without changes to any files installed with SIMPROCESS To use it JAR files containing needed Java packages must be placed where the Java Runtime Environment JRE will seek them when it needs to resolve a reference Since SIMPROCESS installs a JRE for its own use that location will always be the j re lib ext directory created by the installer Typical Use The most common use of the Java Extension Mechanism is to support using databases other than Microsoft Access with SIMPROCESS See SIMPROCESS and Other Databases In the example cited there database drivers for MySQL a popular open source database are required in order for SIMPROCESS to use it so one or more JAR files must be placed in this location Recommended Use When third party Java packages are
111. he method to be invoked requires passing parameters as most do the remaining parameters provided to the SOAPCall statement must be in matched pairs Each pair must include a string containing the name of the parameter and a value to be passed for the named parameter at invocation a Parameter name Refer to the lt binding gt element mentioned above It will contain a type attribute providing the namespace qualified name for a port type This will refer to a lt portType gt element with a name attribute whose value is the same The child elements of lt portType gt will be lt operation gt elements one for each available operation containing two key pieces of information i The value of the name attribute corresponds to the name of the method operation to be invoked ii The value of the parameterOrder attribute will list the names of all parameters that must be passed the values to be included here in the SOAPCall statement and the order in which they must appear b Parameter types Although SOAPCall can only invoke operations returning the xsd string or fully equivalent type as stated above it can invoke operations whose parameters are functionally compatible with the SIMPROCESS types INTEGER xsd int REAL xsd double STRING xsd string or BOOLEAN xsd boolean as defined in the SIMPROCESS User s Manual Internally SOAPCall checks the parameters passed to ensure that they are of the allowable S
112. he name of the Generate Schedule using a colon in between for example Gen eratel Periodic1 An empty STRING for Start or End indi cates that the Date Time from the Run Settings should be used for that argument Start and End use the for mat MM DD YYYY HH MM SS MSEC USEC NSEC The formats MM DD YY and YYYY MM DD can also be used for the date portion of Start and End The Time portion of Start or End can be omitted If omitted midnight is assumed Also if Time is included values for smaller time units can be omitted For example the time por tion can just be 08 00 All time val ues to nanoseconds are not required SIMPROCESS User s Manual 120 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SetWarmupLength Length REAL NONE Sets the warmup length for the Units Optional STRING model Overrides the Warmup Length value in the Run Settings This method can only be used in the Start Run Expression Define Model Expressions or Define Model Expressions button on the Model Toolbar The Units argument is optional and can be any valid time unit Sec onds Minutes etc If omitted the time unit value of Warmup Time Unit in Run Settings is assumed ShowSystemA ttri None NONE Display all the System Defined butes Attributes of the calling element and any related elements that are within scope i e i
113. hen Resource is StartTime7 REAL Idle Interrupt Activities and EndTime7 REAL Start Downtime when Resource Queue Empty Interrupt Activ ities includes the Release All Resources option The Release All parameter sets this option ReleaseAll is ignored for down time policy options other than Interrupt There must be at least one set of Weekday Start Time and EndTime parameters Allowable options for Weekday are Sunday Monday Tues day Wednesday Thursday Friday or Saturday Start Time and EndTime are in Hours StartTime must be greater than or equal to 0 0 and EndTime must be less than or equal to 24 0 End Time can be 0 0 only if StartTime is 0 0 If both are 0 0 then the complete 24 hour day is assumed Since StartTime and EndTime must be REAL 7 30 AM would be entered as 7 5 Up to seven groups of Weekday StartTime and EndTime can be included Note that the groupings do not have to be in Weekday order SIMPROCESS User s Manual 59 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description DateTime STRING Returns the current date and time of the simulation in MM DD YYYY HH MM SS MSEC USEC NSEC format DayOfWeek STRING Returns the current day of the week Monday Tuesday etc DeactivateGenerate Generate Name STRING NONE Ends the gener
114. his setSize 600 600 myPlot setSize 550 550 myPlot setButtons true myPlot setTitle My Plot myPlot setXLabel xLabel myPlot setYLabel yLabel myPlot setYRange 0 0 1 0 myPlot setXRange 0 0 20 0 myPlot setMarksStyle none myPlot setImpulses false 1 myPlot setConnected true 1 myPlot setBars false myPlot setSize 350 300 GridBagLayout gridbag new GridBagLayout GridBagConstraints c new GridBagConstraints SIMPROCESS Users Manual 140 Appendix F SIMPROCESS System Attributes and Methods getContentPane setLayout gridbag c gridx 0 c gridy 0 c gridwidth 1 gridbag setConstraints myPlot c getContentPane add myPlot show public void putTicks double time int num myPlot addPoint 1 time num first first false myPlot fi11Plot public void clearData myPlot clear true myPlot fi11Plot You should reference your RMI programming documentation for details on how to compile and start the server code as well as the RMI registry on a server computer Displaying Plots Remotely has examples on starting the RMI registry Once you have started the RMI registry and the SPServerDemoServer program you can run the demonstration model RemoteCall spm to demonstrate this capability Chapter 5 of the SIMPROCESS Getting Started Manual Demonstration and Reference Models has instructions on running this example When
115. ibute Note that if you specify an attribute name that has not been defined in your model you can select the Selected in the list option in the External File Schedule dialog SIMPROCESS will add it to the model If a record contains any syntax error or undefined model element without using Selected in the list option the entire event record is considered invalid and is bypassed SIMPROCESS User s Manual 173 Appendix G External Events Files Examples 1 Generate GreenDot entities at 3 a m on January 1 2014 Generate the number of entities defined in the Generate Activity Properties dialog 01 01 2014 03 00 00 ENTITY GreenDot 2 Generate six RedDot entities 7 hours after the simulation begins 7 0 QUANTITY 6 ENTITY RedDot 3 Generate four RedDot entities 7 hours after the previous entity generation 7 00 QUANTITY 4 ENTITY RedDot 4 Generate a Truck entity at 2 a m on January 3 2014 Assign a value of 50 000 to user attribute Weight and the string Yo Heavy to user attribute Tag 01 03 2014 2 00 ENTITY Truck ATTR Weight 50000 Tag Yo Heavy 5 Generate more Truck entities 4 hours after the previous event Generate the number of entities defined in the Generate Activity Properties dialog 4 0 ENTITY Truck 6 Generate two RedDot entities at 4 a m on January 3 2014 01 03 2014 04 00 00 ENTITY RedDot QUANTITY 2 Notes on the Examples If the examples are processed during a simulatio
116. ical Distributions 000cceceserersccscsescsceccscsccccecececcecccccees 35 Uniform Distribution cccsssssscsscccsssssssssscccccscssssssscceseseees 37 Normal Distribution ccccssssssssssscscscssssssssssccsscssssssccssesees 38 Triangular Distribution cccccccssscccsscccssscsccssscccsssscssseseees 39 PertBeta Distribution ccssssssssscccssssssssssscccsescsssssssscceseseees 40 Exponential Distribution cssccsssccssccsssscccsssssceeseseseeees 41 Gamma Distribution ccsssssscscccssssssssssscccscsssssssssceecssecsees 42 Beta Distrib wtiOn oi icssccesssscccccsdisaescssnccteecdestesnsivicnsceceets seedeentevcsees 43 Erlang Distribution e sseossoosooessoessseessocssoossoossosssssesssesssoossoossoe 44 Weibull Distribution ssescoececssssosoccecsssscsocccecsessssococeceesessssocecee 45 Lognormal Distribution eoesooessoesssessseessossoossssssssesssocssosssosssos 46 Poisson Distribution sseseessssccccececsssseccoececsesscocccccceessoscececsessoso 47 Hyper Exponential Distribution e sooosooosooesssesssesssocssoossossssoo 48 Uniform Integer Distribution se sseessooesooesoossosssssesssossoossossssse 49 SIMPROCESS User s Manual 3 Table of Contents Geometric Distribution ssscccccccscssssssssssssscccssssssssssscesscsees 50 Pareto Distribution ccccssssssssssscccsssssssssssccscsssssssssscceseseees
117. id are lt gt and In general spaces are not a problem However extra spaces will be ignored Therefore Process_ one space between Process and 1 isthe same as Process__1 twoormore spaces between Process and 1 Required Fields Some Activities have required fields For instance the Generate Activity needs an entity to generate Notice the Generate Properties Dialog below Ifno entities have been defined in the model and thus the Entity field in the Generate is blank errors will occur This same type of error could be caused by Assemble Batch and Transform Activities not having an entity type selected Also a Branch Activity with no attribute selected when branching by attribute has been set could cause errors during import SIMPROCESS Users Manual 12 Appendix A Importing Version 2 2 1 Models Generate Activity Properties Generate1 v Show Name Generate v Cancel Help fo l R Attributes 1 0 v Expressions Hours v Event Logs Schedule REEE Start End Periodic Periodic x New Entity Remove Text Block Collect Activity Statistics Collect Activity by Entity Statistics Comment Graphics If bitmaps were imported for the model gif jpeg or png versions of these bitmaps must be imported before importing the model SIMPROCESS User 5 Manual 13 Appendix A Importing Version 2 2 1 Models Graphical Import Results Ifthere are no errors all pro
118. iduals The differences between the actual values observed and the expected values as computed by astatistical test Sample Domain A domain whose range is the set of probability distributions supported by SIMPROCESS Skewness Characterizes the degree of asymmetry of a distribution around its mean A data set with positive skewness has a long tail to the right of its mean A data set with negative skewness has a long tail to the left of its mean SIMPROCESS User s Manual 68 Appendix E Statistical Tools Glossary Standard Deviation Square root of the variance Standard Error A measure of the spread of the data set about the mean Typically standard error is the one sigma error about the mean of the data set computed as the standard deviation divided by the square root of the number of data points Variance Variability of data set about the mean SIMPROCESS User s Manual 69 APPENDIX F SIMPROCESS System Attributes and Methods Chapter 2 of Part B Customizing a Model with Attributes and Expressions discussed user defined attributes SIMPROCESS also includes numerous predefined System Attributes and Methods Each is listed along with a description Also there are examples for several of the System Methods SIMPROCESS User 5 Manual 70 Appendix F SIMPROCESS System Attributes and Methods System Attributes This section lists all the SIMPROCESS system attributes in a table Model Elements
119. in nature such as Entities If temporary objects are placed into a hashmap it is important that they be removed before being disposed If not memory used by the temporary object will not be freed ClearMap should normally be used in the End Run expression It ensures that unneeded memory is freed at the end of the simulation ClearMap Model Map GetMapSize returns the number of objects in a hashmap This number can be used to iterate through the hashmap using GetMapKey in a FOR loop The type INTEGER REAL etc of the variable that will contain the key returned by GetMapKey must match the type of the key returned Thus it is recommended that all the keys be of the same type fora particular hashmap The example below shows iterating through a hashmap that contains Entities keyed by their SequenceNum Items should not be added to or removed from a hashmap when iterating through a hashmap size INTEGER count INTEGER key INTEGER entity ANYOBJ size GetMapSize Model Map FOR count 1 TO size key GetMapKey Model Map count entity GetFromMap Model Map key Alternatively the above two lines could be replaced with entity GetFromMap Model Map GetMapKey Model Map count IF entity HoldTime gt 200 0 entity Reject TRUE END IF SIMPROCESS User s Manual 153 Appendix F SIMPROCESS System Attributes and Methods END FOR Method BREAKPOINT BREAKPOINT assists with model
120. inding attribute providing a namespace qualified name for a binding though most WSDL files will only have a single binding service and port The namespace may or may not be relevant but the binding name found there will appear in the name attribute of a lt binding gt element see notes 1 and 2 The child elements of the lt binding gt element will be lt operation gt elements whose name attribute values correspond to the available methods Each lt operation gt element will have as children a lt soap opera tion gt element see the next parameter as well as a pair of lt input gt and lt output gt elements The lt input gt and lt output gt elements the information on both should be identical so choose one each contain a lt soap body gt child element See notes 3 and 4 for other important information about the lt soap body gt element This will contain a namespace attribute whose value will be the method namespace URI to be used for this parameter to SOAPCall e SOAP Action URI A string containing the SOAP Action URI The lt soap operation gt ele ment described above contains a single attribute named soapAction Its value will very often be an empty string though not always see note 5 Whatever value is found in that attribute should be provided for this parameter e Method operation to invoke A string containing the name of the method operation to invoke e Additional parameters optional If t
121. ing all the parameters or it may be included in line within the WSDL itself but this schema will be the source of information regarding number and types of parameters expected The invocation of a Web Service operation will be done by generat ing and compiling Java code using the other parameters to InvokeWebService then evaluat ing this list of parameter values against what s expected by the operation Here are some general guidelines e A parameter of type string corresponds to the STRING type in SIMPROCESS The INTEGER type in SIMPROCESS is compatible with the Java primitive type int or with Integer SIMPROCESS User 5 Manual 150 Appendix F SIMPROCESS System Attributes and Methods The REAL type in SIMPROCESS is compatible with the Java primitive type double or with Double The BOOLEAN type in SIMPROCESS is compatible with the Java primitive type boolean or with Boolean Any parameter for which you need to provide a Java null value should be passed as a STRING with null including the quotes as its value This will result in an error however if the method s parameter is a Java primitive type i e boolean int or double since those are not reference data types in Java Any value will be accepted if it is assignment compatible with the Java type indicated for the method parameter For example a value can be passed whose type might be a subclass of the method s parameter Any parameter which is not o
122. io 0 200 o 0 175 9 N gt 0 150 fad a oO ul Aquiqeqo d aaneinung 5 0 125 e E a 0 100 0 4 0 075 4 0 3 0 050 0 2 0 025 0 1 0 000 7 z z 5 7 z 0 0 3 0 3 5 4 0 4 5 5 0 5 5 6 0 6 5 7 0 Value PDF CDF x Probability density function and cumulative density function for a uniform distribution with minimum 3 and maximum 7 Syntax Uni minimum maximum stream or UniACM minimum maximum stream The uniform distribution continuous is equally likely to take on any real number in the finite interval minimum maximum minimum gt 0 0 and maximum gt minimum The real numbers produced by a random number generator appear to have a uniform distribution on the interval 0 1 SIMPROCESS User 5 Manual 37 Appendix D Statistical Distributions Normal Distribution p J A Normal Distribution Plot for Nor 10 0 1 0 1 0 400 1 1 0 0 375 0 350 0 9 0 325 0 8 0 300 Q gor 0 7 0 250 pales 0 6 amp 5 0 225 lt p een 3 0 200 0 5 Y 3 g 0 175 4 Q a 0 4 F 0 150 S 0 125 03 F 0 100 0 075 0 2 0 050 0 1 0 025 0 000 gt 5 7 5 0 0 6 7 8 9 10 11 12 13 14 Value PDF CDF x d Probability density function and cumulative density function for normal distribution function with mean 10 standard de
123. is available Once Rose is visible the Rose model can be modified as desired and the Rose model can be saved However any new Use Case Diagrams added will not automatically appear in the SSMPROCESS Use Case List window until it is closed and reopened After a Use Case Diagram is selected and the OK button is clicked the Use Case Diagram information will be added into the SIMPROCESS dialog as shown below The Use Case Diagram name and fully qualified name which includes the entire package structure in Rose are not directly editable To clear the Use Case Diagram connection simply select and clear the Selected Rose Model File field in this dialog and click OK To change the Use Case Diagram Selected the node to which SIMPROCESS is connected simply click on the Details button and choose another Rose Use Case Diagram from the Use Case Diagram dialog as described above xi OK Selected Rose Model File ipubssampletpubssample rmdl Browse 7 i ance Use Case Diagram Selected Main Help Fully Qualified Name Use Case View Main An important feature of this Use Case Diagram connection between SIMPROCESS and Rational Rose is that when the Rose model is published to HTML and the SIMPROCESS modelis published to HTML the SIMPROCESS HTML nodes will be automatically linked to the Rose Use Case Diagrams in the HTML For this feature to work the Rose published model must be in a directory named rose within the directory of the SIMPROCE
124. k for either input or output files in the directory of the active model Either file can be placed elsewhere as long as the path is specified in the OpenFile statement Note that double backslashes must be used instead of single backslashes in Windows file paths The following example opens a file myoutput dat for output First define a Model Attribute MyOutStream that is type Object If the file is to be opened in the Start Run Expression make sure that Do Not Reset Before Each Replication is selected on the attribute properties dialog If the file is opened in the Start Simulation or Start Trial expression the file will be opened each replication SIMPROCESS User 5 Manual 130 Appendix F SIMPROCESS System Attributes and Methods Type the following statement in one of the expressions Model MyOutStream OpenFile Output myoutput dat The next example opens a file myinput dat for input and keeps the return value in the model attribute MyInStream Model MyInStream OpenFile input myinput dat ReadFromFile reads the specified numbers of values from a file that is open for input The first argument is the input stream from a previous OpenFile call the file must be open for input From the previous example the model attribute Model MyInStream would be the input stream Following the stream argument is a list of variables whose values are going to be read in from the file ReadFro
125. l method INTE in a classes directory within INTEGER REAL STRING GER the model s directory or in a BOOLEAN OBJECT STRING properly constructed jar file in or OB the same location See SIM JECT PROCESS and External Java Classes for other options Er rors in the calls will result in an aborted simulation Note To use this call you must have purchased the External Ap plication Interface plug in license from CACI FireTrigger Activity Name STRING NONE Fires the trigger of the specified Gate or Assemble Activity FLOAT Number INTEGER REAL Converts the argument to REAL FLOOR X REAL INTE Returns the largest integer not GER greater than X FreeResource Resource Name STRING NONE Creates a free Resource request Tag Optional STRING for an Activity Consume Optional BOOL EAN Function Function Name STRING INTE Returns the value of a User Aig Value Optional GER defined Function Optional argu ATEA Value Opponal neg ment values can be included EAN l Local variables of the form Argl STRING Arg2 ArgN must be defined ArgNValue Optional REAL in the Function See User INTEGER BOOLEAN Defined Functions for more STRING information SIMPROCESS User 5 Manual 92 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description Gate Gate Name STRING OBJECT Re
126. lightly moving one of the Activities or Processes The images below demonstrate this The first shows the model as imported Notice that the Connectors do not connect with the Pads The second image shows that after a slight movement of one of the Processes the Connectors jump into place E SIMPROCESS Professional File Edit Layout View Create Define Simulate Report Experiment Tools Help Window Diam e x e x aje me W L e Lx 2 purchas k ur x eure iI REQUESTS PROCESS m PURCHASING PROCESSES Select Purchasing Process amp Click on the Properties Button next to the Run button to View Alternatives 15 SIMPROCESS User 5 Manual Appendix A Importing Version 2 2 1 Models E SIMPROCESS Professional a 5 x File Edit Layout View Create Define Simulate Report Experiment Tools Help Window Dicsltal e xlela x s aje mei jl cor EE Select Purchasing Process amp Click on the Properties Button next to the Run button to View Alternatives Another issue is a change in Pad rules for version 3 and higher A Connector cannot go from the output Pad of an Activity or Process to an input Pad of the same Activity or Process This rule is in place to help prevent infinite loops Thus ifa 2 2 2 model had a Connector from an output Pad of a Process to an input Pad of the same Process that Connector will not be in the impor
127. mFile Input Stream List of variables In the input file values should be separated by one or more white spaces i e space tab or new line characters There is also a pre defined special delimiter in SIMPROCESS You can use to separate values This delimiter is very useful to separate values strings that contain any white space You can surround the whole string with a pair of s and ReadFromFile will read in whatever is in between as one value The input file can contain comments Any characters that follow double slashes will be ignored The type of value to be read in is dependent on the specified variable type A mismatch will cause an error The following table shows the valid types for different value types Integer and real are any valid numerical values ReadFromFile will either truncate areal value to integer for an Integer type variable or float an integer value to real for a Real type variable String is a sequence of characters If spaces are included surround the whole string with Boolean can only be either TRUE or FALSE Any other value will cause an error Boolean values are not case sensitive Value Types in File Variable Types Integer Real String Boolean Integer OK Truncated Error Error Real FLOATed OK Error Error String OK OK OK OK Boolean Error Error Error OK Object Error Error Error Error SIMPROCESS User s Manual 131 Ap
128. model All of these files will be located in the model s folder and will have the extension doc SIMPROCESS User 5 Manual 24 APPENDIX B Activity Summary Table Activity Description Required Parameters Non standard Options Assemble Receives 2 or more entities Component Entity Resources and assembles them into a Assembled Entity Delay single entity for release RaichGadmonents Assign Assigns values to entity attri Entity Attributes Resources butes Delay Set Entity Priority Batch Stores entities until a condi Quantity to Batch Resources tion is met then releases Min Batch Size Delay them as one while retaining Max Hold Time their individual identity Batch Entity Type Branch Routes entities to different Branch Type Resources paths in the model network Delay SIMPROCESS User s Manual 25 Appendix B SIMPROCESS Activity Summary Activity Description Required Parameters Non standard Options Clone Clones entities Number of Entities Resources Delay Delay General purpose activity Delay Time Resources Dispose Disposes of entities Maximum entity Count Free Releases resources obtained Release actions Release all allocated Resource by Get Resource activities resources Gate Accumulates entities untila Threshold Release ON OFF Resources condition is met then Threshold Release Quantity Delay its a speci
129. models with the ability to invoke methods or operations on Web Services It supports Web Services of the RPC style see note 2 below that use the defaultSOAP encoding seenote3 whichis defined at http schemas xmlsoap org soap encoding The only methods that can be invoked are those which return data of the type typically called xsd string or a fully compatible type For more on the primitive data types see the W3C Recommendation at http www w3 org TR xmlschema 2 The SOAPCall statement requires a minimum of8 parameters In addition ifthe method or operation being invoked requires parameters the SOAPCall statement will need to be given names and values for each The following is a list of the SOAPCall parameters and a description of each including where to find them in a typical Web Services Description Language WSDL file e ContinueOnError A Boolean value indicating whether the simulation should continue pro cessing if an error occurs If false an error terminates the simulation if true an error will be ignored It s generally wise to use a false value at least until debugging has been completed The parameter used can be a BOOLEAN or a STRING as defined in the SIMPROCESS User s Manual When a string is passed any value when converted to lowercase letters other than true will be considered false e Endpoint URL A string containing the URL of the endpoint for the Web Service to be invoked Service Name
130. n Entity Type e Activity representing an Activity e Resource representing a Resource e TimeStamp representing a Time Stamp e Attribute representing an Attribute Owner Name This is the full hierarchical name of the specific object that owns this statistic record Name This is the name of the specific object that owns this statistic record Stat Type This is the type of statistic displayed Contained in the third column from the left the Stat Type is an abbreviation for the name of the performance measure whose parameters follow to the right See Statistic Types for a complete description of the types of statistics Replication This number is the replication that the statistic was collected from Any number or greater refers to a specific replication SIMPROCESS User s Manual 176 Appendix H Simulation Results File If the replication number is 0 the statistics are sum of all replications An 1 means that this statistic is the average of all replications Minimum This is the smallest value that has been recorded for this statistic Maximum This is the largest value that has been recorded for this statistic Sum It is the total of all observed values for the statistic i e X if this is observation based For time weighted it is the total of each observed value multiplied by the time that this value has persisted in i e X AT Sum of Squares It is the summation of the square of e
131. n which begins at midnight January 1 2014 the events occur at the following times January 1 2014 3 00 a m January 1 2014 7 00 a m January 1 2014 2 00 p m 14 00 January 3 2014 2 00 a m January 3 2014 6 00 a m Never The specified time is earlier than the time of the previous event so the record is discarded PO oP BON SIMPROCESS User s Manual 174 APPENDIX H Simulation Results File The Simulation Results file is generated from the File menu Select File Export Simulation Results to open the Save Statistics dialog The Simulation Results file will by defaulthavea xpt file extension and be saved to the current model directory This file is tab delimited and can be opened using a text editor or spreadsheet The file will contain the complete statistical measures corresponding to the reports selected for the current model This file give you raw statistical data that is displayed in the Standard and Custom Reports in a standard format that can be opened by many different applications SIMPROCESS User 5 Manual 175 Appendix H Simulation Results File Format of the Simulation Results File Each line of the exported simulation results file is a statistic recorded for objects such as Entity Types Activities or Resources Each record contains the following fields or columns Owner Type This is the type of the object that owns this statistic record The four types are e Entity representing a
132. nction and cumulative density function for a negative binomial distribution with s 5 and probability 0 5 Syntax NgB s probability stream The negative binomial distribution discrete with parameters s gt 0 0 and probability p can be thought of as the distribution of the number of failures before the sth success in a sequence of independent Bernoulli trials where success occurs on each trial witha probability ofp and failure occurs on each trial with a probability of 1 p A negative binomial distribution with parameters s 1 and probability p is a geometric distribution with probability p SIMPROCESS User 5 Manual 53 Appendix D Statistical Distributions Inverse Gaussian Distribution d 2 Inverse Gaussian Distribution OoN Plot for InG 0 0 1 0 4 0 1 Probability 9 9 9 99 O ph e a N Kte f w ul Aquiqeqo d aaneinung PDF CDF L n Probability density function and cumulative density function for an inverse Gaussian distribution with loca tion 0 scale 1 and shape 4 Syntax InG location scale shape stream The inverse Gaussian distribution continuous could be used to model the time required to perform some task Parameter restrictions are scale gt 0 0 and shape gt 0 0 SIMPROCESS User 5 Manual 54 Appendix D Statistical Distributions Inverted Weibull Distribution
133. nd checks to see ifthe number of Entities in the Gate is only one Both being true the Entity entering is the Trigger SIMPROCESS User 5 Manual 154 Appendix F SIMPROCESS System Attributes and Methods Entity anditcausesNumberIn to beone indicates that there are no fulfilled orders in the Gate Activity Thus BREAKPOINT is executed which causes the simulation to pause While paused the status of any item in the model can be examined in order to determine why there were no fulfilled orders when a truck arrived For example the Activities prior to the Gate Activities can be examined for bottlenecks or incorrect Entity routing If there appears to be a bottleneck any Resources required at the suspect Activity can be viewed to determine if the Resource levels are appropriate or if the actual last delay time is appropriate Bottom line is the BREAKPOINT statement not only shortens the time needed to identify the problem but also shortens the time needed to find the cause of the problem and fix it The second example whichisused to explain the dialog buttons shows how BREAKPOINT statements can be useful in verifying Expressions The longer the Expression the more likely there are errors but even short Expressions can have unrecognized errors That is the Expression may execute without any runtime errors but due to incorrect logic calculations variables or attributes the results are not correct This model ConfigureWithDatabase spminExpres
134. ndix F SIMPROCESS System Attributes and Methods are updated If there are no more BREAKPOINT statements in the Expression the dialog closes and the simulation resumes In the example below the simulation has paused at the end of an inner WHILE loop WHILE GetNext ExpUseSet expressionId GetResult Ex IF expressionId gt 0 Get the expression and set sql Select From Expre ReadFromDatabase Model Datal IF GetNext ExpSet expressionType GetResul expressionText GetResul SetResourceExpression name techName TechnicianType Put the name of the Resource ii PutInMap Model TechnicianNameMay END WHILE DisposeResultSet ExpSet IF Model NumTechnicianTypes lt 0 End simulation with error HALT No technician types defint END IF bo a Expression Model Attributes Entity Types Resources Activities Connectors Local Variables expressionText Expression ConfigureWithDatabase Start Run Simulation Time 0 0 Hours Simulation Date Time 01 01 2007 00 00 00 000 000 000 Value value INTEGER value GetAttributeValue Entity Na employeeExists true techCount 0 fieldName techArray orderDate count time quantity expressionid id resName status false units 5 expressionType Get Resource sql Select From Expressions Where Expressionld 1 cos
135. ne of the predefined types must be passed using a local variable or Attribute of type ANYOBJ It may be necessary to devise external Java code which can be called via the ExternalCall statement to construct and or convert values for this purpose For example the setModelParameters operation in the SIMPROCESS DispatcherService expects to receive a List lt String gt with the model parameters to be set Since SIMPROCESS cannot create this type of structure an array made using Cre ateArray can be populated then converted with external Java code and stored in an appropriate location for subsequent use as an operation parameter The InvokeWebService statement will always return a value If the operation being invoked does not return anything 1 e it represents a Java void method then a BOOLEAN value of TRUE will result upon successful invocation Otherwise InvokeWebService will return a value as specified in the WSDL and XML Schema An error will result ifthe type returned does not match the variable to which it is being assigned Notes 1 Some situations may arise when attempting to generate compile and execute Java code which will result in errors regardless of the ContinueOnError setting Some examples include Failure to create a temporary directory into which code can be generated Failure to generate Java code for the Web Service This could result from being unable to access the WSDL at the provided URL from a network failure or an
136. needed by SIMPROCESS the JAR files containing them can be placed in this location However it s recommended that this be done only when specifically necessary and when the model specific mechanism described in the next section is not appropriate In particular database drivers must use this mechanism as they are handled by SIMPROCESS itself Therefore the database drivers will not be sought in model directories Warning on Potential File Loss When adding JAR files to the jre lib ext directory of an installed copy of SSMPROCESS it s a good ideato keep copies of the original JAR files When SIMPROCESS is uninstalled the uninstaller program will unconditionally remove the entire j re directory thus removing any added JAR files In addition every new release installer will install a j re directory It s possible that this can result in the loss of JAR files added here So any such additions should be double checked any time a new installer is used SIMPROCESS Users Manual 195 Appendix K SIMPROCESS and External Java Classes Model Specific Java Additions As of release 4 4 SIMPROCESS provides a new way to use added Java classes Except in special circumstances e g database drivers this is the preferred way of adding Java code to SIMPROCESS When a model is opened by SIMPROCESS its model directory is created if not already present To use user provided Java classes with the model a new subdirectory named classes must be created
137. nual process steps activities and steps that are automated with information technology This capability ties the manual process steps and the automated process steps supported by Use Case links together so that the system requirements are in complete context with the business process This feature is licensed by CACI separately from SIMPROCESS and is only available with the Windows version of SSIMPROCESS For this feature to be active the additional license must be purchased and Rational Rose must be installed Rose Use Case links are added by selecting the Rose Use Case button on the Documentation tab on any activity properties dialog This button will only be enabled if the above criteria are met xi General Resources Attributes Expressions EventLogs TextBlock Documentation sane Document Help URLFile Browse I Is URL New Entity Link Name New Resource Global Attributes Rose Use Case Entity Entity Type Resource Model Comment Clicking Rose Use Case brings up the following dialog The path to a Rose model file can be entered or the Browse button can be used to select a Rose model file Once a Rose model has been selected a reference to it is stored in the SIMPROCESS model file for subsequent use this reference will be invalidated if the file is later moved or renamed The connection to a Rose model remains until the SIMPROCESS User 5 Manual 188 Appendix Exporting to UML m
138. o the left symmetric or skewed to the right if shape1 gt 0 shape1 0 or shapel lt 0 respectively The Johnson Sy distribution is closely related to the classical normal distribution see the book Simulation Modeling and Analysis Third Edition by Law and Kelton 2000 for details Parameter restrictions are scale gt 0 0 and shape2 gt 0 0 SIMPROCESS User 5 Manual 57 Appendix D Statistical Distributions Log Logistic Distribution d k 7 Log Logistic Distribution Plot for LLg 0 0 1 0 3 0 1 1 0 0 8 0 9 0 7 D 0 8 2 0 6 073 gt E Zoos 06 amp L3 8 go BET ar a 048 0 3 z 032 l 0 2 0 2 0 1 0 1 0 0 0 0 o0 05 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 Value PDF CDF L d Probability density function and cumulative density function for a Log Logistic distribution with location 0 scale 1 and shape 3 Syntax LLg location scale shape stream The log logistic distribution continuous could be used to model the time required to perform some task The mean and variance are finite only if shape gt 2 Parameter restrictions are scale gt 0 0 and shape gt 0 0 SIMPROCESS User 5 Manual 58 Appendix D Statistical Distributions Log Laplace Distribution g m Log Laplace Distribution h gt Plot for LLp 0 0 1 0 2 0 1 1 0 OEE
139. ocDB properties sample database connection properties for use with a MySQL database may serve as a template for other database tools SimProcDB mdb MS Access database Windows only simprocessdb sql sample DDL statements to create a simprocess database in MySQL for storing Experiment results may serve as a template for other database tools document Subdirectory This directory is used to customize headings for Activity Entity Connector Resource and model documentation Document button on properties dialogs The directory is empty initially The headings are customized with the use of text files that have the extension txt Each line of a file is considered a heading For instance the lines Activity Name Resources Used in a file would be considered two separate headings The contents of the t xt files completely replace the default headings Listed below are the names that can be used for the txt files e Activity txt changes the headings for all Activities e process txt changes the headings for processes e Entity txt changes the headings for Entity types e Resource txt changes the headings for Resources e Connector txt changes the headings for Connectors e model txt changes the headings for the Model Description Define menu The file Activity txt changes the headings for all Activities To change the documentation headings for a specific Activity name the file the same name as the t
140. odel file name is cleared and the OK button is clicked Ix x OK Selected Rose Model File l Browse Cancel Help Once a Rose model is connected to the SIMPROCESS model the Details button will connect SIMPROCESS to a licensed copy of Rational Rose using the Rational Rose Automation capability If a successful connection and load of the Rose model is completed this occurs in the background a window like the one shown below is presented listing all the Rose views and subordinate packages that contain Use Case Diagrams Note that ifapackage or view doesnotcontain any Use Case Diagrams it is not included in the window since the SIMPROCESS connection is to Use Case Diagrams only Use Case Diagram Selected Fully Qualified Name m m Utilizing this window a Use Case Diagram can be navigated to and selected to associate with the SIMPROCESS activity node Note that the structure in the dialog is a simple Tree structure that works like other graphical file directory trees Bvsecaene x I Rose Views B Use Case View a m OK Cancel Help lt B sronniderose A single Use Case Diagram can be selected by clicking on it and then clicking the OK button This SIMPROCESS User 5 Manual 189 Appendix Exporting to UML action will assign that Use Case Diagram to the SIMPROCESS activity node Optionally the Show Hide Rose button can be selected to bring the Rose tool and model up on the screen so that it
141. olumn widths can be adjusted by clicking and dragging the table header just above where the column divider exists in the table The mouse should change to indicate dragging is allowed Double clicking on highlighted items will open a dialog either displaying detail for the highlighted item ora list of Entities if the highlighted item represents a queue The Expression tab gives the name of the expression the current simulation time the current simulation date time and Expression information The Expression information contains the status of any local variables defined before the BREAKPOINT statement and any Entity Entity Type Activity or Resource information associated with the expression In the example above since there are no local variables defined and since it is an Activity expression there is information for the Entity instance the Entity Type and the Activity The Entity Type and Activity information is shown below The tables include all user defined attributes and system attributes for each item The example shows one user defined attribute for Entity instances cus tomer ID The remaining visible attributes are Entity system attributes SIMPROCESS User 5 Manual 157 Appendix F SIMPROCESS System Attributes and Methods IF ActivatedByTrigyer AND Numbert a Expression Model Attributes Entity Types Resources Activities Connectors Entity Type Information IF Name Value Priority
142. ory can be packaged and sent as a single unit The recipient can then open the model and simulate without having to import background and icon images orplace external Javaclasses in specific locations SIMPROCESS User 5 Manual 196 Appendix K SIMPROCESS and External Java Classes ext Directory The ext directory see ext Directory is included in the SIMPROCESS classpath This means Java code placed here will be accessible to SIMPROCESS when appropriate The code should be compiled and its package directory structure copied into the ext directory It is possible to use code without package statements in what Java refers to as the default package but this is not recommended and not officially supported by Sun though it will work In SIMPROCESS releases through 4 3 this directory was the only means ofusing loose Java classes those not in a JAR file with SIMPROCESS Java classes placed here were typically used with the ExternalCal11 System Method and other similar features This directory is still supported for such use but it is recommended that it only be used when multiple models need to share the same classes not necessarily simultaneously and when it s impractical to use the newer model specific mechanism described in the previous section Note that only loose Java classes may be used in this directory To use Java classes contained a JAR file use one of the other means described above SIMPROCESS Users Manual 1
143. paces must be in quotes The order of the parameters following the model is not important If Design and Scenario are omitted then the results are not committed to the database SIMPROCESS Users Manual 192 Appendix J Running Models Without GUI Setting Options Using Properties File The preferred method for setting parameters is to use a properties file The file can have any name as long as the extension is properties When using a properties file the properties file name follows the model on the command line SPRunSimulation C Program Files SIMPROCESS models Demos Purchasing spm C Program Files SIMPROCESS models Demos Purchasing Purchasing properties This example shows a file named Purchasing properties that is in the directory of the Purchasing spm model The following is an example ofa properties file Three model parameters are set one process alternative is set Purchasing the number of replications is set and the Design and Scenario are set The order is not important Do not include a Design and Scenario if the results of the run should not be committed to the SIMPROCESS database Model NumProdAPersonnel 6 Model NumProdBPersonnel 4 Model NumProdCPersonnel 4 Purchasing Centralized Functional Scenario sl Design New Design Replications 2 SIMPROCESS User s Manual 193 APPENDIX K SIMPROCESS and External Java Classes SIMPROCESS is a Java application During execution Java programs use t
144. pendix F SIMPROCESS System Attributes and Methods Example The input file contains This is a test for ReadFromFile 123 67 89 TRUE The expression reads as StrVal STRING IntVal INTEGER RealVal REAL BoolVal BOOLEAN ReadFromFile Model MyInStream StrVal IntVal ReadFromFile Model MyInStream RealVal BoolVal The expression will read in the following StrVal has the value This is a test for ReadFromFile IntVal1 has the value 123 RealVal has the value 67 89 BoolVal1 has the value TRUE WriteToFile writes the values of the specified variables to a file that is open for output The first argument is the output stream that is the returned value from a previously OpenFile call must be open for output Following the stream argument is a list of variables whose values are going to be written to a file WriteToFile Output Stream List of variables The output values will be written to the file consecutively Any kind of format or spacing has to be output explicitly by the user There are two special characters that can be used in formatting outputs A will write a tab to the file while will advance to a new line For these to work correctly they 6099 must be written individually and be surrounded by For example Following the prior example of ReadFromFile an expression has WriteToFile Model MyOutStream StrVal IntVal WriteToFile Model MyOutStream
145. perties will import However the screens will look different This is because version 3 0 or higher uses a different coordinate system from earlier SIMPROCESS versions There are several areas that will be quite noticeably different e Activity Process location e Activity Process size e Connectors not connected to Pads Specially drawn Connectors not correct e Text Blocks Static labels and Dynamic labels smaller Activity Process Location The drawing area for earlier versions of SSMPROCESS was a square The drawing area for version 3 is arectangle and is related to your screen size typically 1024 x 768 Thus Activities and Processes will be in positions relative to where they were in 2 2 1 or 2 2 2 The change from a square area to a rectangular area will cause some Activities or Processes to be out of place The two images below demonstrate this The first is from a 2 2 2 version model The second is after importing to version 4 Notice thatthetwo delay Activities may be higher or lower inrelation to the Process Pads in the imported model Check Credit At 2At h Out Check Credit Write Request Carry Checked Request Check Credit a Aadama a I Check Credit Write Request Carry Checked Request SIMPROCESS User 5 Manual 14 Appendix A Importing Version 2 2 1 Models Connectors And Pads Connectors may not be attached to the Pads This is due to the changing size of the icons This is easily fixed by s
146. pression Define Preempt BOOLEAN Model Expressions or Define Entity Stats BOOLEAN Model Expressions button on the Model Toolbar An error will occur if an Entity Type with the same name already exists in the model Default can be used for the Icon parameter Priority must be between 1 and 100 inclusive Preempt sets the Premept Lower Priority Entities prop erty and Entity Stats sets the Collect Entity Statistics prop erty CreateMap Type STRING OBJECT Returns a map of the specified type REAL INTEGER BOOLEAN STRING or ANYOBSJ Maps are not ini tialized to default values SIMPROCESS User 5 Manual 86 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description CreatePlot Type STRING OBJECT Creates plot and returns the Plot Title STRING object to an Attribute of type X Axis Label Optional Object The Type can be Trace or STRING Histogram The Type and the Y Axis Label Optional Title are required The axis labels STRING are optional but to have a Y Bin Width Optional INTE Axis Label there must be an X GER REAL Axis Label Bin Width is also optional and only applies to His togram plots It can be specified even if values for X Axis Label and Y Axis Label are omitted AddPlotLegend is used to add legends to the Plot PlotValue plots a new point DisplayPlot causes the plot to be vi
147. ributes that are being sta tistically monitored Value Type is either Avg StDev Min Max Count or Run Length A Replication of 1 returns the average of replica tions and a Replication of 2 returns the sum of replications GetAttribute Value AttributeName STRING REAL Returns the value of the specified INTE Attribute AttributeName follows GER the same convention as specify BOOL ing Attributes in Expressions EAN That is qualifiers Entity Enti STRING ty Type and Model might be re or quired before the Attribute name OBJECT such as Entity StartTime The object owning the Attribute can be specified by including a colon and the name of the object in AttributeName For example At tribute Time Disposel would return the Attribute named Time from the Activity Disposel The object reference can be an Entity Type Resource or Activity Note that using the object name is the only way to retrieve Resource Attributes SIMPROCESS User s Manual 95 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description GetConnectorStatis Connector Name STRING REAL Returns the value of the tic Statistic STRING requested Connector Name statis tic Statistic is one of the statistics types for Connectors listed in the Labels column of the table in Appendix H See Statistic Types
148. ribution See Auto Fits Distributions Thus the name of the Auto Fit distribution appears on the SIMPROCESS distribution list not the empirical distribution itself Empirical distributions consist of pairs of cumulative probability and value and can be discrete or continuous This is the same format as Tabular Distributions See Tabular Distributions SIMPROCESS User 5 Manual 63 APPENDIX E Statistical Tools Glossary Absolute Deviation The average deviation of the data set from the mean It is computed using the absolute value of the difference between a data point and the mean rather than squared differences used in computing the variance Alpha The probability that an estimate of a parameter does not contain the true value In statistics this is referred to as Type I error Alternate Hypothesis The complement of the null hypothesis Cdf Cumulative distribution function SIMPROCESS User 5 Manual 64 Appendix E Statistical Tools Glossary x goodness of fit test A goodness of fit test that uses an 2 statistic to evaluate the goodness of fit The y goodness of fit test creates an empirical distribution for the data The empirical distribution used is a histogram The height of each bin of the histogram is equal to the number of points in the data set that fall between the lower and upper bounds of the bin The y statistic is computed as the sum of squared differences of the values obse
149. rs tab is selected These buttons operate on the item trees on each tab Method InterruptEntity Interrupts the Entity specified by SequenceNum SequenceNum is the unique id number of the Entity The interrupted Entity is sent to the specified Local Receive Transfer Activity See Transfer Activity for information on the Transfer Activity Returns TRUE if the interrupt is successful See SIMPROCESS User 5 Manual 165 Appendix F SIMPROCESS System Attributes and Methods InterruptDemo spm in the ExpressionDemos directory Ifthe Entity is processing atan activity when the interrupt occurs any Resources obtained at the Activity are released Resources obtained at a Get Resource Activity or obtained using the GetResource expression statement without a corresponding FreeResource statement are not released If the Entity is waiting for Resources when the interrupt occurs the Entity is removed from the wait queue of each Resource before being sent to the Transfer Activity Ifthe Entity is holding fora condition in an Assemble Batch Gate Join or Synchronize Activity when the interrupt occurs the Entity is simply removed from the hold and sent to the Transfer Activity An Entity waiting at a Join Activity that is interrupted loses its Family reference Thus it is no longer considered when determining whether all family members are present at a Join activity Note though that any cloned Entity that is interrupted does not lose
150. rved for each bin of the histogram to the number of observations expected from the probability distribution over the same range as the bin Confidence Interval An interval that contains the true value of a parameter with a given probability Continuous Domain A domain whose variables can take on any value in an interval real numbers Integer domains are sometimes interpreted as continuous domains with the implicit assumption that the integers represent an underlying continuous domain Data Set A vector or equivalently an array or column of data points that are the realization ofa random process Degrees of Freedom The number of independent elements in a statistical computation The degrees of freedom must be known to compute the probability of a test statistic such as the x statistic Dof Acronym for degrees of freedom Enumeration Domain A domain whose range is the set of elements in the enumeration SIMPROCESS User 5 Manual 65 Appendix E Statistical Tools Glossary Goodness of fit test A Statistical test used to determine the probability that an observed data set came from a probability distribution The null hypothesis is that the data set is drawn from the probability distribution The alternate hypothesis is that the data set is not drawn from the probability distribution A test statistic is computed to evaluate the hypothesis If the probability of observing the test statistic is small less than alpha
151. s the simulation pauses and the BREAKPOINT Analyzer dialog SIMPROCESS User 5 Manual 156 Appendix F SIMPROCESS System Attributes and Methods displays gt BREAKPOINT Analyzer IF ActivatedByTrigger AND Numbert a Expression Model Attributes Entity Types Resources Activities Connectors Expression Build Shipment 2 Accept Entity Simulation Time 12 0 Hours Simulation Date Time 01 01 2006 12 00 00 000 000 000 Entity Information Attribute Value customer ID 0 Name Trigger Activity AcceptTime ActivityTime BatchSize CreateTime EndWait EnterTime BuildShipment2 12 0 0 0 0 12 0 false 12 0 HasParent true 0 0 false 0 0 2 2 0 0 0 Tigger 4 LastDelay Interrupt MaxWait NumberCreated NumberDisposed NumberWaiting NumberOnHold lt aua Parent Next Statement Finish Expression Disable BREAKPOINTS Stop Simulation Line 2 On the left is the Expression with the active BREAKPOINT statement highlighted On the right are six tabs Expression Model Attributes Entity Types Resources Activities and Connectors The line number of the highlighted BREAKPOINT statement is displayed at the bottom right The divider between the two sides can be moved by clicking on the divider and holding the mouse button down while dragging to the left or right Also for all tables the c
152. s File STRING OBJECT Creates a connection to the data StopOnError Optional base specified in the Properties BOOLEAN File The Properties File is the name of the file that specifies the URL and protocol to use When StopOnError is used and is FALSE if an error occurs the System Attribute UNDEFINED is returned and the simulation is not stopped SIMPROCESS Users Manual 107 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description OpenFile Mode STRING OBJECT Open the specified file and return File Name STRING the file stream object Mode can StopOnError Optional be input or output The File BOOLEAN Name String can contain path names if the user wants to explic itly tell SIMPROCESS where the file resides If path separators e g in Windows on other systems are used the program assumes the user is providing a complete and valid file path If no path separators are detected in the file name the Model s folder is where the files will reside Note that double backslashes must be used in Windows file paths in stead of a single backslash When StopOnError is used and is FALSE if an error occurs the System Attribute UNDEFINED is returned and the simulation is not stopped SIMPROCESS User s Manual 108 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods
153. scription INCLUDE File Name STRING NONE Specifies the name of an external file that contains Expression statements If no path is included then the file is assumed to be in the model s directory The Ex pression statements contained in the file replace the INCLUDE statement The File Name param eter can be either a STRING or a Model Attribute of type STRING When a Model Attri bute is used the file name re turned from the Model Attribute is the default value assigned when the Model Attribute was created If a different value is de sired the Model Attribute must be designated as a Model Param eter and the value changed at sim ulation start IncreaseCapacity Resource Name STRING NONE Increases the capacity of a Re Units INTEGER or REAL source by the units specified SIMPROCESS User s Manual 103 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description INPUT Message STRING NONE Reads a single value into Vari Variable INTEGER REAL able from a dialog prompt Vari BOOLEAN STRING able can be a local variable user Location Optional STRING defined Attribute or System At tribute that is type Set or Both The name of Variable will be in the dialog title and the Message will be displayed If Message is an empty String a default Message will be displayed The value entered will be validated For example an
154. seees 126 SIMPROCESS Color Table scsccosssssssscsssccsssscecssseness 168 Appendix G External Event FilE S se0000ss000sse0000sseoosssesossssoosssesossssoossseoo 169 General Rules for Event Files scccccscsssssssssssccsccecessesens 170 Event Record Description ccsccccssscccssccccssccssssescssseseesees 172 PUMA TINGS E E A EE E EE 174 SIMPROCESS User s Manual 4 Table of Contents Appendix H Simulation Results File sccccsccccssccccsscccsscccccccccescccescccesecsess 175 Format of the Simulation Results File ccccccsssssceccees 176 Appendix UML Interfa CES sista cisescinnasvessnccdsesshisspolssdovisansesebeousesdecssoseduessasiss 184 Exporting to UML seesseossoessoesssesssesssocssooessssssossssecssoossoossssssssse 186 R se Use CaS sS scsaccsssccnstsdasseccdadsssacecsvsausiisscascecssspuciadscnecstecssancecs 188 Appendix J Running Models Without GUI ssssssssssssssecsssooesssssssoosesssoseeesesso 191 Appendix K SIMPROCESS and External Java Classes cccccccccccccecesescecees 194 Java Extension Mechanism cccccccccssssssccssssscscssssssccsssssees 195 Model Specific Java Additions sscccsscccssscccssscscseseseesees 196 ext Directly so cccacccsessscsesseesestsnsestneneenisdoonssoouvdesunssdpsanieuensevadienseed 197 SIMPROCESS User s Manual 5 Organization of the SIMPROCESS Documentation Set The SIMPROCESS do
155. shape2 gt 0 0 The density function is skewed to the left symmetric or skewed to the right ifshape1 gt shape2 shapel shape2 or shapel lt shapez2 respectively A beta distribution with shapel shape2 is a uniform distribution with the interval 0 1 SIMPROCESS User 5 Manual 43 Appendix D Statistical Distributions Erlang Distribution d P Erlang Distribution Plot for Erl 1 0 3 1 Probability oO oO p N N S E a ie A E W W pa ul a N ao wo Ayuiqeqo d apenuno 9 Fa 0 0 5 F 5 7 5 0 00 O25 O50 075 1 00 1 25 1 50 1 75 2 00 2 25 2 50 27 Value o PDF CDF Probability density function and cumulative density function for an Erlang distribution with mean 1 and shape 3 Syntax Erl mean shape stream The Erlang distribution continuous could be used to model the time required to perform some task If an Erlang distribution has parameters mean m and shape a then b m a is a scale parameter An Erlang distribution is just a gamma distribution whose shape parameter is a positive integer The sum of k exponential random variables with mean m is an Erlang distribution with mean km and shape k Parameter restrictions are mean gt 0 0 and 0 0 lt shape lt 100 0 SIMPROCESS User 5 Manual 44 Appendix D Statistical Distributions Weibull Distribution Weibull Distribution Plot for
156. sible and ClearPlot clears the plot of all data CreateResource Name STRING NONE Creates a Resource This method Units REAL can only be used in the Start Fractional BOOLEAN Run Expression Define Model Consumable BOOLEAN Expressions or Define Model Resource Stats BOOLEAN Expressions button on the Model Resource by Activity Stats Toolbar An error will occur if a BOOLEAN Resource with the same name Resource by Shift Stats already exists in the model BOOLEAN SIMPROCESS User 5 Manual 87 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description CreateResourceShift Name STRING NONE Creates a Resource Shift for a ResourceName STRING specific Resource This method UnitsA vailable REAL can only be used in the Start DowntimePolicy STRING Run Expression Define Model ReleaseAll BOOLEAN Expressions or Define Model Ex Weekday1 STRING pressions button on the Model StartTimel REAL Toolbar The DowntimePolicy EndTimel REAL can be Idle Interrupt or Optionally to Empty These options corre Weekday7 STRING spond to Start Downtime when StartTime7 REAL Resource is Idle Interrupt Ac EndTime7 REAL tivities and Start Downtime when Resource Queue Empty Interrupt Activities includes the Release All Resources op tion The ReleaseAll parameter sets this option ReleaseAll is ig nored
157. sionDemos directory has a complex Expression that runs when the simulation starts that reads in data from a database For this example a BREAKPOINT statement was placed in the inner WHILE loop of an outer WHILE loop By including a BREAKPOINT statement at the end of the inner WHILE loop the simulation pauses at the end of the inner loop so that as the data is being read in it can be verified This example only shows one BREAKPOINT statement in an Expression but there can be multiple BREAKPOINT statements within the same Expression Get the different types of technicians sql Select From TechnicianTypes ReadFromDatabase Model Database Set sql WHILE GetNext Set Count the number of technician types Model NumTechnicianTypes Model NumTechnicianTypes 1 name GetResult Set TechnicianType id GetResult Set TechnicianId Get the number of each type of technician by querying the Employees table and counting the number of employees for each technician type sql Select Count EmployeeId As EmployeeCount From Employees Where TechnicianId INTTOSTR id ReadFromDatabase Model Database EmpSet sql IF GetNext EmpSet Resource units will be the number of the employees whose TechnicianId matches the current TechnicianType units GetResult EmpSet EmployeeCount ELSE End simulation with error SIMPROCESS User s Manual 155 Appendix F SIMPROCESS System Attributes
158. stem Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SetEntityTypeEx EntityTypeName STRING NONE Applies SIMPROCESS Expres pression ExpressionType STRING sion code in the specified Expres Expression STRING sion parameter to the specified Entity Type This method can only be used inthe Start Run Expression Define Model Expres sions or Define Model Expressions button on the Model Toolbar ExpressionType is case sensitive and must be a valid Entity Type Expression type Start Sim ulation Start Trial Initialize Entity Dis pose of Entity End Tri al orEnd Simulation The Expression parameter should be the complete Expression code in a single STRING or the complete file name with no path of the file that contains the Expression code If the Expression parameter is a file the file must located in the model s directory SetRandomNumber Option STRING NONE Sets the type of random numbers Option to use for the simulation This method can only be used in the Start Run Expression Allow able options are Legacy Mersenne Twister or MT same as Mersenne Twister SIMPROCESS User 5 Manual 116 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description SetReplications NumReps INTEGER NONE Sets the number of replications for the model Overrides the Num
159. stribution of the number of customers that arrive to some system in any time interval of length 1 when the interarrival times have an exponential distribution continuous with mean 1 m Mean must be greater than 0 0 SIMPROCESS User 5 Manual 47 Appendix D Statistical Distributions Hyper Exponential Distribution z gt Hyper Exponential Distribution Som Plot for Hex 5 0 10 0 0 5 1 0 15 1 0 0 14 0 9 0 13 0 12 esi 0 11 2 r 0o75 0 10 z 0 09 0 6 2 Kapa 0 08 m g 5 05 9 o 0 07 Q 0 06 0 4 S 0 05 03 0 04 lt 0 03 0 2 0 02 a 0 1 0 01 0 00 j z 0 0 OO 25 S0 2s nln 125 50 47 5 00 25 50 275 3010 32 5 Value PDF CDF Hyper exponential distribution with mean1 5 mean2 10 and probability1 0 5 Syntax Hex mean1 mean2 probability1 stream The hyper exponential distribution continuous is a mixture of two exponential distributions Specifically ahyper exponential distribution with parameters mean1 mean2 and probability1 takes on values from an exponential distribution with parameter mean1 with a probability of probability1 and takes on values from an exponential distribution with parameter mean2 with a probability of 1 probability1 A hyper exponential distribution with probability1 1 is an exponential distribution with parameter mean1 Parameterrestrictions aremean1 gt 0 0 mean2 gt 0 0 and0 0 lt probability
160. t 20 0 icon techName LaraductCount Next Statement Next BREAKPOINT Finish Expression Disable BREAKPOINTS Stop Simulation Line 75 Since the BREAKPOINT statementis within two loops clicking Next BREAKPOINT will cause the loops to execute until the BREAKPOINT statement is reached again Note that by clicking Next BREAKPOINT once the value of the local variable expressionId changes from to 2 and the value of the local variable expressionType changes from Get Resource to Free Resource The value of the local variable sql also changed but the change is not visible without adjusting the Value column SIMPROCESS User 5 Manual 164 Appendix F SIMPROCESS System Attributes and Methods WHILE GetNext ExpUseSet Expression Model Attributes Entity Types Resources Activities Connectors Express TONTA gan GEUREA Ex Expression ConfigureWithDatabase Start Run IF expressionId gt 0 Get the expression and set Simulation Time 0 0 Hours sql Select From Expre Simulation Date Time 01 01 2007 00 00 00 000 000 000 ReadFromatabase Model Datat Local Variables IF GetNext ExpSet Variable Value expressionType GetResul expressionText value INTEGER value GetAttributeValue Entity Na expressionText GetResul employeeExists true SetResourceExpression nam techCount 0 END IF fieldName techArray orderDate count techNam
161. t Number of entities of the value is specified type that recorded entered the activity bytokenhere Only the last Number of entities of the value is specified type still resid recorded ing in the activity bytokenout Only the last Number of entities of the value is specified type that have recorded left the activity bytokenoutearly Only the last Number of entities of the value is specified type that left recorded the activity without pro cessing tokendelay Observation Total cycle time i e sum based of wait hold and pro cess at this activity tokenwaitdelay Observation Time waiting for avail based able resource at this activity tokenholddelay Observation Time waiting for condi based tion to be reached at this activity SIMPROCESS User s Manual 181 Appendix H Simulation Results File Type of Labels Statistics Descriptions tokenprocessdelay Observation Time processing entities based i e in the specified dura tions at this activity bytoken delay Observation Total cycle time i e sum based of wait hold and pro cess for the specified entity type at this activity bytokenwait delay Observation Time waiting for avail based able resource for the specified entity type at this activity bytokenhold delay Observation Time waiting for condi based tion to be reached for the specified entity type at this activity bytokenprocess delay Observation Time processing en
162. t Number of entities still value is residing in this connector recorded tokentotalout Only the last Number of entities that value is have left this connector recorded bytokenin Only the last Number of entities of the value is specified type that recorded entered the connector bytokenhere Only the last Number of entities of the value is specified type still resid recorded ing in the connector bytokenout Only the last Number of entities of the value is specified type that have recorded left the connector tokendelay Observation Total cycle time at this based connector bytoken delay Observation Total cycle time for the based specified entity type at this connector tokenlevel Time weighted Number of entities in this connector bytoken level Time weighted Number of entities of the specified type in this con nector Activities tokentotalin Only the last Number of entities value is entered this activity recorded SIMPROCESS User s Manual 180 Appendix H Simulation Results File Type of Labels Statistics Descriptions tokentotalhere Only the last Number of entities still value is residing in this activity recorded tokentotalout Only the last Number of entities that value is have left this activity recorded tokentotalearlyout Only the last Number of entities that value is left the activity without recorded processing bytokenin Only the las
163. t accompanied by a UML Class Diagram The Activity Diagram includes the Diagram information for Rational Rose only The XMI activity information can be imported into any UML tool other than Rational Rose that supports XMI by simply deleting the Diagram information at the bottom of the XMI file that is created from the export process The other type of interface is an active link between activity nodes on a SIMPROCESS model and Use Case Diagrams in a Rational Rose model This interface requires a Microsoft Windows version of SIMPROCESS and a licensed copy of Rational Rose Each type of interface is described in more detail in the following sections SIMPROCESS User s Manual 185 Appendix Exporting to UML Exporting to UML This capability can be used by selecting File Export UML Activity Model from the SIMPROCESS menus It outputs the model to a UML compatible XML file No dialog is displayed for this export operation The file is created in the model s directory with a xm1 extension and is compatible with Rational Rose including diagram information The XMI file may be compatible with other UML tools as well such as the ArgoUML open source tool but diagram information intended for Rational Rose will not be compatible with other UML tools To import the model into Rational Rose Rational Rose must have the Import Export XMI plug in installed This plug in can be obtained from the Rational Rose web site www rational com Once it is
164. t be between 1 and the number of replications defined for the simulation or be 1 for average of replication re sults a System methods names must be input as shown They are case sensitive b This argument i e MasterEditor must be the first argument inside the parentheses of this method It is required by the method and must be input as shown It is case sensitive c Since this method does not require any argument do not include empty parentheses when using this method SIMPROCESS User 5 Manual 125 Appendix F SIMPROCESS System Attributes and Methods System Method Examples Many of the System Methods described here are demonstrated with models in the ExpressionDemos directory Included in that directory is SIMPROCESS Expression Demo Models which describes each model If this directory is not part of the SIMPROCESS models directory it can be downloaded at www simprocess com Methods Alert and Beep For example to display a message and sound alarm when an Entity enters an Activity put the following lines in the Activity s Accept Entity event Beep MasterEditor Alert MasterEditor Press OK to continue Methods Confirm DrawRealSample MINOF MAXOF and REALTOSTR This example demonstrates the syntax and usage of the listed methods It draws a number from a Uniform distribution whose minimum and maximum parameters are results from an Exponential distribution with a mean of 30 The r
165. t soap body gt element within each lt operation gt element optionally namespace qualified as per note 1 should contain an attribute named use This attribute should have a value of encoded if its value is literal the SOAPCall statement cannot be used with this service 4 The lt soap body gt element within each lt operation gt element optionally namespace qualified Nn 6 see note 1 should contain an attribute named encodingStyle Its value should be http schemas xmlsoap org soap encoding which defines the standard encoding for SOAP 1 1 If any other URL is used it may not be possible to use SOAPCall with this service Many services will indicate that the SOAP Action URI is only meaningful if the transport is HTTP Because SIMPROCESS is a Java application it uses HTTP transport automatically in most environments so this value should always match that found in the WSDL file If it isn t needed the environment will transparently discard it There is no limit to the type of information that can be exchanged between client applications and Web Services using SOAP There is however a practical limitation to how the SOAPCall statement can be prepared in advance to interact with Web Services chosen by SIMPROCESS users Internally SIMPROCESS uses what is known as the Dynamic Invocation Interface to build and invoke the call to a Web Service operation Other available approaches require prior knowledge of
166. ted model This is easily fixed by placing another Activity like a Merge between the two or having the loop occur within the Process In the example below the Re scan Connector in the 2 2 2 model is not allowed in 3 0 or higher The solution is to have the loop within the Process Re scan Redo Scan Cards SIMPROCESS User 5 Manual 16 Appendix A Importing Version 2 2 1 Models Place Loop Within Process Re scan Try better scanning process PAL b lt Quick Scan Out Decision after 1 scan Increment Status By 1 Re evaluate after 2 poor scans Ready to Classify After 1 Scan Ot hat Bo Slow Scan Decision after 2 scans k Scan Again Second Scan OK b gt 2 h Out h ag Failed Scan Counter Store Card in File Also Pads may be arranged differently Pads will be on the correct side of an Activity or Process but they may be in a different order Notice that the Pads on the right side of the Process Pending Queue are swapped The first image is from the 2 2 2 model and the second is from the imported model Pads on other Activities like the Clone Split Assemble and Gate may be swapped as well i Pending Queue Send Queue In To Pending Q Pending Queue Specially Drawn Connectors Connectors are drawn by clicking on the output Pad of one Activity and then clicking on the input Pad of another Activity These Connectors will default to a bent Connector Special paths for SIMPROCE
167. the Process or Activity was resized In SIMPROCESS 3 and higher the text blocks were improved to allow the font attributes font type color size and style to be set This requires using the fonts native to your system Therefore the font will not scale as a Process or Activity is resized During conversion the default font attributes are used The default font attributes may not fit the Process or Activity or the default font attributes may be too small for the Process or Activity The model below is a2 2 2 model The image that follows shows the imported model Notice that for the outer two Processes the text blocks are too large and for the Process in the middle the text block is too small Also notice the location difference of the center Process For the Processes where the text block is too large either the Process can be sized larger or the text block can be sized smaller The third image shows the corrections The two outer Processes were sized larger The font size was set larger for the text block for the center Process and the font style was set to bold Finally the Align option on the Edit menu was used to line up the Processes SIMPROCESS User 5 Manual 19 Appendix A Importing Version 2 2 1 Models GENERATE PURCHASING COMPLETE PURCHASE PROCESSES PURCHASING REQUESTS PROCESS CENE P REQUESTS PROCESS PURCHASING PROCESSES PURCHASING GENERATE COMPLETE PURCHASE PROCESSES PURCHASING REQUESTS P
168. the following section Records must also adhere to these general rules Each record in the file defines one generation event There is no way to continue a record on the following line The keywords ENTITY QUANTITY etc followed by a colon or equals sign must nothave any spaces between thecolonor the equals sign and must not have any spaces between the colon or equals sign and the value associated with the keyword The keywords and values are case sensitive Records must be ordered by entity create time SIMPROCESS will not generate entities for any eventrecord whose entity create time is earlier than that of the previously processed event For example in the following sequence of creation dates 1 01 02 2014 2 01 04 2014 3 09 11 2013 4 10 30 2013 5 01 12 2014 Records 1 and 2 are processed Record 3 is bypassed because its creation date is earlier than that of record 2 Record 4 is also bypassed because its date is earlier than that of record 2 the last record for which entities were generated Entity create time must be the first field in the event record The remaining keyword parameters may be entered in any order The entity type you specify in an event record must be defined to the model before it can be generated However you can refer to a new type in the event file and select the Selected in the list option in the External File Schedule dialog SIMPROCESS will automatically add it to the model Any lit
169. ties SIMPROCESS User 5 Manual 136 Appendix F SIMPROCESS System Attributes and Methods throws RemoteException boolean clearData throws RemoteException SPServerDemoImp1 java defines the implementation code for the server class and methods This example instantiates a user defined class that uses the Ptolemy plotting classes This plot is being presented on the screen to the user by the server program separate from the SIMPROCESS simulation The data being fed to the plot is coming from the simulation and the RemoteCall parameters shown above The Java code is as follows package com caci demo import java rmi import java rmi server import java util import ptolemy plot import ptolemy plot plotml public class SPServerDemoImpl extends UnicastRemoteObject implements SPServerDemo public SPServerDemoImp1 throws RemoteException myplot new SPPlotDemo Number Entities Simulation Time in Hours SIMPROCESS User s Manual 137 Appendix F SIMPROCESS System Attributes and Methods public boolean putPlotData double simtime int totalEntities throws RemoteException myplot putTicks simtime totalEntities return true public boolean clearData throws RemoteException myplot clearData return true private String name SPPlotDemo myplot SPServerDemoServer java defines the server binding to the RMI registry This is necessary for Java
170. tional STRING Model Expressions button on the Model Toolbar Name should be a unique name that contains no spaces or special characters An error will occur if an Attribute with the same Name and same Type already exists Allowable Type values are Entity Entity Type Resource Activity or Model Owner should either be Global or the name of the Attribute owner The Attribute owner can be an Entity Type Resource or Activity Mode can be INTEGER REAL BOOL EAN STRING or OBJECT The Default Value should match the designated Mode If OBJECT is the Mode UNDEFINED or Null should be entered for the DefaultValue The remaining parameters are optional They can be included in any order and not all have to be used Array Size sets the array dimension of the Attribute A value of 0 indi cates that the Attribute will not be an array Attribute If DoNo tReset is TRUE the Attribute will not be reset between replica tions This parameter only applies to global Attributes It will be ignored for local Attri butes StatType can be Observa tion TimeWeighted or None This parameter is ignored for Entity Attributes SIMPROCESS User 5 Manual Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description CreateEntityType Name STRING NONE Creates an Entity Type This Icon STRING method can only be used in the Priority INTEGER Start Run Ex
171. tities based i e in the specified dura tions for the specified entity type at this activity tokenlevel Time weighted Number of entities at this activity tokenwaitlevel Time weighted Number of entities wait ing for available resource at this activity tokenholdlevel Time weighted Number of entities wait ing for condition to be reached at this activity tokenprocesslevel Time weighted Number of entities in process i e at duration at this activity bytoken level Time weighted Number of entities of the specified type at this activity SIMPROCESS User s Manual 182 Appendix H Simulation Results File Type of Labels Statistics Descriptions bytokenwait level Time weighted Number of entities of the specified type waiting for available resource at this activity bytokenhold level Time weighted Number of entities of specified type waiting for condition to be reached at this activity bytokenprocess level Time weighted Number of entities of the specified type in process i e at duration at this activity UDV delay Observation Statistic of the specified based attribute UDV level Time weighted Statistic of the specified attribute Time Stamps tokendelay Observation Time elapsed between based Time Stamps SIMPROCESS User s Manual 183 APPENDIX UML Interfaces SIMPROCESS and Unified Modeling Language UML tools complement each other b
172. tity was re leased FALSE otherwise SIMPROCESS User s Manual 111 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description RemoteCall Server URL STRING BOOL Executes a method of a remote Server Name STRING EAN application Assumes a Java RMI Method Name STRING server has been registered with Method Parameters as re the objects and methods being quired by remote method IN called Errors in the calls will re TEGER REAL STRING sult in an aborted simulation BOOLEAN Note To use this call you must have purchased the External Ap plication Interface plug in license from CACI RemoveFromMap Map ANYOBJ INTE Removes and returns from the Key INTEGER REAL GER RE designated map the value refer BOOLEAN STRING ANY AL enced by the specified key OBJ BOOL EAN STRING ANYOBJ REPLACE Stringl STRING STRING Returns a string that is in String position1 position2 INTE with part of String from position GER 1 to position 2 replaced with String2 STRING String2 Resource ResourceName STRING OBJECT Returns the reference to the spec ified Resource ROUND number REAL INTE Rounds the argument and returns GER the closest integer value SIMPROCESS User s Manual 112 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description
173. to create when an Type Assemble occurs BatchEntities Both BOOLEAN Value for whether to batch compo nent Entities with assembled Entity NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources NumberOnHold Get INTEGER Number of Entities at this activity holding for condition Assign Group I II amp III NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources Batch Group I II amp HI BatchEntityType Both OBJECT Type of Entity to create when a Batch occurs Note that when BatchEntity Type is used to set the Entity Type for the Batch the name of the Entity Type STRING instead of the Entity Type itself should be used For exam ple BatchEntityType Entity1 MaxBatchSize Both INTEGER Number of Entities to batch MinBatchSize Both INTEGER Number of Entities must be in a batch before it can be released Max WaitTime Both REAL Time to wait before releasing under size batch NumberWaiting Get INTEGER Number of Entities at this activity waiting for resources NumberOnHold Get INTEGER Number of Entities at this activity holding for condition SIMPROCESS User s Manual 76 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Attributes Model Elements Attribute Name Get Attribute Description Set Type Branch Group I II amp Ul BranchName
174. ttributes Entity Types Resources i IF S J Supply Resources BR Clerk 1 ie I Clerk 3 B Clerk 4 IR Factory Driver R Supply Driver Expand All r Collapse All Next Statement J Next BREAKPOINT J Finish Expression Disable BREAKPOINTS Stop Simulation Line 2 Double clicking a highlighted item will display additional detail Inthe example above double clicking ORDER ENTRY 2 will display the detail for that Activity Attribute Value Name ORDER ENTRY2 HasParent true Parent Entity NumberAccepted NumberReleased 1 LastDelay 0 30428419555696473 The detail dialog also has highlighted items that can be double clicked For example double clicking NumberIn will display a list of the Entities in the Activity ORDER ENTRY 2 Double clicking Number Waiting will display a list of the Entities waiting for a Resource at ORDER ENTRY 2 If the above dialog is closed and NumberWaiting is double clicked on the Resources tab a list of all Entities waiting for Clerk 2 is displayed SIMPROCESS Users Manual 162 Appendix F SIMPROCESS System Attributes and Methods i Entity Name SequenceNum lj 591 592 Clicking a column header will sort the table in ascending order based on the values in that column Holding the Shift key when clicking a column header will sort
175. turns a reference to the speci fied Gate activity Returns UNDEFINED if not found GenerateEntity Generate Name STRING Entity Name Optional STRING Quantity Optional INTE GER Time Optional REAL NONE Generates Entities from the spec ified Generate Activity If Entity Name is not specified the default defined for Entity Type in the specified Generate Activity is used If Quantity is not specified or the Quantity is zero or less the default Quantity in the desig nated Generate Activity is used If Time is not specified the action occurs at the current simu lation time Time is in the Simula tion Time Units set in the Run Settings Each of the optional parameters can be specified without including any of the other optional parameters GetActivityStatistic Activity Name STRING Statistic STRING Value Type STRING Replication INTEGER REAL Returns the value of the requested Activity Name statistic Statistic is one of the statistics types for Activities listed in the Labels column of the table in Appendix H See Statistic Types Value Type is either Avg StDev Min Max Count or RunLength A Replication of 1 returns the aver age of replications and a Replica tion of 2 returns the sum of replications SIMPROCESS User s Manual 93 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods
176. ult returned any additional parameters will be ignored It should then be stored inan Attribute of type Object for use in future calls as SIMPROCESS will notretain a reference to the newly created instance The following is an example of invoking a constructor Model MyClass ExternalCall com acme stuff MyClass MyClass In subsequent calls the instance can be used as in this example MyString STRING MyString ExternalCall Model MyClass getString Method names must be unique for the class That is SIMPROCESS looks for a method on the class by name only The number of parameters is not considered The named method must take the same number and type of arguments in order as those provided in additional parameters to ExternalCall It s possible to invoke static methods on either an instance of the class or by providing its qualified name See ExternalCall spm in the ExpressionDemos directory Some examples SIMPROCESS User 5 Manual 143 Appendix F SIMPROCESS System Attributes and Methods MyString STRING MyString ExternalCall com acme stuff MyClass getString This example returns a string value The getString method has no parameters number REAL number ExternalCall com acme stuff MyClass getSquare 100 0 This example returns a REAL double value The getSquareRoot method has one parameter double boolval BOOLEAN boolval ExternalCall
177. unctional representatives prefer SIMPROCESS for the business modeling it speaks their language SIMPROCESS focuses on the business concerns and not all the system modeling notations and methods which often confuses functional people The dynamic modeling capabilities for business metrics are non existent in UML modeling tools This is appropriate since UML tools are system analysis design and development tools not process and workflow modeling tools There is a clear gap between business analysis and systems analysis SIMPROCESS focuses on the business analysis and UML tools focus on the systems analysis Clearly both are needed from business requirements to systems requirements to system design to system development They work hand in hand and not in opposition to each other This gap in business analysis and systems analysis is the basis for the SIMPROCESS to UML interfaces These interfaces use the complementary strengths of both UML and SIMPROCESS to provide customers a complete toolset for business and systems modeling SIMPROCESS has two basic interfaces to UML One is the ability to export a SIMPROCESS model to a UML Activity Diagram The export to Activity Diagrams is based on the standard UML XMI specification and provides a transfer of the SIMPROCESS activities and connectors to UML activities and transitions In addition SIMPROCESS Entities and Resources are exported as UML Classes with attributes included however the classes are no
178. unlimited NumberIn Get INTEGER Number of Entity instances of the same type currently in the system NumberCreated Get INTEGER Number of Entity instances of the same type has generated NumberDisposed Get INTEGER Number of Entity instances of the same type has disposed NumberWaiting Get INTEGER Number of Entity instances of the same type waiting for resources NumberOnHold Get INTEGER Number of Entity instances of the same type holding for condition Parent Get OBJECT Returns the Parent Entity instance of this Entity instance An Entity instance only has a Parent when it was created by a Split Activity The original Entity instance entering the Split Activity is the Parent Returns UNDEFINED if there is no Parent Priority Both INTEGER Priority of this Entity instance Processing Get BOOLEAN TRUE if the Entity is processing at an Activity ReleaseTime Get REAL Time Entity is released from an Activity or Process SequenceNum Get INTEGER A unique number given to each Entity as it is created Type Get OBJECT Entity Type reference of this Entity instance WaitingForRe Get BOOLEAN TRUE if the Entity is waiting to source obtain one or more Resources SIMPROCESS User s Manual 73 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Attributes Model Elements Attribute Name Get Attribute Description Set Type
179. urtosis has a flatter peak than the normal distribution Maximum Likelihood Estimate A statistical technique for estimating the parameters of a hypothesized distribution of a data set Mean Average value of a data set MLE Acronym for maximum likelihood estimate Mode The mode of a probability distribution is the value of X where it takes on its maximum value If the distribution is multiply peaked there may not be a unique mode Model Element A named object in the simulation model that has one or more simulation input variables that can be designated as factors for an experiment The model elements include Activities Resources and Entity types Pdf Probability density function Performance Measure An output statistic that quantifies some behavior of the model SIMPROCESS User 5 Manual 67 Appendix E Statistical Tools Glossary Percentiles Ina data set ranked by value of the data points a percentile refers to the data point at the relative position 5th by rank of the data point in the data set For example ina data set ofa hundred points the 75 percentile 75 point is the data point that is in the 75 position when ranked by value Quartile Range Difference between the 25 percentile value and 75 percentile value of the data set Range Difference between the minimum and maximum values of a data set Real valued Domain A domain whose range is the set of real numbers Res
180. ut Reports Part B is a reference intended for advanced users of SIMPROCESS This part contains detailed documentation of the programming and library management functions in SIMPROCESS Professional Edition The chapters are e Reusable Templates and Libraries e Customizing a Model with Attributes and Expressions e More Advanced Model Building e Exporting Results Part C describes the integrated tools included with SIMPROCESS Professional The chapters are e Advanced Data Analysis SIMPROCESS Database e Experiment Manager OptQuest for SIMPROCESS SIMPROCESS Dashboards e Model Bundles e Custom Reports e Scenarios The Appendices are e Importing Version 2 2 1 Models e Activity Summary Table e SIMPROCESS File Structure e Statistical Distributions e Statistical Tools Glossary SIMPROCESS System Attributes and Methods e External Event Files e Simulation Results File e UML Interfaces e Running Models Without GUI e SIMPROCESS and External Java Classes Metadata Manual The Metadata Manual describes how to build and edit SIMPROCESS metamodels assign metamodels to a SIMPROCESS model and enter metadata in a SIMPROCESS model The chapters are e SIMPROCESS Metadata e SIMPROCESS Metamodel Editor e Assigning Metamodels e Entering Metadata e BPEL Metadata OrgModel Manual The OrgModel Manual describes how to build and edit SIMPROCESS Organization and Resource Models OrgModels and assign OrgModels to a SIMPROCESS model The ch
181. viation 1 There are two normal distributions in SIMPROCESS One only returns non neg ative values zero or higher and the other will return negative values For both it is required that standard deviation gt 0 0 Syntax Nor mean standard deviation stream or NorACM mean standard deviation stream returns only non negative values This distribution is similar to the classical normal distribution but if a negative value is generated it is rejected and new values are generated until a non negative value is generated In general this distribution will not be a good model for the time required to perform some task since task time distributions are almost always skewed to the right Syntax Nrm mean standard deviation stream unbounded This is the classical normal distribution which is found in most statistics books It takes on real values between minus infinity and plus infinity The density functionis the familiar bell shaped curve which is symmetric about the mean The probability that a value is between the mean minus 2 standard deviations and the mean plustwo standard deviations is approximately 0 95 This distribution should not be used to model the time required to perform some task since the normal distribution can take on negative values Furthermore as stated above the distribution of the time to perform some task is almost always skewed to the right rather than being symmetric SIMPROCESS User 5 Manual 38
182. wise changing Also if the distribution of the random variable Xhas a location parameter of 0 then the distribution of the random variable Y X has a location parameter of J A scale parameter b determines the scale or unit of measurement of the values in the range of the distribution The standard deviation is a scale parameter for the normal distribution A change in b compresses or expands the associated distribution without altering its basic form Also if the random variable Xhas ascale parameter of 1 the distribution of the random variable Y bXhas ascale parameter of b A shape parameter a determines distinct from location and scale the basic form or shape of a distribution with the general family of distributions of interest A change in a generally alters a distribution s properties e g skewness more fundamentally than a change in location or scale Some distributions e g exponential and normal do not have a shape parameter while others e g beta and Pearson type VI may have two The last parameter of each distribution is the stream number This is the random number stream that will be used to general random values from the distribution Possible values for stream are 1 2 215 with 1 being the default SIMPROCESS User s Manual 36 Appendix D Statistical Distributions Uniform Distribution d Uniform Distribution Plot for Uni 3 0 7 0 1 0 250 Le 0 225 S
183. ws only Licensing file non Windows SIMPROCESS User s Manual 29 APPENDIX C SIMPROCESS File Structure hostid txt hostid bat hostid sh License htm Import Procedures pdf SPSYSTEM Directory InstallSettings win xml dows only InstallSettings 1nx xml only commons beanutils jar commons collections jar commons digester jar commons io jar commons logging jar dom4j jar iText jar jasperreports jar java image scaling jar java2rei jar jcalendar jar jdt compiler jar jfreechart jar jgraph jar jh jar metamodel jar modelfit mpxj jar OptQuest plot jar poi jar poi ooxml jar poi ooxml schemas jar poi scratchpad jar jcommon jar Jar jar simprocess jar simext jar SPRemote jar webservices extra jar webservices extra api webservices rt jar webservices tools jar xalan j jar xbean jar GetStart pdf jar defaults for some preferenc defaults for some preferenc Documen Licensing file Licensing file Windows only Licensing file non Windows SIMPROCESS License agreement tation for importing 2 2 1 models SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file SIMPROCESS executable jar file S
184. y using Gate System Attribute NumberOnHold less than or equal to the number of Entities waiting for the Resource obtained by using Resource System Attribute Number Wait ing or less than or equal to the number of Entities in the batch obtained by using the Batch System Attribute BatchSize GetEntityBySequen SequenceNum INTEGER OBJECT Returns a reference to the Entity ceNum specified by SequenceNum Returns UNDEFINED if the specified Entity does not exist SIMPROCESS User 5 Manual 98 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Return Description g p GetEntityStatistic Entity Name STRING REAL Returns the value of the Statistic STRING Value Type STRING Replication INTEGER requested Entity Name statistic Statistic is one of the statistics types for Entities listed in the Labels column of the table in Appendix H See Statistic Types Value Type is either Avg StDev Min Max Count or RunLength A Replication of 1 returns the aver age of replications and a Replica tion of 2 returns the sum of replications GetFromMap Map ANYOBJ INTE Returns from the designated map Key INTEGER REAL GER the value referenced by the spec BOOLEAN STRING ANY REAL ified key OBJ BOOL EAN STRING ANYOBJ GetInputSourceValue Input Source STRING REAL Returns the next valu
185. y Resource into its constituent parts Delay Retain Batched Entity Unbatch Nested Batches SIMPROCESS User 5 Manual 27 APPENDIX C SIMPROCESS File Stru cture The SIMPROCESS installation program creates two directories called SIMPROCESS unless a dif ferent name is chosen during installation The two directories are the installation directory and the working directory The SIMPROCESS working directory is created in the user s home directory see SIMPROCESS Working Directory Note that on Linux systems it is possible that the installation and working directory are the same See SIMPROCESS Working Directory In these directories there are a number of important files and subdirectories The primary subdirectories are SPSYSTEM System Directory SPUser and the models directory This appendix briefly describes the structures and contents of the directories The basic directory structures are listed below Note that the dispatcher director y only exists if the SIMPROCESS Dispatcher is installed Some of these directories can be opened in the system file explorer from the File menu File Open Directory SIMPROCESS installation directory SPSYSTEM SPHelp jre ext dispatcher optional dispatchermodels optional Uninstall SIMPROCESS SIMPROCESS working directory SIMPROCESS User 5 Manual 28 APPENDIX C SIMPROCESS File Structure SPUser document Sample
186. y be specified Allowable values are All Processing WaitingForResource or HoldingForCondition Ifno Entity State parameters are specified or an Entity State parameter is All Entities in all states processing waiting for Resources or holding for a condition are interrupted count INTEGER count InterruptActivity Delay5 Transfer12 Specifying an Entity State does not produce an error if the Activity being interrupted does not cause an Entity to enter that state For example count INTEGER count InterruptActivity Delay5 Transfer12 HoldingForCondition does not cause an error for a Delay Activity even though Delay Activities do not have the state Hold For Condition If the specified Activity is a Process all Activities within the Process are interrupted including Activities within subprocesses There is no way to set the interrupt order of the Activities in the Process thus if interrupt order is important multiple InterruptActivity statements should be used SIMPROCESS User 5 Manual 167 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS Color Table 0 HM Black 33 E SandyBrown 1 White 34 E Gold 2 E Red 35 Goldenrod 3 E Green 36 LightGrey 4 E Blue 37 MediumGoldenrod 5 Yellow 38 DarkOliveGreen 6 E Cyan
187. y bridging the gap from business analysis to systems analysis SIMPROCESS is used for the business process models and UML tools are used for the systems models These tools work together in documenting the operational architecture of a business They communicate the content of the business requirements and the systems requirements and designs by using both notations in combination UML based tools suchas Rational Rose focus on Systems Modeling to help define requirements model designs and develop object oriented code such as Java Rational Rose is one of the leading tools on the market for system modeling activities in a software development life cycle but other capable tools support the UML standard UML tools do not fully address the functional business process modeling requirements For example Use Cases and Activity Diagrams are the only views UML has for modeling any part of the business process but they still focus on the system needs in the models rather than the function or business steps For instance Use Cases show Actors usually people interacting with objects usually realized as object oriented components such as Java classes This helps to understand the system transactions but does not model the full breadth of the business workflow or process Activity diagrams similarly model activity steps that can be used to model business flow diagrams but typically focus on objects and transition of states between objects based on chang
188. y in the requested time unit If no parameter is provided time unit defaults to the Simulation Time Unit set in the Run Settings TRUNC number REAL INTE Returns the integer part of the GER number UpdateBackground Background Graphic Name NONE Update a Background Graphic to Graphic STRING show a named background im Background Image Name age STRING UpdateDashboardLa Dashboard Name STRING NONE Update the specified TextLabel bel Host or IP Address STRING with the given value Port INTEGER TextLabel Name STRING Value INTEGER REAL STRING or BOOLEAN SIMPROCESS User s Manual 123 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Methods Method Name Arguments Description UpdateDynamicLa MasterEditor Update the specified dynamic la bel Label Name STRING bel with the given value Label ID INTEGER Font Color STRING Value Same as Label s Mode WriteToDatabase Database Connection OB Used to modify tables of the data JECT base specified by the connection SQL Statement STRING The SQL Statement should be of Check Warnings Optional type INSERT DELETE or UP BOOLEAN DATE After the execution of the the SQL Statement the default is to check for SQL warnings Check Warnings should be used and set to FALSE to suppress the check for SQL warnings WriteToDatabase Name STRING Executes a predefined SQL state Replication INTEGER ment with the requested
189. y of a variety of other causes There will often be additional information available in the error file Failure to compile the generated Java code There will often be additional information available in the error file Certain errors occurring when executing the generated and compiled Java code are also fatal These include being unable to obtain a ClassLoader to access the generated code or being unable to obtain an instance of the class representing the Service Name or Ser vice Port Type Name provided Most other errors will respond according to Continue OnError SIMPROCESS User s Manual 151 Appendix F SIMPROCESS System Attributes and Methods 2 Depending on the developer of a Web Service and the toolset s used the element names appearing in a WSDL file may be qualified with a namespace For instance the structure of a WSDL file is mandated by standard which is sometimes referred to via namespace so that all the elements ina WSDL file may be qualified like lt wsdl service gt or lt wsdl operation gt When this approach is used there will be a namespace reference in an attribute on the root element of the WSDL file suchas xmlns wsdl http schemas xmlsoap org wsdl indicating the namespace prefix e g wsdl and the URI of the namespace Much of the above information is based on the assumption that WSDL file elements are not namespace qualified as is true of SMPROCESS DispatcherService Methods CreateMap PutinMap
190. ype of the Activity along with the txt extension Some examples are delay txt replenishResource txt assem ble txt and getResource txt Notice that the type of the Activity must be spelled out completely with no spaces in the file name Not all files are required If only the document headings for Entity types need to be changed then Entity txt is the only file that needs to exist SIMPROCESS User s Manual 32 APPENDIX C SIMPROCESS File Structure There are sample files in the SampleFiles document directory SampleFiles Subdirectory This directory contains the source code for the files in the com caci demo package in SPRe mote jar Also sample batch files and scripts that start the Java RMI Registry SPServer and SPPlotServer are included which can be copied and used as templates if desired There is a docu ments subdirectory that contains sample files for modifying document headings document Subdirectory Contains sample files for documentation headings models Directory SIMPROCESS defaults to this directory as its starting point when saving or opening models Demos Subdirectory This directory contains demonstration and reference models See Chapter 5 of the SIMPRO CESS Getting Started Manual Demonstration and Reference Models for a discussion of each model It also contains a sample Dashboard file see SIMPROCESS Dashboards and a sam ple SIMPROCESS bundle see Model Bundles that contains a mod
191. ys Set REAL Change the value of all future delays henceforth Activity s Group Name Get STRING Name of the Activity I Parent Get OBJECT Reference of this Activity s parent process Entity Get OBJECT Reference of the current Entity Sibling name Get OBJECT It returns the reference to the Activity STRING or process with the specified name in the same hierarchical level Returns UNDEFINED if not found Activity s Group NumberAccepted Get INTEGER Number of Entities so far entered this I Activity NumberReleased Get INTEGER Number of Entities exited this Activ ity NumberIn Get INTEGER Number of Entities currently at this Activity Activity s Group LastDelay Get REAL The value of the most recently initi Il ated delay NextDelay Set REAL Change the value of the next delay ONLY AllFutureDelays Set REAL Change the value of all future delays henceforth Assemble Group I II amp III ActivatedByNo Get BOOLEAN Checks if the expression is activated Match by an Entity exiting through the NoMatch Pad SIMPROCESS User s Manual 75 Appendix F SIMPROCESS System Attributes and Methods SIMPROCESS System Attributes Model Elements Attribute Name Get Attribute Description Set Type ActivatedByTrig Get BOOLEAN Checks if the expression is activated ger by an Entity entering from the Trigger Pad AssembleEntity Both OBJECT Type of Entity

SIMPROCESS User`s Manual Appendices

Contents

Download Pdf Manuals

Related Search

Related Contents