Interstage Shunsaku Data Manager Installation Guide - Solaris(TM) Operating System -

A.2.4 Creating the System Environment File

Create a new system environment file.

Copy from the system environment file sample shown below to create a new system environment file.

/etc/opt/FJSVshnsk/etc/system/system.cfg-sample

Set the name of the edited system environment file to "Shunsaku system name.cfg" and store it in the same directory as the sample file.

The following table shows the execution parameters of the system environment file.

Refer to System Environment Files of the Operator's Guide for details of the system environment file.

[Table A-1 System Environment File List]

Execution parameter	Explanation	Mandatory?	Items to be entered	Notes
Conductor	conductor server information	Mandatory	Conductor identifier Host name or IP address allocated for the conductor Port number for receiving requests	-
Sorter	sorter server information	Mandatory	Sorter identifier Host name or IP address allocated for the sorter Port number for receiving sort requests from the conductor	-
Director	director server information	Mandatory	Director identifier Host name or IP address allocated for the director Port number for issuing search requests to searchers Port number for issuing update requests to searchers Port number for receiving requests Director number	-
Searcher	searcher server information	Mandatory	Searcher identifier Host name or IP address allocated for the searcher Port number for receiving requests from the director Director identifier of the director to be connected to	-
CharacterCode	Character code for lookup data	Optional	UTF-8 SHIFT-JIS EUC GB2312 big5 KSC5601 Select one of the above.	Default: UTF-8
ANKmix	Case sensitivity for alphanumeric characters	Optional	Select either: 0: Match case 1: Do not match case	Default: 0
KNJmix	Case sensitivity for multi-byte alphabetic characters	Optional	Select either: 0: Match case 1: Do not match case	Default: 0
SkipChar	Skip character (characters that will not be searched)	Optional	Enclose characters that are to be excluded from searches in double quotation marks.	If omitted, all character strings are subject to searches.
ExtendedQuery	Query format	Optional	Select either: 0: Compatible format queries not used 1: Compatible format queries used	Default: 0
SeparateChar	Delimiter character	Optional	Enclose the characters to be used as the delimiter in double quotation marks.	If omitted, the characters in Default Delimiters are used as the delimiter.
MonitoringStyle	Output format for monitoring.	Optional	Select either 0: New output format 1: 6.0 output format	Default: 0
SearchAttribute	Search attribute values	Optional	Select either 0: Search attribute values 1: Do not search attribute values (*1)	Default: 0

*1) It is not necessary to add the parameter to valid the attribute value search. However, note that there are some notes on XML data. Refer to Notes on the XML Format of the Application Development Guide for details.

The procedures for setting the various execution parameters are described below.

Conductor

• Conductor identifier

  Set the conductor identifier that was checked or determined as described in Checking the Conductor Information under A.2.2 Checking the System Process Configuration

• Host name or IP address

  Set the host name or IP address of the director server.

• Port number for receiving requests

  Determine the port number used to receive requests from applications, as shown in the following table:

  Operating format of current system	Method for determining the port number
  Conductor used	Set the port number that is set as the MySearchPort parameter of the conductor environment file.
  Conductor not used	Set a port number that is not being used by the director server.

Sorter

• Sorter identifier

  Set the sorter identifier that was checked or determined as described in Checking the Sorter Information under A.2.2 Checking the System Process Configuration.

• Host name or IP address

  Set the host name or IP address of the director server.

• Port number for receiving requests from the conductor

  Determine the port number used to receive requests from the conductor, as shown in the following table:

  Operating format of current system	Method for determining the port number
  Sorter used	Set the port number that is set as the SorterInfo parameter in the conductor environment file.
  Sorter not used	Set a port number that is not being used by the director server.

Director

Set the number of directors and the director parameters used in the current system, determined as described in Checking the Director Information under A.2.2 Checking the System Process Configuration, as follows:

• Director identifier

