Operand formats

Nonstop Database, HiRDB Version 9 System Definition

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 G. List of Operands That Can Be Specified When Using the Standby-less System Switchover (Effects Distributed) Facility (Unit Control Information Definition).

(1) System structure

No.	Format
1	set pd_unit_id = unit-identifier
2	[set pd_hostname = host-name]

(2) Maximum concurrent executions

No.	Format
3	[set pd_max_server_process = maximum-number-of-concurrently-activated-server-processes]^#

(3) HiRDB startup

No.	Format
4	[set pd_term_watch_count = maximum-number-of-successive-abnormal-terminations]^#

(4) HiRDB processing

No.	Format
5	[set pd_thdlock_wakeup_lock = Y \| N]^#
6	[set pd_db_io_error_action = dbhold \| unitdown]^#

(5) Full recovery processing

No.	Format
7	[set pd_max_recover_process = concurrently-executable-full-recovery-processes-count]^#

(6) Transaction decision processing

No.	Format
8	[set pd_trn_rcvmsg_store_buflen = transaction-recovery-message-queue-size]^#

(7) System monitoring

No.	Format
9	[set pd_down_watch_proc = upper-limit-for-server-process-abnormal-terminations[,monitoring-interval]]^#

(8) SQL runtime warning output facility

No.	Format
10	[set pd_cwaittime_report_dir = SQL-runtime-warning-information-file-output-destination-directory]^#
11	[set pd_cwaittime_report_size = SQL-runtime-warning-information-file-maximum-size]^#

(9) Facility for output of extended SQL error information

No.	Format
12	[set pd_uap_exerror_log_dir = SQL-error-report-file-storage-directory]^#
13	[set pd_uap_exerror_log_size = SQL-error-report-file-maximum-size]^#
14	[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]^#

(10) Lock

No.	Format
15	[set pd_lck_wait_timeout = lock-release-wait-time]^#
16	[set pd_lck_deadlock_info = Y \| N]^#
17	[set pd_lck_deadlock_check = Y \| N]^#
18	[set pd_lck_deadlock_check_interval = deadlock-check-interval]^#

(11) Buffers

No.	Format
19	[set pd_thread_stack_expand_size = stack-extension-size-per-thread]

(12) Shared memory

No.	Format
20	[set pd_shmpool_attribute = free \| fixed]^#
21	[set pd_dbbuff_attribute = free \| fixed]^#

(13) Statistical information

No.	Format
22	[set pd_stj_file_size = maximum-statistics-log-file-size]^#
23	[set pd_stj_buff_size = statistics-log-buffer-size]^#

(14) RPC trace information

No.	Format
24	[set pd_rpc_trace = Y \| N]^#
25	[set pd_rpc_trace_name = "name-of-RPC-trace-collection-file"]^#
26	[set pd_rpc_trace_size = RPC-trace-collection-file-size]^#

(15) Performance trace information

No.	Format
27	[set pd_prf_level = 00000007 \| 0000001f \| 0000007f \| 000001ff \| 00000000]^#
28	[set pd_prf_file_count = number-of-performance-trace-information-file-generations]^#
29	[set pd_prf_file_size = size-of-a-performance-trace-information-file]^#
30	[set pd_prf_output_directory = directory-to-which-performance-trace-information-files-are-output]

(16) Troubleshooting information

No.	Format
31	[set pd_cancel_dump = put \| noput]^#
32	[set pd_dump_suppress_watch_time = troubleshooting-information-output-suppression-time]^#
33	[set pd_spool_cleanup_interval = troubleshooting-information-deletion-interval]^#
34	[set pd_spool_cleanup_interval_level = number-of-days[,deletion-type]]^#
35	[set pd_spool_cleanup = normal \| force \| no]^#
36	[set pd_spool_cleanup_level = number-of-days [,deletion-type]]^#
37	[set pd_module_trace_max = maximum-number-of-module-traces-that-can-be-stored]^#
38	[set pd_module_trace_timer_level = 0 \| 10 \| 20]^#
39	[set pd_pth_trace_max = maximum-number-of-stored-communication-traces]^#

(17) Unit status files

