pdchprc (Change number of startup server processes)
Function
The pdchprc command changes the number of resident server processes and the maximum number of startup server processes. It also displays the current number of resident server processes and the current maximum number of startup server processes.
Executor
Format
- HiRDB/Single Server
pdchprc [-p resident-processes-count[,maximum-startup-processes-count]]
- HiRDB/Parallel Server
pdchprc {-a| -s server-name}
[-p resident-processes-count[,maximum-startup-processes-count]]
Options
- -p resident-processes-count [,maximum-startup-processes-count]
<unsigned integer> ((0-2048))
Specifies new values for the number of resident server processes and maximum number of startup server processes. If the maximum number of startup processes is omitted, the number of resident processes is assumed. If the -p option is omitted, the command displays the current number of resident server processes and current maximum number of startup server processes at the time the pdchprc command is executed.
The number of processes can be any value in the range 0 to the maximum number of startup server processes specified in the HiRDB system definition. The maximum number of startup server processes is shown below. Note that if you have not specified the pd_max_reflect_process_count operand, treat the value of this operand as 0.
- Single server or front-end server
Value of pd_max_users operand in the system common definition + value of pd_max_reflect_process_count operand
- Back-end server
Value of pd_max_bes_process operand in the server common definition or back-end server definition + value of pd_max_reflect_process_count operand
- Dictionary server
Value of pd_max_dic_process operand in the server common definition or dictionary server definition + value of pd_max_reflect_process_count operand
Specifies that the number of resident server processes and maximum number of startup server processes for every server that is active when the pdchprc command is executed are to be displayed. If this option is specified together with the -p option, the command changes the number of resident server processes and the maximum number of startup server processes for every active front-end server and back-end servers to the values specified in the -p option.
- -s server-name
<identifier> ((1-8))
Specifies the name of a server whose number of resident server processes and maximum number of startup server processes are to be changed or displayed.
Rules
- The pdchprc command can be executed only while HiRDB is active.
- The pdchprc command must be executed at the server machine containing the single server or the server machine where the system manager is located.
- An error results if the number of resident processes specified in the -p option is greater than the maximum number of startup processes.
- If either value specified in the -p option is greater than the maximum number of startup server processes specified in the HiRDB system definition, HiRDB displays a warning message and assumes the maximum number of startup server processes specified in the HiRDB system definition.
- Whenever the number of resident processes or the maximum number of startup processes is changed by the -p option, HiRDB displays a message to that effect at each applicable server.
- The new number of resident server processes and maximum number of startup server processes set by the pdchprc command remain in effect at each applicable server until the server is terminated. Once HiRDB is terminated normally or forcible or planned termination is executed, this information is not inherited at the next restart.
Notes
- If the server specified in the -s option is not active or is terminating, the pdchprc command terminates with an error. When the -a option is specified, neither the number of resident server processes nor the maximum number of startup server processes is changed at or displayed for any inactive server or any server that is terminating.
- To change the number of resident processes or the maximum number of startup processes for a dictionary server, the name of the dictionary server must be specified in the -s option.
- If the maximum number of startup server processes is changed to 0, all transaction processing underway at the time the pdchprc command executes terminates with an error.
- If the maximum number of startup processes for a dictionary server or back-end server is changed to a value that is less than the value specified in the HiRDB system definition and if many transactions are concentrated at that server, the transactions the server can no longer handle may terminate with an error.
- On the HiRDB/Parallel Server, if the system manager and the front-end server are the same unit, changing the maximum number of processes that can be launched on the front-end server to 0 disables the following utilities:
- Database load utility (pdload)
- Database structure modification utilities (pdmod)
- Database reorganization utility (pdrorg)
- Database condition analysis utility (pddbst)
- Optimizing Information collection utility (pdgetcst)
- When the standby-less system switchover (effects distributed) facility is used, if the pdchprc command is used to display the number of resident server processes and the maximum number of active processes, the number of resident back-end server processes and the maximum number of active processes may not match depending on the number of allocated server processes. Additionally, even when you specify the -p option to change the number of resident processes and the maximum number of active processes, the number of resident back-end server processes and the maximum number of active processes may not be changed depending on the number of allocated server processes. For details about the number of allocated server processes when the standby-less system switchover (effects distributed) facility is used, see the HiRDB Version 8 System Operation Guide.
- Return code 0 for the pdchprc command indicates normal termination, and return code 8 indicates abnormal termination (such as an invalid option or rsh error).
Output format
The following information is displayed only when the -p option is omitted:
aa...a bbbb,cccc dddd,eeee
aa...a bbbb,cccc dddd,eeee
- Explanation
- aa...a
- Server name (1-8 characters)
- bbbb
- Number of resident server processes specified in the HiRDB system definition
- cccc
- Maximum number of startup server processes specified in the HiRDB system definition
- dddd
- New number of resident server processes set by the pdchprc command. If it is the same as bbbb, **** is displayed.
- eeee
- New maximum number of startup server processes set by the pdchprc command. If it is the same as cccc, **** is displayed.