Starting Digital Certificate Access Server

You can start the DCAS from the z/OS® UNIX shell or with an MVS™ started procedure using optional parameters for debugging, logging, and specifying the configuration file. To start the DCAS from the z/OS UNIX shell, use the following format:
dcas <parameter_1> <parameter_2> <parameter_3> &
To start the DCAS from an MVS started procedure, use the following format:
PARM=.../<parameter_1> <parameter_2> <parameter_3>

The following optional parameters can be used with both the DCAS UNIX command and 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 attempts to open the default log file /tmp/dcas.log. If this fails, debugging is turned off.

For SYSLOGD, the DCAS 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 looks for the configuration file using the following search order:
  1. DCAS_CONFIG_FILE environment variable
  2. /etc/dcas.conf
  3. tsouserid.DCAS.CONF
  4. TCPIP.DCAS.CONF
Restriction: If the DCAS does not find a valid configuration file, it does not start.

Start of changeThe /tmp/dcas.tcpname.pid is a temporary DCAS pid file that the DCAS creates. This file contains the process ID of the current invocation of the DCAS.End of change

Restrictions: Start of change
  • If /tmp/dcas.tcpname.pid is a symbolic link, it must have an owning UID or GID that matches the EUID or EGID that is assigned to the DCAS.
  • If /tmp/dcas.tcpname.pid is a hard link or the target of a hard link, users that are outside the owner or group of the directory in which /tmp/dcas.tcpname.pid is stored cannot have write access to the directory. Additionally, write access to /tmp/dcas.tcpname.pid must be limited to the owning UID or group, for example, --w--w----permissions.
End of change