Dovetailed Technologies

4. Running the Co:Z Launcher

This chapter explains how to run the Co:Z Launcher, based on the user's configured authentication mechanism. Authentication with the remote system must be set up so as not to require any user interaction. There are three ways to do this with OpenSSH:

  • Use the SSH_ASKPASS environment variable to point to a program that will read a password.

  • Use an OpenSSH public/private keypair.

  • Use a RACF Digital Certificate.

For details on these three authentication options, see Appendix A, Client Authentication Mechanisms. Note that instructions in this appendix must be followed in order to run the examples described below.

4.1 Running with SSH_ASKPASS Authentication

Note: The JCL discussed below is included in the Co:Z toolkit samples as member RUNLNCHP

//USERP JOB (),'DOVETAIL',MSGCLASS=H,NOTIFY=&SYSUID 
//PROCLIB JCLLIB ORDER='USER.COZ.SAMPJCL' 
//* 
//RUNCOZ EXEC PROC=COZPROC,ARGS='-LI user@linux1.myco.com' 
//COZCFG DD * 
ssh-options=-oStrictHostKeyChecking=no 
server-env-PASSWD_DSN=//HLQ.PASSWD(SITE1)  1  
server-env-SSH_ASKPASS=/usr/local/coz/bin/read_passwd_dsn.sh 
server-env-DISPLAY=none 
//STDIN DD * 
uname -a 
env 
//  
1

The member //HLQ.PASSWD(SITE1) contains a single line with the password starting in the first column and without line numbers.

4.2 Running with an OpenSSH keypair

Note: The JCL discussed below is included in the Co:Z toolkit samples as member RUNLNCH

//COZUSERC   JOB (),'DOVETAIL',MSGCLASS=H,NOTIFY=&SYSUID,CLASS=A 
//PROCLIB JCLLIB ORDER='COZUSER.COZ.SAMPJCL' 
//* 
//RUNCOZ EXEC PROC=COZPROC,ARGS='cozuser@linux1.myco.com'
//COZCFG DD *
//STDIN DD *
uname -a
env
//  

4.3 Running with a RACF Digital Certificate

Note: The JCL discussed below is included in the Co:Z toolkit samples as member RUNLNCHK

//COZUSERC   JOB (),'DOVETAIL',MSGCLASS=H,NOTIFY=&SYSUID,CLASS=A 
//PROCLIB JCLLIB ORDER='COZUSER.COZ.SAMPJCL' 
//* 
//RUNCOZ EXEC PROC=COZPROC,ARGS='cozuser@linux1.myco.com'
//COZCFG DD * 
saf-cert=MY-RING 
//STDIN DD * 
uname -a 
//  
Copyright© 2009-2017 Dovetailed Technologies, LLC. All rights reserved.
Co:Z® is a registered trademark of Dovetailed Technologies, LLC.