FE - future event statement


[name] FE COMMAND=(command)
          {,EVENT=event}
          {,TIME=ssssssss}

Function

The FE statement defines an operator command to be executed at a specified time after the network simulation has begun or when a specified EVENT is signaled. This statement is optional.

Where

name

Function: Specifies the name to be used for this statement (for user information only).

Format: From one to eight alphanumeric characters.

Default: None. This field is optional.

COMMAND=(command)

Function: Specifies the operator command to be executed.

Format: The command is a character string similar to the data entered with an OPCMND statement (see OPCMND - operator command statement), except that data field options are not allowed.

Default: None. This operand is required.

EVENT=event

Function: Specifies the name of an event which, when signaled, will cause the command specified by this statement to be processed.

FE statements associated with EVENTs will still be active after the network is stopped in case you want to signal the EVENT name and cause the FE to be executed.

Format: A 1- to 8-character name.

Default: None.

TIME=ssssssss

Function: Specifies the time into the run that the operator command is to be processed.

FE statements with the TIME operand will be dequeued and not executed if the network is stopped before the time is reached.

Format: The value of ssssssss is from one to eight digits specifying the number of seconds. The range for ssssssss is from 1 to 21474836.

Default: None.

Note: The EVENT and TIME operands cannot appear on the same FE statement. Code either the EVENT or the TIME operand, but not both.

A future event will only be executed once. When the time expires or the event is signaled, the event will not be executed again unless the network is stopped and restarted.