Syslogd environment variables

Table 1 provides a list of environment variables used by syslogd that can be tailored to a particular installation.

Table 1. Syslogd environment variables
Environment variable	Description	Specific coding rules
SYSLOGD_CODEPAGE	Used by the syslog daemon to specify the EBCDIC code page to be used for the configuration file. The default code page is IBM®-1047.	The following code pages are supported: IBM-037 IBM-273 IBM-274 IBM-275 IBM-277 IBM-278 IBM-280 IBM-281 IBM-282 IBM-284 IBM-285 IBM-297 IBM-500 IBM-871 IBM-1047 IBM-1140 IBM-1141 IBM-1142 IBM-1143 IBM-1144 IBM-1145 IBM-1146 IBM-1147 IBM-1148 IBM-1149 Example: `SYSLOGD_CODEPAGE=IBM-1141`
SYSLOGD_CONFIG_FILE	Specifies the name of the syslogd configuration file.	The -f start option overrides this value. Example: `SYSLOGD_CONFIG_FILE=/etc/syslog.conf`
SYSLOGD_DEBUG_DATASET	If this environment variable is not set, the debug output goes to STDOUT. The environment variable can be set to STDOUT, which will also cause the output to be written to STDOUT. On SYSLOGD shutdown, the SYSLOGD_DEBUG_VARIABLE is reset, which causes residual debug output to be written to STDOUT.	Write debug output to an MVS™ dataset `export SYSLOGD_DEBUG_DATASET="//'USER1.SYSLOGD.DEBUG'"` Write debug output to a UNIX file `export SYSLOGD_DEBUG_DATASET="/tmp/syslogd_debug"`
SYSLOGD_DEBUG_LEVEL	Specifies the debug level to be used by syslogd.	You can specify the following debug levels. You can add these together in any combination to select the type of debug messages to be written. 1 Base debugging information. 2 Configuration file processing. 4 Processing of messages being logged by syslogd. 8 Automatic archive processing. 16 Operator command processing. 32 Thread-specific processing. 64 Mutex lock processing. Locks that are specific to threads are logged only if the debug level includes 32. For example, `SYSLOGD_DEBUG_LEVEL=91` includes all debugging information except for message handling and thread-specific processing (including locks). The default debug level is 127, which includes all debug information.
SYSLOGD_PATH_NAME	Specifies the path name of the z/OS UNIX character device for the datagram socket.	The -p start option overrides this value. The default value is /dev/log.
SYSLOGD_TCPTHREADPOOL_SIZE	Specifies the number of threads allocated for inbound TCP connections from remote syslogd clients	By default, 128 threads are allocated for incoming TCP connections. If a small number of remote systems are expected to connect and send messages to this syslogd instance, you can use this environment variable to limit the number of threads allocated for TCP connections. You can specify a value from 5-128.

When starting syslogd from a shell script, export the environment variables before starting syslogd. The following example defines the syslogd configuration file:
```
#
# Shell script to start syslogd
#
export _BPX_JOBNAME='SYSLOGD1'
export SYSLOGD_CONFIG_FILE="//'HLQ.SYSLOGD.CONFIG(DEFAULT)'"
 /usr/sbin/syslogd &
```
When starting syslogd directly from a started procedure, place the syslogd environment variables in a z/OS® UNIX file or MVS data set. Use the following technique to pass the environment variables to syslogd.
```
// PARM='ENVAR("_CEE_ENVFILE=DD:STDENV")/'

//STDENV DD PATH='/etc/syslogd.env',PATHOPTS=(ORDONLY)

or

//STDENV DD DSN=HLQ.SYSLOGD.ENV(DEFAULT),DISP=SHR
```
When you use an MVS data set for your syslogd environment variables, place the environment variables in a data set with the VB record format [RECFM(VB)] and a logical record length of 256 [LRECL(256)]. If you use any other record format for the data set, use the _CEE_ENVFILE_S environment variable in place of the _CEE_ENVFILE environment variable in your syslogd started procedure. When the _CEE_ENVFILE_S environment variable is used, the system removes trailing blank spaces from each NAME=VALUE line that is read. For additional information about the _CEE_ENVFILE_S environment variable, see z/OS XL C/C++ Programming Guide.