Registering a Run-time Server

Before you can associate tasks with run-time servers and configure tasks for failover and load balancing, you must register the run-time servers that will be used. A registered run-time server can be associated with individual tasks, and also be used to build failover lists, which are assembled for each task and agent cluster combination when you configure your failover environment.

To register a run-time server
  1. In the MCS left pane, point to Products and then click Services Builder for CICS.

  2. Under Services Builder for CICS, expand the Deployments tree, expand the Tasks tree, and then click Registered Runtimes.

  3. From the Registered Runtime Servers page, click Add.

  4. In the Add Runtime Server page under Runtime Server Name, type a name for your server/task association.

    This name appears in a list of registered run-time servers when you later configure your task.

  5. Type the host name or IP address, and the RMI port address of the computer on which the Runtime Service is installed.

    The default RMI port is 6800. To use a different RMI port, you must change the RMI port on the Runtime Service server and then enter the new RMI port address.

    -or-

    Manually configure the port address and other run-time server configurations using the CICSClientConfig.xml file. (For more information, see Manually Configuring the Client Environment.)

    The URL, which describes the location of the runtime server, is created automatically as you add values for the other options, protocol://hostname:port. If you edit the URL directly, your changes also affect the corresponding options.

  6. Finish registering the run-time server:
    Choose
    To add the server and
    OK Return to the Run-time Server list.
    Save to List and Add Another Server Remain on the Registering Run-time Server page to add additional run-time servers.
  7. When you have added all of the run-time servers, choose Apply All Changes.

    You can make multiple changes to different registered run-time servers without saving the changes individually. When you choose Apply All Changes, all changes made to any registered run-time server are sent to the Registered Runtime Server database, causing the modifications to take effect. Apply All Changes will also cause any changes that have not already been applied to the Task Configuration pages to take effect.

    The next step is to associate tasks with agent clusters.

To edit registered run-time server information
  1. From the Registered Runtime Servers page, select the server you want to edit and click the Edit button.

    The Edit Runtime Server dialog box appears.

  2. Make changes as required.
    Note
    • Deleting a registered run-time server from the list, removes it from all failover lists in which it is currently being used.

    • Disabling a registered run-time server, on the other hand, does not remove it from the failover list, but makes it unavailable to all tasks that are associated with it. Although it will no longer be used in a task failover list and will be skipped when a runtime server is requested, it has not been stopped and can still be added to another task failover list.

    • It is a good idea to disable the run-time before stopping or re-starting the run-time server — this provides a warning to client computers before a run-time becomes unavailable to them.
  3. When you have finished making changes, click OK.

  4. In the Registered Runtime Servers page, click Apply All Changes.

    The changes you made to the run-time server are sent to the Registered Runtime Server database, causing the modifications to take effect.

Related Topics
Bullet Configuring Your Run-time Environment
Bullet Task Failover and Load Balancing
Bullet Manually Configuring the Client Environment
Bullet Associating Tasks with Run-time Servers
  Attachmate