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.
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. The spdsserv command-line
options control the message and audit logging functions. Message and
audit logging functions include automatic log filename generation
and log file cycling support. You can periodically switch to a new
name server log file without stopping and restarting SPD Server, which
improves the availability of the name server.
The spdsserv command-line
options control automatic log filename generation cycling properties.
The default rc.spds script shipped in the
samples/ directory of your SPD Server installation provides examples of the
command-line options.
Audit log records are
kept for all resources that are 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 you are using automatic
server log cycling or audit log cycling, remember to periodically
clean the log files. Proper log file maintenance includes archiving
logs using secondary or long-term storage. Many users retain only
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.
Invoke the SPD Server
host by using the following command-line syntax:
spdsserv [-option [optval]...]
The
spdsserv command supports the following options:
specifies the directory
path to the SPD Server host SPD Server password file. You can omit
this option if the PASSPATH option is declared in the SPD Server host's
-PARMFILE option. A valid SPD Server password file is required even
when you specify the -NOACL option. You must use the SPD Server psmgr
utility to create the password file and to populate it with the set
of valid SPD Server user IDs.
enables audit logging
for the server and automatic audit log file creation by the audit
process. fileSpec specifies
a path or filename that is used to generate the complete audit file
path. For example, if you specify fileSpec as /audit/spds, the generated name
will be/audit/spds_mmddyyyy_hh:mm:ss.spdsaudit, where mmddyyyy is the
system date when the log file was created.
specifies the time
of day to cycle a new generation of the audit log file. At this time
each day, the previous log file will be closed and a new log file
will be opened.
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.
For more information about SPD Server LIBNAME parameter files, see Setting Up SPD Server Libname Parameter Files .
specifies that the
logger process automatically creates a server log file. The fileSpec value specifies a partial path or filename
that is used to generate the complete log file path. For example,
if you specify fileSpec as /logs/spds, the generated name will be /logs/spds mmddyyyy_hh:mm:ss.spdslog, where mmddyyyy and hh:mm:ss indicate the system time when the log file was created.
specifies the time
of day to cycle a new generation of the server log file. At this time
each day, the previous log file will be closed and a new log file
will be opened.
specifies the node
name where the name server process is running. This node does not
need to be the same node that is hosting the SPD Server host processes.
This option is required.
specifies an explicit
TCP port number for the SPD Server host to use to connect to its name
server. If you do not specify a port, the name server queries the
system for a registered port address that is using the service name
spdsname.
disables SPD Server
login validation for SPD Server LIBNAME engine connections to the
SPD Server host.
specifies 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 that 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. You do not need to modify the default values
in
InstallDir/site/spdsserv.parm for
most environments.
For more information about the parameter file and setting
up server parameters, see Setting Up SPD Server Parameter Files .