fhb-SendMessage Command

The fhb-SendMessage command is used to issue commands to the Hot Backup secondary server and its helpers.

Syntax

fhb-SendMessage MessageChannel Command

Parameter(s)

MessageChannel

Specifies the name of the server channel or helper channel to which the specified Command is being sent. Note that when a server is idle, it periodically checks its associated message channel for commands.

CommandMain

Name for the main server channel.

CommandHelper#

Name for the helper channels where # is the helper's queue number.

Command

The following commands can be sent to the server and/or its helpers:

DEBUG

Sends the server to which the command is sent into the FlashBASIC debugger. This command is supported for both the main servers and its helpers.

STAT

The specified server sends statistics on called routines and subroutines to fsidm,fhb, (to an item with an item-ID in the format Stat<Main|Helper#>.DateTime). The information for each individual routine is displayed in this format:

Routine.Name]Number of Hits]Time Spent in the Routine

For example:

MainLoop.ApplyUpdate]421]4139

Note that the last value is displayed in milliseconds and includes any time spent in called subroutines.

STOP

  • When sent to the main server, stops all helpers and then stops the main server.

  • When sent to a helper, stops the specified helper.

Example(s)

The example below illustrates sending a STOP command to the secondary server.

fhb-SendMessage CommandMain STOP

[FHBMessage.Success] Message sent. Id = '123'

The example below illustrates sending the CommandHelper2 helper (that is, helper queue 2) into the FlashBASIC debugger.

fhb-SendMessage CommandHelper2 DEBUG

[FHBMessage.Success] Message sent. Id = '123'

See Also

Hot Backup Commands

fsihotbackup Command

fhb-allfiles-on Command

fhb-allfiles-off Command

fhb-on Command

fhb-off Command

fhb-flags Command

fhb-status Command

fhb_S_Timer Command

fhb_S_Timer_enqueue Command

fs Command