MSM for NT 4.3.0 MSERVER Replaces RPC Broker Listener Process

MSM for NT in version 4.3.0 introduced a new generic TCP/IP Listener MSERVER. MSERVER is an actual routine in the Manager's UCI that runs and listens to all of the ports that you specify in SYSGEN. When a connection is established to one of these ports, MSERVER launches your code at some TAG^ROUTINE that you specify. This is similar to VMS' UCX utility. If you are running a Beta version of MSM 4.3 for NT, we encourage you to upgrade to 4.3.0. Once you upgrade, you should stop using the RPC Broker Listener and switch to the MSERVER.

Before MSERVER can be used, it must be configured using SYSGEN. The following is an example from the CIO Field Office in San Francisco:

  1. In the Manager's UCI run SYSGEN.

  2. In sequence pick the following options:

    a. 3 - Edit Configuration Parameters

    b. 15 - Network Configuration

    c. 12 - User-Defined Services

  3. Enter an unused index number and set it up as indicated below:

    a. Enter Service Name <RPC BROKER>: RPC BROKER

    b. Enter Routine Reference <MSM^XWBTCPC>: MSM^XWBTCPC

    c. Select UCI <VAH,MNT>: VAH,MNT

    d. Enter Partition Size <80>: 80

    e. Enter Password <>: <RET>

    f. Enter TCPIP Port Number <9200>: 9200

    g. Autostart? <YES>: YES

    However, specifying YES for Autostart is not enough for MSERVER to start up when MSM is started. You must also add MSERVER to the Automatic Startup List as indicated in Steps 4-6 below.

  4. To schedule MSERVER to start automatically when MSM comes up, go to the SYSGEN main menu.

  5. In sequence pick the following options:

    a. 3 - Edit Configuration Parameters

    b. 3 - Autostart and Automounts

    c. 5 - Automatic Partition Startup

  6. Enter an unused index number and set it up as indicated below:

    a. Enter UCI name <MGR>: MGR

    b. Enter Entry Reference <STARTUP^MSERVER("RPC BROKER")>: STARTUP^MSERVER("RPC BROKER")

    c. Enter partition size <SYSTEM>: SYSTEM

To start MSERVER manually, in the Manager's UCI, type the following at the programmer prompt:

>J STARTUP^MSERVER("RPC Broker")

To shut down MSERVER in the Manager’s UCI, type the following at the programmer prompt:

>J SHUTDOWN^MSERVER("RPC Broker")

If you're successfully using MSERVER, discontinue using the Broker Listener. That means you shouldn't use the STRT^XWBTCP and STOP^XWBTCP entry points or the RPC BROKER SITE PARAMETERS file.