Activity Properties

The Activity properties that are available through the Visual Logic Set Value editor are listed below.

Read and Write Properties

The Activity properties that are editable through the Visual Logic Set Value editor are:

Batching Out Size

Changes the fixed value in the Batching Distribution.


 Set Activity1.Batching Out Size = 10: sets the value used in Routing Out, Batching to 10

Change Over Time

Sets the fixed value used in the Change Over Distribution.


 Set Activity1.Change Over Time = 5: changes the change over time to 5.

Efficiency Repair Time

Sets the Repair time in Detailed Efficiency to a fixed value.


 Set Activity1.Efficiency Repair Time = 5

(can also be a Global Data Item or Distribution)

Efficiency Work Time

Sets the Time Between Breakdowns in Detail Efficiency to a fixed value.


 Set Activity1.Efficiency Work Time = 100

(can also be a Global Data Item or Distribution)

Fixed Type Label Value

Used with Batch By Type to set or change the fixed Label value used to source items.


 Set Activity1.Fixed Type Label Value = 4

The Activity will only pull items with the value 4 in the label nominated for use with Batch By Type.

Ignore Blocked Routes

Sets the Activity Routing Out Property check box for. Ignore Blocked Routes to either Checked or not Checked.


Check the box:

 Set Activity1.Ignore Blocked Routes = 1

Uncheck the box

 Set Activity1.Ignore Blocked Routes = 0:

Ignore Starved Routes

Works with the Routing In option Circulate to only pull from routes that contain Work Items.


Checks the box so ignore starved routes and pull from the next route in the list:

 Set Activity1.Ignore Starved Routes = 1

Unchecks the box so wait for any starved routes until they contain a Work Item:

 Set Activity1.Ignore Starved Routes = 0


Sets the image used for the Activity to any image located in the Graphics, Images menu option.


 Set Activity1.Image = "BlueB"

Where BlueB exists as an image. Note the quotation marks around the name of the image. The text can be a text variable or text expression.

In the case of Activities, where more than one image can be used by the object (e.g. for its image when free, working, stopped etc.) then the text string can contain multiple image names separated by forward slash. For example:

 Set Activity1.Image = "BlueB/RedB/GreenB"

The separate images names will be used for each of the images listed in the Activity graphics dialog in the sequence: Free/Working/Blocked/Stopped/Setup. If less than the maximum allowed number of images is supplied then the final supplied image will be used for remaining types of Activity state.


Sets the Index number of the Activity to a value other than the default value.


 Set Activity1.Index = 5

Interrupt Store

Sets the name of the store used to contain Interrupted Work Items.


 Set Activity1.Interrupt Store = "Interrupt Queue"

Note that the name of the store is in inverted commas. The store must exist in the simulation or the command will be ignored and Interruptible will be turned off. If Interruptible is turned off then setting the Interrupt Store to a valid store will turn it on.

Label Batching Max

Sets the Max value used with Label Batching.

Label Batching Min

Sets the Min value used with Label Batching.


 Set Activity 1.Label Batching Max = 10
 Set Activity 1.Label Batching Min = 5

Together these work to set the maximum and minimum values used in Label Batching.

Locked In Route

Locks the Activity to use the nominated Route only. This works from the position in the list of the Route, not the name of the source of the items.


 Set Activity 1.Locked In Route = 2

This limits the Activity to pull only from Route 2 (the route listed second in the Route In Properties). All other Routes will be ignored until the route is changed.


Allows the name of the Activity to be changed or accessed.


Changes the name to whatever is inside the inverted commas:

 Set Activity1.Name = "Change the Name"

Sets a text Global Data Item to contain the name of the Activity1:

 Set Var1 = Activity1.Name

Operation Time

This changes the timing information used by the Activity to a Fixed value.


 Set Activity1.Operation Time = 25

Sets the cycle time to a Fixed value of 25.


Sets the Priority of the Activity to a value.


 Set Activity1.Priority = 70.

When there is a competition for Resources this Activity will rank above any Activity with a priority of less than 70, and below any Activities with a value more than 70.


Sets the effective number of Activities to a value.


 Set Activity1.Replication = 10

Sets the replication value to 10.

Results Collection Mode

Allows control over the collection of results for specific object through Visual Logic.

1 = Results Collection on
0 = Results Collection off


Set Activity1.Results Collection Mode = 1


Sets whether the Activity is selected onscreen or not.

1 = Selected
0 = Not selected

 Set Activity1.Selected = 0

Read Only Properties

Activity Properties that return results are:


Returns the number of Work Items that have exited an Activity.


 Set Var1 = Activity1.Completed

Count Contents

Returns the number of Work Items currently located in the Activity.


 Set Var1 = Activity1.Count Contents

In Count

Returns the number of incoming routes to the Activity.


 Set Var1 = Activity1.InCount

Sets Var1 to the number routes that are connected to the Activity.

Out Count

Returns the number of Outgoing routes from the Activity.


 Set Var1 = Activity1.OutCount

Sets Var1 to the number routes that are connected from the Activity.


The State property returns the current working state of the Activity.

  • 0: Waiting
  • 1: Working
  • 2: Blocked
  • 3: Change Over
  • 4: Stopped
  • 5: Off Shift
  • 6: Resource Starved
  • 7: Scheduled Maintenance


 Set Var1 = Activity1.State

Unique ID

Gets Simul8's internal Unique Number that identifies every object - you can be sure it is different for all objects. It never changes once an object is in a simulation.

See Also