Changes the number of resident processes running on a server or the maximum number of processes that can run on a server while the server is operating. This command can be used for user servers and some system servers. As a result of the change, new processes are generated or excess processes are terminated. The number of processes changed by this command is effective until the server is terminated (including when the server is forcibly terminated). The system does not inherit the change after full system recovery. You can also only display the values currently set.

-a

The number of processes of all the queue-receiving user servers, excluding the servers that work with debuggers, and of the MHPs is to be changed.

-s server-name~<identifier, 1-8 characters>

The number of processes of the specified server is to be changed.

To specify a system service, use this option.

You can specify the following server names for system services:

Transactional RPC execution process

Server name: _clttrn

CPU execution process

Server name: _cltcon

-p number-of-resident-processes [,maximum-number-of-processes] ~<unsigned integer> ((0-1024))

Specifies the number of resident processes or the maximum number of processes that has been changed in the format of the parallel_count operand of the user service definition.

If you specify only the number of the resident processes, the maximum number of processes is also changed to the same value. Other specification rules are the same as for the parallel_count operand of the user service definition. For the parallel_count operand of the user service definition, see the manual OpenTP1 System Definition.

If you omit this option, the value currently set is displayed in the following format.

Number of servers   aaaa                               ...1.
Server name         When started   After being changed
bb...bb               cccc, dddd          eeee, ffff           ...2.
 

1. Displayed only when you specify the -a option.

2. When you specify the -a option, this line is displayed for each server.

aaaa

Number of servers to be displayed (Up to four decimal digits)

bb....bb

Server name (up to eight alphanumerics)

cccc

Number of resident processes when the server is started (up to four decimal digits)

dddd

Maximum number of processes when the server is started (up to four decimal digits)

eeee

Number of resident processes after being changed by the scdchprc command (up to four decimal digits)

For the server whose number of processes has not been changed after startup, '****' is displayed.

ffff

Maximum number of processes after being changed by the scdchprc command (up to four decimal digits)

For the server whose number of processes has not been changed after startup, '****' is displayed.

• You must install TP1/Extension 1 to use this command. The operation cannot be guaranteed if TP1/Extension 1 is not installed.
• This command does not change the value specified in the parallel_count operand of the user service definition.
• Even when this command seems to be completed, the command may be still executing. Therefore, the number of processes may not be changed immediately. When reducing the number of processes, processes are normally terminated, therefore, it may take some time to reduce the number of processes depending on the execution status of the processes.
• To reduce the maximum number of processes to less than the number of processes being started, reduce the number of processes being started regardless of the number of service requests remained for the server. (Reduce the number of processes with the multi-server load balancing facility being ignored.)
• Increasing the number of resident processes exceeding the maximum number of processes for OpenTP1 or the system causes a command error.
• If you change the resident server at startup (number of resident processes = maximum number of processes) to the non-resident server (number of resident processes < maximum number of processes), the change is not reflected to the following definition operands related to the non-resident process.
  

  User service definition

  termed_after_service

  service_wait_time

  User service default definition

  termed_after_service

  service_wait_time

• You cannot apply the scdchprc command to the following servers. If you specify any of these servers in the -s option, the command outputs the message KFCA00844-E and returns an error.
  
  • An SUP
  • A server that receives requests from a socket
  • 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 started or changed in a short space of time.