No.	Format
40	set pd_syssts_file_name_1 = "logical-file-name","file-a-status-file-name","file-b-status-file-name"
	[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"]
41	[set pd_syssts_subfile_name_1 = "logical-file-name","primary-status-file-name-for-log-application-processing","secondary-status-file-name-for-log-application-processing"]
	[set pd_syssts_subfile_name_2 = "logical-file-name","primary-status-file-name-for-log-application-processing","secondary-status-file-name-for-log-application-processing"]
	[set pd_syssts_subfile_name_3 = "logical-file-name","primary-status-file-name-for-log-application-processing","secondary-status-file-name-for-log-application-processing"]
	[set pd_syssts_subfile_name_4 = "logical-file-name","primary-status-file-name-for-log-application-processing","secondary-status-file-name-for-log-application-processing"]
	[set pd_syssts_subfile_name_5 = "logical-file-name","primary-status-file-name-for-log-application-processing","secondary-status-file-name-for-log-application-processing"]
	[set pd_syssts_subfile_name_6 = "logical-file-name","primary-status-file-name-for-log-application-processing","secondary-status-file-name-for-log-application-processing"]
	[set pd_syssts_subfile_name_7 = "logical-file-name","primary-status-file-name-for-log-application-processing","secondary-status-file-name-for-log-application-processing"]

(18) Unit status files (when an error occurs)

No.	Format
42	[set pd_syssts_last_active_file = "logical-file-name"]
43	[set pd_syssts_last_active_side = A \| B]
44	[set pd_syssts_last_active_subfile = "logical-file-name"]
45	[set pd_syssts_last_active_side_sub = A \| B]

(19) Security

No.	Format
46	[set pd_audit = Y \| N]^#
47	[set pd_aud_file_name = HiRDB-file-system-area-name-for-audit-trail-file]^#
48	[set pd_aud_max_generation_size = audit-trail-file-maximum-size]^#
49	[set pd_aud_max_generation_num = maximum-audit-trail-file-count]^#
50	[set pd_aud_async_buff_size = size-of-buffer-used-for-asynchronous-output-of-audit-trail-file]^#
51	[set pd_aud_async_buff_count = number-of-buffer-sectors-used-for-asynchronous-output-of-audit-trail-file]^#
52	[set pd_aud_async_buff_retry_intvl = retry-interval-for-allocation-of-a-buffer-to-be-used-for-asynchronous-output-of-audit-trail-file]^#
53	[set pd_aud_sql_source_size = size-of-SQL-statement-output-to-audit-trail]
54	[set pd_aud_sql_data_size = size-of-SQL-data-output-to-audit-trail]

(20) System switchover facility

No.	Format
55	[set pd_ha_acttype = monitor \| server]
56	[set pd_ha_unit = nouse]
57	[set pd_ha_restart_failure = command-name]
58	[set pd_ha_switch_timeout = Y \| N]^#
59	[set pd_ha_server_process_standby = Y \| N]
60	[set pd_ha_agent = standbyunit \| server \| activeunits]
61	[set pd_ha_max_act_guest_servers = maximum-number-of-acceptable-guest-BES]
62	[set pd_ha_max_server_process = maximum-number-of-user-server-processes-inside-accepting-unit]
63	[set pd_ha_process_count = number-of-processes-resident-inside-unit-after-acceptance-of-guest-BES]
64	[set pd_ha_resource_act_wait_time = maximum-wait-time-for-resource-activation]^#
65	[set pd_ha_ipaddr_inherit = Y \| N]^#

(21) HiRDB Datareplicator

No.	Format
66	[set pd_rpl_hdepath = extracted-side-HiRDB-Datareplicator-directory-name]

(22) Communication processing

No.	Format
67	[set pd_service_port = scheduler-process-port-number]^#
68	[set pd_change_clt_ipaddr = 0 \| 1 ]^#
69	[set pd_registered_port = "port-number-reservation-range" [,"port-number-reservation-range"]...]^#
70	[set pd_registered_port_check = Y \| N \| C \| W]^#
71	[set pd_ipc_send_retrycount = process-to-process-send-retries-count]^#
72	[set pd_ipc_send_retrysleeptime = process-to-process-send-retry-sleep-time]^#
73	[set pd_ipc_send_count = server-to-server-send-retries-count]^#
74	[set pd_ipc_recv_count = server-to-server-receive-retries-count]^#

(23) Java

No.	Format
75	[set pd_java_archive_directory = "JAR-file-storage-directory"]^#
76	[set pd_java_classpath = "Java-class-path"]^#
77	[set pd_java_runtimepath = "Java-Runtime-Environment-root-directory"]^#
78	[set pd_java_libpath = "Java-virtual-machine-library-directory"]^#
79	[set pd_java_stdout_file = "Java-virtual-machine-standard-output-and-standard-error-output-destination-file"]^#

(24) External C stored routines

No.	Format
80	[set pd_c_library_directory = "C-library-file-storage-directory"]

(25) Modifying the directory for work file output

No.	Format
81	[set pd_tmp_directory = work-file-output-directory]

(26) Shared memory

No.	Format
82	[putenv SHMMAX maximum-shared-memory-segment-size]^#

(27) Sharing of HiRDB system definition files

No.	Format
83	[putenv PDCONFPATH shared-directory-name]

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