scdrsprc {-s server-name|-a}

The scdrsprc command stops and restarts user server processes running under the scheduling service.

-s server-name

Specifies the name of a user server whose processes are to be stopped and restarted.

-a

Stops and restarts all the queue-receiving user servers and MHPs operating under the scheduling service.

Message ID	Description	Output destination
KFCA00884-I	Help message	Standard error output
KFCA00890-E	Error occurred during scdrsprc command processing.	Standard error output
KFCA00891-E	Usage of the scdrsprc command is invalid.	Standard error output
KFCA00892-E	scdrsprc command cannot be executed because the scheduler is not running.	Standard error output
KFCA00893-E	Specified server name, service group name, or service name is invalid.	Standard error output
KFCA00894-E	scdrsprc command cannot be executed due to inconsistent versions.	Standard error output

• To execute the scdrsprc command, TP1/Extension 1 must be installed. The operation of this command is not guaranteed if TP1/Extension 1 is not installed.
• The scdrsprc command finishes the moment it successfully receives a request. Therefore, process swapping will not have completed fully at the target user server when the command finishes.
• Executing the scdrsprc command immediately terminates all processes that are waiting for service requests. However, processes that are currently executing server requests terminate only when the request is completed. New processes are activated at preset intervals (10 seconds) by the OpenTP1 scheduler daemon. It may therefore take some time to swap every process.
• You cannot apply the scdrsprc command to the following servers. If you specify any of these servers in the -s option, the command outputs the message KFCA00893-E and returns an error:
  
  • An SUP
  • A server that receives requests from a socket
  • A server for which either of the following operands is specified in the user service definition or user service default definition:
    termed_after_service = Y
    service_wait_time = length of time to wait for service requests from non-resident processes of the user server
    
  • A server that works with debuggers
  • System services (including the following servers)
    A RAP-processing server
    An RTSSPP (server for extended feature of real-time statistics service)
    
• When the -a option is specified, the load on the system may increase due to the large number of user server processes being stopped and restarted in a short space of time.