docmain.css" /> 5. Start the DCAS server. - Automated Sign-On for Mainframe Administrator Guide

5. Start the DCAS server.

The DCAS server can be started as a generic server without stack affinity or as a server with affinity to a specific TCP/IP stack. The DCAS server can be started in different ways (detailed steps follow):

  • automatically when the TCP/IP address space is started.

  • from the z/OS UNIX shell.

  • from an MVS started procedure.

To start the DCAS server automatically when the TCP/IP address space is started, specify DCAS on the AUTOLOG statement in the TCPIP profile dataset. For example: 

AUTOLOG 
DCAS 
ENDAUTOLOG 

The following sample procedure can be used to start DCAS. First, enter the command S DCAS. To pass optional parameters to DCAS, specify them after the final slash (/) on the PARM statement, for example: 

// PARM=('POSIX(ON) ALL31(ON)' 
// 'ENVAR("LIBPATH=/usr/lib")/-d 3 -l SYSLOGD')

Sample procedure:

//DCAS PROC 
//* DEBUGGING AND LOGGING MAY BE REQUIRED TO HELP DETERMINE A PROBLEM 
//* THE DCAS. 
//* 
//* -D OR -D - INDICATES DEBUGGING LEVEL REQUESTED. 
//* FORMAT: -D LEVEL 
//* LEVEL IS: 1=LOG ERROR AND WARNING MESSAGES 
//* 2=LOG ERROR, WARNING, AND INFO 
//* 3=LOG ERROR,WARNING, INFORMATI 
//* 
//*<BR>//DCAS EXECPGM=EZADCDMN,REGION=4096K,TIME=NOLIMIT, 
// PARM='POSIX(ON) ALL31(ON) / -d 3 -l SYSLOGD' 
//* 
//SYDENV DD DUMMY 
//SYSPRINT DD SYSOUT=* 
//SYSIN DD DUMMY 
//SYSERR DD SYSOUT=* 
//SYSOUT DD SYSOUT=* 
//CEEDUMP DD SYSOUT=* 
//*

You will find a sample start procedure in EZADCASP in the SEZAINST dataset.

To start the DCAS server from the z/OS UNIX shell, use the following format:

dcas <parameter_1> <parameter_2> <parameter_3> &

To start the DCAS server from an MVS started procedure, use the following format:

PARM=.../<parameter_1> <parameter_2> <parameter_3>