Each Blox object uses the Suite's system Index value where that blox is attached.  Each system.index value assignment in a suite is determined by the order in which the system is added in the Suite's list of systems.  This means that when a blox is attached to a specific system, the Blox and all of its script sections will return the system.index assigned value when block.systemIndex property is called.  This also means any script called from another system, including a Global System, where the called script is located will return the system number assigned to the called script location.

 

When only 1 system is in a suite the system index will always be one.  When more than one system is in a suite the first system selected to be included the suite will be given the index value of 1, the second system selected will be given an index value of 2, and the last system selected will be given the index value that matches the number of systems attached to the suite.  Global Systems are always assigned a system.index value of zero.

 

Any system with the same name as the Suite is automatically converted to a Global System (GSS) and will return a block.systemIndex value of zero. Blox modules attached to a GSS will be reported as having a system.index and a block.systemIndex of 0.  

 

Scripts within the GSS modules execute ahead or behind the system index sequencing order.  Review the details here to understand when GSS are executed: Global Script Timing

 

Syntax:

block.systemIndex

 

Parameter:

Description:

<none>


 

Example:

'  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

'  When this statement is in a script in the only system in a

'  Suite the return value will be 1
PRINT "System Suite Index Number ", block.systemIndex
'  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Returns:

'  When this statement is in a script in the only system in a

'  Suite the return value will be 1
System Suite Index Number  1

'  When this statement is in a script along with a Global System

'  the return value will be 1 if there is only 1 system in the

'  Suite, or the call is made from the system that was the first

'  system to be added to the Suite.
System Suite Index Number  1

'  If the statement was in the second system added to a multiple

'  system suite and the system where the script is located is in

'  the second system added to the suite, the return value will be 2

System Suite Index Number  2

 

Links:

System

See Also:

Block

 


Edit Time: 9/25/2017 09:09:54 AM


Topic ID#: 605

 

Created with Help & Manual 7 and styled with Premium Pack Version 2.80 © by EC Software