Issue a Start New Event
You can issue a START_NEW event to start many temporary instances of a process. These instances will not be restarted if iProcess Engine is restarted. For example, you may want to start a new background process to cope with a short peak in demand.
To issue a START_NEW event, use the following command:
swsvrmgr START_NEW [ machine_name | machine_id [ process_name [instances]]] [-T timeout]
where:
| • | machine_name is the name of the server. |
| • | machine_id is the unique identifier of the server. You can find a server’s identifier using the swsvrmgr status command. |
| • | process_name is the process name of the server process you want to start and must be one of these: BG, BGPREDICT, DBQD, DLMGR, IAPJMS, SPO, or DIRECTOR. If any other process name is specified, the command fails and an error message is displayed. |
| • | instances is the number of instances of the process to start. |
| • | timeout is the optional timeout period that can be used to specify the time after which the command will terminate. If this is not specified, the default is 60 seconds. |
Notes
All foreground processes (see Server Processes) must run on the master server.
Example
To start an additional instance of the background process (BG) that is operating on the computer called Hercules using the default timeout, you would issue the following command:
swsvrmgr START_NEW hercules bg 1BG 5 STARTEDProcess(es) successfully started