To start an InfoHub from the shell, execute a command like:
$ $gtm_dist/mumps -run InfoHub --action=start
This command uses the current configuration and starts the InfoHub process.
When starting an InfoHub for the first time, the InfoHub processes the current InfoHub configuration, acting on each item as it loads it.
The "start" action also suffices to start an InfoHub from a "dirty" shutdown, for example, after a system crash, or after an inadvertent MUPIP STOP of the InfoHubMain process. Startup after a system crash issues an error if the database has not been recovered to a clean state. Startup after an inadvertent MUPIP STOP of the main process causes the InfoHub to reconnect with existing processes and start missing processes. If the restart after a crash uses a different configuration, existing processes are all shutdown and restarted.
In the event that two simultaneous start commands are sent, only one succeeds. The other exits with an unacknowledged startup request.
To start an InfoHub from within GT.M, invoke the following entry point in the InfoHub API as an extrinsic function:
$$start^InfoHub(InfoHubID,$zgbldir)
Example:
$ $gtm_dist/mumps -run InfoHub --action=start
This example starts the InfoHub most recently associated with the current global directory.
GTM>if $$start^InfoHub(7421) JOB 10215 InfoHub Active at 1383133001659001
This example starts the InfoHub whose ID is 7421.
