Setting Up SPD Server Parameter Files

Introduction
The spdssrv command, which starts up an SPD Server host requires a parameter file, or parmfile, named spdsserv.parm. You specify the spdsserv.parm file with the command-line option -parmfile.

Syntax for the -Parmfile Option

-parmfile file-spec

where file-spec is an explicit file path for SPD Server's parameter file. The spdsserv.parm file is required because it maintains options that control SPD Server's processing behavior and/or use of server resources.If you do not specify the file using the - Parmfile option, SPD Server assumes that spdsserv.parm is located in the server's current working directory.

Syntax for spdsserv.parm Options

Option[ = Value];

where value is option dependant. All option keywords are case sensitive and must be capitalized (see the samples that follow). Note that comments are not allowed in the parmfile. Any value that is a memory size is in bytes and can support a m or M suffix to specify megabytes, or a g or G suffix to specify gigabytes. The following sample spdsserv.parm files (see InstallDir/samples/spsdserv.parm) contain the recommended default settings for SPD Server.

spdserv.parm Options
INDEX_MAXMEMORY Description Affects read operations on SPD Server tables. The value specified restricts the amount of memory to allocate each open index. [To Spdserv.parm Option List]

SORTSIZE=(valid memory size) Description

Controls the amount of memory to allocate for sort operations. A larger value can increase the paging activity for a file and degrade performance. [To Spdserv.parm Option List]

INDEX_SORTSIZE= Description Controls the amount of memory to be allocated for asynchronous (parallel) sort index creation or appends. This specified value is divided by the number of indexes, n, to be created or appended in parallel; each receives 1/nth of the memory allocation. [To Spdserv.parm Option List]

BINBUFSIZE= Description Controls the amount of memory that is used for each sort bin merge buffer. Each bin is equal to the value specified for SORTSIZE. When the sort operation overflows a single sort bin, SPD Server writes the bins to disk and then merges the bins to produce the final, sorted run. This parameter sets the size of the I/O buffer that must be used to read each bin. Note: If you specify a value smaller than the record length of the sort bin, the software creates a bin buffer large enough to hold one record. [To Spdserv.parm Option List]

WORKPATH= Description Specifies the LIBNAME proxy path for work files. If you anticipate that work files may overflow a single file system, you can specify multiple paths. When specifying multiple paths, enclose the complete path statement in double quotes.
"('DirPath1' 'DirPath2' ...)"

[To Spdserv.parm Option List]

[NO]COREFILE Description

Controls whether the LIBNAME proxy creates a core file in the event of an unexpected process trap. The default is NOCOREFILE. [To Spdserv.parm Option List]

SEQIOBUFMIN= Description Specifies the minimum sequential I/O buffer size. The value specified becomes

the minimum I/O buffer size used by the proxy when it performs sequential I/O, table requests the maximum value for the IOBUFSIZE LIBNAME option.

[To Spdserv.parm Option List]

RANIOBUFMIN= Description Specifies the minimum random I/O buffer size. The value specified becomes

the minimum I/O buffer size used by the proxy when it performs random I/O and table requests the maximum value for the IOBUFSIZE LIBNAME option.

[To Spdserv.parm Option List]

[NO]ALLOWMMAP Description Controls whether the memory that is mapped for I/O can be used by the LIBNAME proxy for tables and indexes. The default ALLOWMMAP allows interpretation of the MEMMAP= LIBNAME option. If NOALLOWMMAP is specified, the MEMMAP= LIBNAME option is ignored. [To Spdserv.parm Option List]

MMAPLIMIT Description Specifies the maximum size of a single MMAP request for the proxy.

[To Spdserv.parm Option List]

MMAPLOWMEM Description Places a threshold on the amount of process address space to make available to MMAP a file. If the process address space extends to the specified maximum value allowed, MMAP is disabled to allow address space for heap expansion if required. [To Spdserv.parm Option List]

MAXWHTHREADS Description Specifies the number of parallel threads to launch for a WHERE-clause evaluation. [To Spdserv.parm Option List]

GRPBYROWCACHE= Description Specifies the maximum amount of memory threads use during parallel group aggregations. Parallel group SELECT uses multiple threads up to the MAXWHTHREADS= limit to perform partial group aggregations. The threads evenly share the memory specified using GRPBYROWCACHE to cache groups in memory; each thread receives 1/MAXWHTHREADS= of the cache. Once a thread accumulates enough distinct groups to fill its cache, the groups are flushed to secondary bins. At the completion of the parallel groupby, the partial group aggregations in memory and secondary storage are merged to assemble the final results. If omitted, the default is a 2 MB cache per thread. Increasing the default value can result in improved aggregation performance in cases with large numbers of groups. The trade-off is the potential of allocating more memory than is needed for caching, taking away that potential from the processing load. [To Spdserv.parm Option List] MAXSEGRATIO= Description

Controls segment candidate pre-evaluation for WHERE-clause predicates with a hybrid index. The WHERE planner pre-evaluates to determine the candidate segments for the predicate. Only the candidate segments are actually searched to resolve the WHERE-clause. Some queries can benefit from cutting off the pre-evaluation based on the ratio of the number of segments containing candidates to the total number of segments in the file. If the percentage of possible segments exceeds this threshold, the pre-evaluation is skipped and all segments are searched to resolve the WHERE-clause. If omitted, the default value is 75 percent. [To Spdserv.parm Option List]

SQLOPTS= Usage SQLOPTS= "RESET <SQL-option> [ ,<SQL-option.]" Description You specify SQLOPTS on an SQL RESET command to override SQL default options for each SQL connect. If no SQLOPTS= command is specified, the compiled defaults apply. See the SQL RESET command for possible RESET options you can set. [To Spdserv.parm Option List] LIBACLINHERIT= Usage LIBACLINHERIT= [ YES | NO ] (Default is NO) Description You use LIBACLINHERIT= to specify whether or not the LIBNAME ACL resource definition is inherited by ACL permission checks made on resources within the LIBNAME domain. [To Spdserv.parm Option List]

IDLE_TIMEOUT= Usage: IDLE_TIMEOUT= <timeout_seconds>

Description Specifies the interval of idle time permitted before the SPD Server client process automatically terminates the client connection. When the IDLE_TIMEOUT= is specified as a value greater than 0, the option is enabled. If the value is less than or equal to 0, SPD Server disables idle timeouts. The default setting is 0. [To Spdserv.parm Option List]