OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

3.1.5 Replacement of user server

A user server can be replaced by another user server during OpenTP1 execution.

The following procedure must be used to replace a user server:

Organization of this subsection
(1) Service Providing Program (SPP)
(2) Message Handling Program (MHP)

(1) Service Providing Program (SPP)

  1. Terminate the user server with the dcsvstop command.
  2. Replace the user server (if necessary, also replace the user service definition)
  3. Start the new server with the dcsvstart command.

It is also possible to create a new user server under a different directory from the one containing the currently active user server. Following is the procedure:

  1. Terminate the user server with the dcsvstop command.
  2. Define a new user server under another directory
  3. Change the path to the new directory with the prcpath command
  4. Start the new server with the dcsvstart command.

If OpenTP1 is restarted with the dcstart command, the previous user server will become effective again.

(2) Message Handling Program (MHP)

A currently active user server can be replaced by another user server for each service group.

Use the following procedure to replace the user server:

  1. Shut down the scheduling of the currently active user server (service group) with the mcftdctsg command. Or, hold the input queue with the mcfthldiq command.
  2. Terminate the user server with the dcsvstop command.
  3. Replace the user server.
  4. Restart the new user server with the dcsvstart command.
  5. Release the scheduling of the user server (service group) shutdown with the mcftactsg command. Or, release the hold of the input queue with the mcftrlsiq command.

In the case of a disk queue, any start request occurring during user server (service group) shutdown will be re-scheduled after release of the shutdown. For a memory queue, all such start requests, including those made to already scheduled user servers, will be an error event.

When the scheduling is shut down (with mcftdctsg) or the input queue is held (with mcfthldiq) specifying the -r option, the shutdown or hold status is not inherited after full recovery.