• Host name or IP address

  Set the host name or IP address of the director server.

• Port number for issuing search requests to searchersSearch port number for the searcher

  Set the SearcherSearchPort value from the director environment file.

• Port number for issuing update requests to searchersUpdate port number for the searcher

  Set the SearcherEntryPort value from the director environment file.

• Port number for receiving requests

  Set the MySearchPort value from the director environment file.

• Director number

  Determine the director number as shown in the following table:

  Operating format of current system	Method for determining the director number
  Conductor used	The director number entered for Directorinfo in the conductor environment file
  Conductor not used	Since there is one director used for operations in the current system, set 10.

Searcher

Set the number of searchers and the searcher parameters used in the current system, determined as described in Checking the Searcher Information under A.2.2 Checking the System Process Configuration, as follows:

• Searcher identifier

• Host name or IP address

  Set the host name or IP address of the server where the searcher is installed.

• Port number for receiving requests from the director

  Set the MyPort value in the searcher environment file.

• Director identifier of the director to be connected to

CharacterCode

Determine the CharacterCode value as shown in the following table:

Operating format of current system	Method for determining the CharacterCode
Conductor used	Set the same value as the value specified in the CharacterCode parameter of the conductor environment file. If the CharacterCode parameter was omitted, set the value that was specified in the CharacterCode parameter of the director environment file. If both were omitted, also omit it here.
Conductor not used	Set the same value as the value specified in the CharacterCode parameter of the conductor environment file. If the CharacterCode parameter was omitted, also omit it here.

ANKmix

Omit this specification because the ANKmix parameter in the director environment file is set separately for each director.

KNJmix

Omit this specification because the KNJmix parameter in the director environment file is set separately for each director.

This parameter is valid with Japanese character codes. To use Japanese character code, specify "UTF-8", "SHIFT-JIS" or "EUC" for the CharacterCode parameter.

SkipChar

Omit this specification because the SkipChar parameter in the director environment file is set separately for each director.

ExtendedQuery

Specify the value indicating whether or not compatible format queries are used, as shown in the table below. If this parameter is omitted, 0 is assumed.

Specification	Method for determining ExtendedQuery
0	Compatible format queries not used
1	Compatible format queries used

Refer to Search Expressions of the Application Development Guide for details of compatible formats.

SeparateChar

This parameter is valid when "Compatible format queries not used" is specified for the ExtendedQuery specification.

Multiple characters can be specified in the SeparateChar parameter. If so, separate each character string with a comma (,).

For the SeparateChar parameter, specify new line, horizontal tab, and ASCII characters other than control characters.

When a character shown below is specified for the SeparateChar parameter, add an escape character to indicate that it is a SeparateChar parameter. The escape character is "\".

Delimiter character	Specification method
Space	\s
Linefeed	\n
Horizontal tab	\t
Comma	\,
Double quote	\"
Backslash	\\

If this parameter is omitted, the following 'Delimiters' are assumed:

Default Delimiters

\t	\n	\s	!	\"	#
$	%	&	'	(	)
*	+	\,	-	.	/
:	;	<	=	>	?
@	[	\\	]	^	_
`	{	|	}	~

MonitoringStyle

From the table below, determine the output format used for monitoring. If this parameter is omitted, 0 is assumed.

Specification	Output format
0	If none of the options w, p, i or c is specified in the shuncstate, shunostate, shundstate, or shunsstate commands, the w option is assumed and information is displayed in the new output format.
1	If none of the options w, p, i or c is specified in the shuncstate, shunostate, shundstate, or shunsstate commands, information is displayed in the 6.0 output format.

SearchAttribute

Specify the following value whether to search the attribute value. If this parameter is omitted, 0 is assumed.

Specification	Method for determining SearchAttribute
0	Search attribute values
1	Do not search attribute values

Refer to Notes on the XML Format in the Application Development Guide for more information on the notes on the XML format when searching attribute values.