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 automatic log filename generation and cycling properties.
The spdsserv command-line options also control the message and audit
logging functions. Message and audit logging facilities include automatic
log filename generation and periodic 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.
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 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];
You probably do not
need to modify the default values in
InstallDir\site\spdsserv.parm.
For more
information about the parameter file and the server parameters, see Setting Up SPD Server Parameter Files .
specifies the directory
path to the SPD Server host 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 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 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.
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.
specifies that the
logger process will automatically create a server log file. The fileSpec value specifies a partial pathname or
filename that is used to generate the complete log file path. For
example, if you specify fileSpec as\DOWNlogs\spds, the generated name
will be: \DOWNlogs\spds_ mmddyyyy_hh:mm:ss.spdslog. In this example, 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.
enables audit logging
for the server and automatic audit log file creation by the audit
process. The fileSpec value
specifies a partial pathname 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 mmddyyyy_yyyy.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.