The SPD
Server LIBNAME engine connects to the SPD Server host to access data
in the server environment. The SPD Server host uses the SPD Server
password file to validate each SPD Server user, and then creates a
LIBNAME proxy process on behalf of each of them.
The SPD
Server host is invoked using the following command-line syntax:
spdsserv [-option [optval]...]
Part of
the function of the SPD Server host process is to start SPD Server
logging processes. The spdslog process performs message logging functions.
The spdsaud process performs audit logging functions. Message and
audit logging functions are controlled using spdsserv command-line
options. Both message and audit logging facilities include automatic
log file-naming and periodic log file cycling support.
The
spdsserv command-line options control automatic log
filename generation and cycling properties. Server availability improves
because you can periodically switch to a new server log and audit
log without stopping and restarting SPD Server.
Audit
log records are kept for all resources accessed by each LIBNAME proxy
process. The audit log saves records in its own separate space, away
from other server log files. A sample SAS job that processes the audit
log and generates a report is provided. Check
samples\audit.sas for information about processing the audit log and generating the
report. To enable the audit log, use the
spdsserv command with the -AUDITFILE option.
When using
automatic server log cycling or audit log cycling, remember to periodically
clean the log files. Proper log file maintenance archiving logs using
secondary or long-term storage.
Many users
only retain a few generations of log files for quick reference. A
shell script that runs on a regular basis (such as CRONTAB) is a good
way to perform log maintenance on your server machine.
The
spdsserv command supports the following options:
Allows you to specify
an explicit file path for the SPD Server host's parameter file. This
file is mandatory and contains any SPD Server options. If this option
is omitted, the SPD Server host assumes a parameter file named spdsserv.parm
is in the process's current working directory. Option declarations
in this file are of the following form:
Option[ = Value];
The recognized -PARMFILE
option names are listed, but full descriptions are available only
in online documentation. Most sites do not need to modify the default
values in
InstallDir\site\spdsserv.parm. For more information about the parameter file, see "Setting Up
SPD Server Parameter Files" in the
SAS Scalable Performance
Data (SPD) Server 4.5: Administrator's Guide.
For more information
about server parameters, see Introduction"Setting Up SPD Server Parameter Files."
Specifies the directory
path to the SPD Server host password file. This option can be omitted
if the PASSPATH= option is declared in the SPD Server host's -PARMFILE
option. A valid SPD Server password file is required even when running
with the -noacl option. You must use the
SPD Account Manager to create the password file and to populate it
with the set of valid SPD Server user IDs.
Disables SPD Server
login validation for SPD Server LIBNAME engine connections to the
SPD Server host.
Specifies the node
name where the Name Server process is running. This does not need
to be the same node that is hosting the SPD Server host processes.
This option is required.
Allows you to specify
an explicit TCP port number for the SPD Server host to use to connect
to its Name Server. If no port is specified, the Name Server queries
the system for a registered port address using the service name spdsname.
Specifies the name
of the file that contains the logical LIBNAME domain definitions that
the SPD Server host supports. LIBNAME definitions can span multiple
lines, and must begin with the LIBNAME=name keyword. Each LIBNAME
definition must be terminated with a ; character.
Selects automatic server
log file creation by the logger process.
fileSpec specifies a partial pathname or filename specification that is used
to generate the complete log file path. For example, if you specified
fileSpec as
\DOWNlogs\spds, the generated name would appear as:
\DOWNlogs\spds_
mmddyyyy_hh:mm:ss.spdslog
where
mmddyyyy and
hh:mm:ss are taken from the system time when the log file is created.
Specifies a time of
day to cycle a new generation of the server log file. At this time
each day, the previous log file is closed and a new log file is opened.
Enables audit logging
for the server and automatic audit log file creation by the audit
process.
fileSpec specifies a partial pathname
or filename specification that is used to generate the complete audit
file path. For example if you specified
fileSpec as
\audit\spds, the generated name
would appear as
mmddyyyy_yyyy.spdsaudit
where
mmddyyyy is taken
from the system date when the log file is created.
Specifies a time of
day to cycle a new generation of the audit log file. At this time
each day, the previous log file is closed and a new log file is opened.