JCL similar to the sample member SQDAEMON included in the distribution can be used to start the Controller Daemon. The JCL must be edited to conform to the operating environment.
//SQDAEMON JOB 1,MSGLEVEL=(1,1),MSGCLASS=H,NOTIFY=&SYSUID
//*
//*-----------------------------------------------------------------
//* Execute the z/OS SQDAEMON Controller in Batch
//*-----------------------------------------------------------------
//* Parms Must be Entered in lower case
//*
//* --service=port_number
//* Where port_number is the number of a TCP/IP port that will be
//* used to communicate to the Controller Daemon
//* ** Note: If this parm is omitted, here and in the
//* sqdagents.cfg file, the default port will be 2626 **
//*
//* -d zfs_dir
//* Where zfs_dir is the predefined working directory used by
//* the controller
//* EXAMPLE:
//* /home/sqdata/daemon - the controller's working directory
//* and its required cfg and optional logs sub-directories:
//*
//* /home/sqdata/daemon/cfg - must contain 1 file:
//* sqdagents.cfg - contains a list of
//* capture/publisher/engine agents to
//* be controlled by the daemon
//*
//* - and optionally:
//* acl.cfg - used for acl security
//* /home/sqdata/daemon/logs - used to store log files used by the
//* controller daemon
//*
//*********************************************************************
//*
//JOBLIB DD DISP=SHR,DSN=SQDATA.V400.LOADLIB
//*
//SQDAEMON EXEC PGM=SQDAEMON
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//SQDLOG DD SYSOUT=*
//*SQDLOG8 DD DUMMY
//*
//SQDPUBL DD DISP=SHR,DSN=SQDATA.NACL.PUBLIC
//SQDPKEY DD DISP=SHR,DSN=SQDATA.NACL.PRIVATE
//SQDAUTH DD DISP=SHR,DSN=SQDATA.NACL.AUTH.KEYS
//*SQDPARMS DD DISP=SHR,DSN=SQDATA.V400.PARMLIB(SQDAEMON)
//SQDPARMS DD *
--service=2626
--tcp-buffer-size=262144
-d /home/sqdata/daemon
/*
//| JOBLIB | References the Connect CDC SQData load library. |
| STEPLIB | When present refers to the Connect CDC SQData load library and all other required libraries. |
| SQDPUBL | NaCL Public key required when connecting to a Controller Daemon. |
| SQDPKEY | NaCL Private key required when connecting to a Controller Daemon. |
| SQDAUTH | Authorized Key List file containing the Public Keys of Engines and Utilities seeking a connection. |
| SQDLOG | Will contain all diagnostic log messages. |
| SQDLOG8 | Optional, used as a switch to specify Log-level 8 diagnostics, used together with the "X" named diagnostic version of the Component. |
| SQDLOGL | Optional alternative to SQDLOG8 that allows the specification of additional diagnostic parameters specific to the Component. Used together with the "X" named diagnostic version of the Component will produce the most verbose version of the log. |
| SQDFILE | Apply Engine only, refers to the parsed script file that will be used as input to the Engine. |
| SYSPRINT | Will contain the Component run-time report. |
| *Other | Other libraries may be required by specific components including such things as IMS DBD/PSB, RESLIB, SORTLIB, DFSVSAMP specifications, etc. |
Note: This JCL can be simplified by placing all optional parameters in the sqdagents.cfg file described above rather than specifying them in the JCL. The exception to this recommendation is when multiple Controller Daemon's are running on the same machine. In that case --service=port_number must be specified for at least one of the Daemons.