UTI statement

Use the UTI statement in your network definition to define user time intervals for computing the message delays. Code UTI values in hundredths of seconds. You can code any number of UTIs to allow devices to operate at different speeds within the same network. WSim uses the UTI values that you code as scale factors by which user-specified delay values are multiplied.

The UTI statement includes a label and a UTI value as shown in the following examples:

UTI1   UTI   100
UTI2   UTI   0

Note that if you specify UTI with a value of 0, there is no delay between messages generated and sent by WSim when using this UTI.

You can reference a UTI on a DEV, LU, or TP statement by using the IUTI operand as shown in the following example:

DEV2   DEV   IUTI=UTI1

The IUTI operand specifies the individual UTI (UTI1) that is to be used in calculating all delays for this device. It must reference a UTI statement that is defined within the network definition.

You can also reference UTIs from message generation decks and alter UTIs using operator commands. Refer to Introducing message generation decks and WSim User's Guide for more information about referencing and altering UTIs. Refer to WSim Script Guide and Reference for more information about the UTI statements and operands.

The following example shows a network definition and message generation deck that uses multiple UTIs.

SAMPLE1  NTWRK    UTI=100
⋮
UTIA     UTI      0
UTIB     UTI      1000
UTI1     UTI      1
UTI2     UTI      2
⋮
         VTAMAPPL IUTI=UTIB
LU1        LU
LU2        LU     IUTI=UTI1
         VTAMAPPL
LU3        LU
ONE      MSGTXT
         SETUTI    UTI=UTI2
⋮
         ENDTXT
TWO      MSGTXT
         DELAY     TIME=F1,UTI=UTIB
⋮
         ENDTXT

The UTI for LU1 is UTIB. The UTI for LU2 is UTI1. And the UTI for LU3 is the network UTI. SETUTI alters the UTI value only for the device that is executing deck ONE. The network UTI is not altered. The DELAY message generation statement specifies an intermessage delay. The values specified by the TIME and UTI operands are multiplied together to obtain the value for DELAY.

The following example shows how to code the message generation decks shown in the above example using STL. For information about STL, see WSim Script Guide and Reference.

one:  msgtxt
      uti 'UTI2'
      ⋮
      endtxt
two:  msgtxt
      uti 'UTIB'
      delay(1,'UTIB')
      ⋮
      endtxt