The preferred method for starting and stopping Listeners in DSM and OpenM is through the STATUS field of the RPC BROKER SITE PARAMETERS file (#8994.1). While TaskMan is running, you should be able to start and stop Listeners at any time by setting the STOPPED Listener to START and a RUNNING Listener to STOP. Out of the six possible states: START, STARTING, RUNNING, STOP, STOPPING, and STOPPED, you can only enter START when a Listener is STOPPED and STOP when a Listener is RUNNING. The other states are controlled by the Broker itself.
For DSM, TaskMan must be running in a DCL context.
To set the STATUS field, invoke VA FileMan V. 21.0 using Q^DI and edit the new RPC BROKER SITE PARAMETERS file (#8994.1). Set this field either to START or STOP and, assuming that TaskMan is running, the Listener will be started or stopped accordingly. When STATUS is set to START, the field will change to RUNNING. Conversely, when STATUS is set to STOP, the field will change to STOPPED.
To start up a Listener directly:
a. Log into your M server
b. Enter the following at the M prompt:
>D STRT^XWBTCP(Listener port)
As a convention, the RPC Broker uses 9200 as the Listener port, however, sites can choose any available port greater than 1024.
To stop a Listener directly:
a. Log into your M server
b. Enter the following at the M prompt:
>D STOP^XWBTCP(Listener port)
It is important to stop all Listeners before shutting down the system!