docmain.css" /> Optional Parameters - Automated Sign-On for Mainframe Administrator Guide

Optional Parameters

The following optional parameters can be used from either the z/OS UNIX shell or the MVS started procedure:

-d or -D

Indicates debugging. The following levels apply:

  • 1= Specifies log error and warning messages.
  • 2= Specifies log error, warning, and informational messages. 
  • 3= Specifies log error, warning, informational, and debug messages. This is the default.

-l or -L

Indicates logging to SYSLOGD or to a designated log file. If you do not specify this parameter, logging defaults to /tmp/dcas.log. If you specify a debug level, but not logging, then the DCAS server attempts to open the default log file /tmp/dcas.log. If this fails, debugging is turned off. For SYSLOGD, the DCAS server uses the log facility local0.

-c or -C

Indicates the requested configuration file (for example, /u/userx/passtick.conf). If you do not specify this parameter, the DCAS server looks for the configuration file using the following search order: DCAS_CONFIG_FILE environment variable /etc/dcas.conf tsouserid.DCAS.CONF TCPIP.DCAS.CONF

If the DCAS server does not find a valid configuration file, it will not start.

When DCAS is started, the process ID (pid) is stored in a Hierarchical File System (HFS) file. The file name under which it is stored depends upon how you configure DCAS:

  • If the DCAS server is configured with TCP/IP stack affinity, the pid file is named /tmp/dcas.tcpipname.pid where tcpipname is the name of the TCP/IP stack for which DCAS has affinity.

  • If the DCAS server is configured without stack affinity, the pid file is named /tmp/dcas.INET.pid.

You can stop the DCAS server from the UNIX shell or from MVS:

  • To stop the DCAS server from the UNIX shell, use the following command: kill -s SIGTERM pid

  • To stop the DCAS server from MVS, use the following command: P DCAS