3.1 Operand formats

A unit control information definition defines information about a unit. This section explains the formats used to specify the operands of a unit control information definition. Note that the numbers in the following table correspond to the numbers assigned to the explanations of the individual operands in 3.2 Operand explanations.

For users who are creating HiRDB system definitions for the first time
The first step is to determine the values to be specified for the operands shown in boldface type. In principle, HiRDB can be started once the boldface operands have been specified.
For users of the standby-less system switchover (effects distributed) facility
When you use the standby-less system switchover (effects distributed) facility, you can specify only certain operands. For details, see F. List of Operands That Can Be Specified When Using the Standby-less System Switchover (Effects Distributed) Facility (Unit Control Information Definition).
No.FormatOperand category
1set pd_unit_id = unit-identifierSystem structure
2[set pd_hostname = host-name]
3[set pd_max_server_process = maximum-number-of-concurrently-activated-server-processes]#Maximum concurrent executions
4[set pd_server_entry_queue = spnfifo | fifo | loop]#HiRDB processing
5[set pd_thdlock_wakeup_lock = Y | N]#
6[set pd_thdlock_pipe_retry_interval = thread-lock-release-check-interval]#
7[set pd_thdlock_retry_time = thread-lock-sleep-time]#
8[set pd_thdspnlk_spn_count = thread-spin-lock-spin-count]#
9[set pd_db_io_error_action = dbhold | unitdown]#
10[set pd_max_recover_process = concurrently-executable-full-recovery-processes-count]#Full recovery processing
11[set pd_trn_rcvmsg_store_buflen = transaction-recovery-message-queue-size]#Transaction decision processing
12[set pd_watch_time = maximum-response-wait-time]#System monitoring
13[set pd_down_watch_proc = upper-limit-for-server-process-abnormal-terminations[,monitoring-interval]]#
14[set pd_cwaittime_report_dir = SQL-runtime-warning-information-file-output-destination-directory]*SQL runtime warning output facility
15[set pd_cwaittime_report_size = SQL-runtime-warning-information-file-maximum-size]*
16[set pd_uap_exerror_log_dir = SQL-error-report-file-storage-directory]#Facility for output of extended SQL error information
17[set pd_uap_exerror_log_size = SQL-error-report-file-maximum-size]#
18[set pd_uap_exerror_log_param_size = maximum-data-size-of-parameter-information-to-be-output-to--client error-log-file-and-SQL-error-report-file]#
19[set pd_lck_wait_timeout = lock-release-wait-time]#Lock
20[set pd_lck_release_detect = interval | pipe]#
21[set pd_lck_release_detect_interval = lock-release-detection-interval]#
22[set pd_lck_deadlock_info = Y | N]#
23[set pd_lck_deadlock_check = Y | N]#
24[set pd_lck_deadlock_check_interval = deadlock-check-interval]#
25[set pd_thread_stack_expand_size = stack-extension-size-per-thread]Buffers
26[set pd_shmpool_attribute = free | fixed]#Shared memory
27[set pd_dbbuff_attribute = free | fixed]#
28[set pd_stj_file_size = maximum-statistics-log-file-size]#Statistical information
29[set pd_stj_buff_size = statistics-log-buffer-size]#
30[set pd_rpc_trace = Y | N]#RPC trace information
31[set pd_rpc_trace_name = "name-of-RPC-trace-collection-file"]#
32[set pd_rpc_trace_size = RPC-trace-collection-file-size]#
33[set pd_prf_level = 00000007​|0000001​f|0000007​f|000001ff|00000000​]#Performance trace information
34[set pd_prf_file_count = number-of-performance-trace-information-file-generations]#
35[set pd_prf_file_size = size-of-a-performance-trace-information-file]#
36[set pd_cancel_dump = put | noput]#Troubleshooting information
37[set pd_dump_suppress_watch_time =troubleshooting-information-output-suppression-time]#
38[set pd_spool_cleanup_interval = troubleshooting-information-deletion-interval]#
39[set pd_spool_cleanup_interval_level = number-of-days[,deletion-type]]#
40[set pd_spool_cleanup = normal | force | no]#
41[set pd_spool_cleanup_level = number-of-days [,deletion-type]]#
42[set pd_module_trace_max = maximum-number-of-module-traces-that-can-be-stored]#
43[set pd_module_trace_timer_level = 0 | 10 | 20]#
44[set pd_pth_trace_max = maximum-number-of-stored-communication-traces]#
45[set pd_dbbuff_wait_interval = global-buffer-occupation-state-check-interval]#Global buffers
46[set pd_dbbuff_wait_spn_count = maximum-spin-loop-count-for-global-buffer-occupation-state-checking]#
47set pd_syssts_file_name_1 = "logical-file-name"
,"file-a-status-file-name","file-b-status-file-name"
Unit status files
[set pd_syssts_file_name_2 = "logical-file-name"
,"file-a-status-file-name","file-b-status-file-name"]
[set pd_syssts_file_name_3 = "logical-file-name"
,"file-a-status-file-name","file-b-status-file-name"]
[set pd_syssts_file_name_4 = "logical-file-name"
,"file-a-status-file-name","file-b-status-file-name"]
[set pd_syssts_file_name_5 = "logical-file-name"
,"file-a-status-file-name","file-b-status-file-name"]
[set pd_syssts_file_name_6 = "logical-file-name"
,"file-a-status-file-name","file-b-status-file-name"]
[set pd_syssts_file_name_7 = "logical-file-name"
,"file-a-status-file-name","file-b-status-file-name"]
48[set pd_syssts_initial_error = stop | continue | excontinue]Unit status files (when an error occurs)
49[set pd_syssts_singleoperation = stop | continue]
50[set pd_syssts_last_active_file = "logical-file-name"]
51[set pd_syssts_last_active_side = A | B]
52[set pd_audit = Y | N]#Security
53[set pd_aud_file_name = HiRDB-file-system-area-name-for-audit-trail-file]#
54[set pd_aud_max_generation_size = audit-trail-file-maximum-size]#
55[set pd_aud_max_generation_num = maximum-audit-trail-file-count]#
56[set pd_aud_async_buff_size = size-of-buffer-used-for-asynchronous-output-of-audit-trail-file]#
57[set pd_aud_async_buff_count = number-of-buffer-sectors-used-for-asynchronous-output-of-audit-trail-file]#
58[set pd_aud_async_buff_retry_intvl = retry-interval-for-allocation-of-a-buffer-to-be-used-for-asynchronous-output-of-audit-trail-file]#
59[set pd_aud_sql_source_size = size-of-SQL-statement-output-to-audit-trail]
60[set pd_aud_sql_data_size = size-of-SQL-data-output-to-audit-trail]
61[set pd_ha_acttype = monitor | server]System switchover facility
62[set pd_ha_unit = nouse]
63[set pd_ha_switch_timeout = Y | N]#
64[set pd_ha_server_process_standby = Y | N]
65[set pd_ha_agent = standbyunit | server | activeunits]
66[set pd_ha_max_act_guest_servers = maximum-number-of-acceptable-guest-BES]
67[set pd_ha_max_server_process = maximum-number-of-user-server-processes-inside-accepting-unit]
68[set pd_ha_process_count = number-of-processes-resident-inside-unit-after-acceptance-of-guest-BES]
69[set pd_ha_resource_act_wait_time = maximum-wait-time-for-resource-activation]#
70[set pd_ha_ipaddr_inherit = Y | N]#
71[set pd_rpl_hdepath = extracted-side-HiRDB-Datareplicator-directory-name]HiRDB Datareplicator
72[set pd_service_port = scheduler-process-port-number]#Communication processing
73[set pd_change_clt_ipaddr = 0 | 1 ]#
74[set pd_registered_port = "port-number-reservation-range" [,"port-number-reservation-range"]...]*
75[set pd_registered_port_check = Y | N | C | W]#
76[set pd_registered_port_level = 0 | 1]#
77[set pd_ipc_send_retrycount = process-to-process-send-retries-count]#
78[set pd_ipc_send_retrysleeptime = process-to-process-send-retry-sleep-time]#
79[set pd_ipc_send_count = server-to-server-send-retries-count]#
80[set pd_ipc_recv_count = server-to-server-receive-retries-count]#
81[set pd_inet_unix_bufmode = os | conf]#
82[set pd_ipc_inet_bufsize = send-receive-buffer-size-for-server-to-server-communication]#
83[set pd_tcp_inet_bufsize = send-receive-buffer-size-for-communication-with-HiRDB-client]#
84[set pd_listen_socket_bufset = 0 | 1]#
85[set pd_inet_unix_utl_bufmode = auto | conf]#
86[set pd_java_archive_directory = "JAR-file-storage-directory"]#Java
87[set pd_java_classpath = "Java-class-path"]#
88[set pd_java_runtimepath = "Java-Runtime-Environment-root-directory"]#
89[set pd_java_libpath = "Java-virtual-machine-library-directory"]#
90[set pd_java_stdout_file = "Java-virtual-machine-standard-output-and-standard-error-output-destination-file"]#
91[set pd_c_library_directory = "C-library-file-storage-directory"]External C stored routines
92[set pd_tmp_directory = work-file-output-directory]Modifying the directory for work file output
93[putenv SHMMAX maximum-shared-memory-segment-size]#Shared memory

#: When this operand is omitted, the value specified for the same operand in the system common definition is used.