In order to use the Co:Z Launcher to enable z/OS batch jobs to remotely launch a process on a distributed system, installation is required for the Co:Z Toolkit for z/OS. Additionally, the Co:Z Target System Toolkit must be installed on the remote systems that you have identified.
z/OS requirements
Co:Z Toolkit for z/OS
Batch job userid allowed to listen on local port; OMVS segment required
Target System requirements:
Co:Z Target System Toolkit
OpenSSH sshd
sshd_config
AllowTcpForwarding=yesfor target userid
After completing the installation of the Co:Z Toolkit for z/OS and the Co:Z Target System Toolkit on the remote system, the following are the minimum steps to get started using Co:Z Launcher. For more detailed information, see the remaining chapters in this guide.
On z/OS:
Edit
//COZUSER.COZ.SAMPJCL(COZCFGD), updating theserver-pathvariable with your installation directory.Edit
//COZUSER.COZ.SAMPJCL(COZPROC), updating theLIBRARYandCOZCFGDarguments with your installation datasets.Verify that
/etc/ssh/sshd_confighasAllowTcpForwarding=yes. If not set, update the sshd configuration. Restart SSHD with the following:kill -HUP $(cat /var/run/sshd.pid)
Test that the z/OS user running Co:Z Launcher jobs can SSH to the target system without an interactive password.
ssh user@linux1.myco.com
See OpenSSH keypair authentication for additional information, if needed.
Create and test JCL similar to the example provided here: Running with an OpenSSH keypair. This JCL is also included in
//COZUSER.COZ.SAMPJCL(RUNLNCH).Once this test job runs successfully, experiment by trying Co:Z Launcher Examples. See General Dataset Pipes Examples for some Dataset Pipes commands to add to your JCL.
