This chapter explains how to install the Co:Z Toolkit on z/OS. Once the toolkit is installed, individual components can be configured for use. For component configuration details, consult the user's guides (referenced in Chapter 1, Introduction).
For questions, please visit the Dovetailed Technologies Co:Z Forum
Download the Co:Z z/OS self-extracting installer file (download available from dovetail.com).
Upload coz-vv.rr.mm.bin file to the z/OS HFS or zFS file system. Make sure you transfer the file with a binary mode transfer option.
Verify that the cksum command (
cksum coz-vv.rr.mm.bin) results match the checksum values published on the website download page.The installation script requires a small amount of temporary space to run successfully. Ensure that your
/tmpfile system is not full.The installing userid should have READ access to the BPX.FILEATTR.APF SAF resource. If not, Co:Z will install without APF authorization on the
ssh-socket-infoutility, but will otherwise operate properly. See http://dovetail.com/docs/sftp/options.html#ssh_socket_infoMake the installer file executable:
$
chmod +x coz-vv.rr.mm.binRun the installer:
$
./coz-vv.rr.mm.binThis software is licensed under the Co:Z Community License Agreement available for review at http://dovetail.com/docs/coz/licenses.html or as part of this install package in file LICENSE (the "License"). ... Do you agree to the above license terms? [yes or no]yesEnter home directory [/usr/local/coz] :
(Enter)/usr/local/coz is not an existing directory, create it? [y/n] :yEnter new or existing target PDSE load module library name [SYS1.COZ.LOADLIB]:
(Enter)The PDSE load module library 'SYS1.COZ.LOADLIB' does not exist, create it? [y]:y/usr/local/coz/loadmodules/COZBATCH -> //'SYS1.COZ.LOADLIB(COZBATCH)': executable /usr/local/coz/loadmodules/COZLNCH -> //'SYS1.COZ.LOADLIB(COZLNCH)': executable Enter new or existing PDS for Co:Z Sample JCL and PROCs [SYS1.COZ.SAMPJCL]:
(Enter)The PDS 'SYS1.COZ.SAMPJCL' does not exist, create it? [y]:y/usr/local/coz/sampjcl/@@README -> //'SYS1.COZ.SAMPJCL(@@README)': text /usr/local/coz/sampjcl/COZCFGD -> //'SYS1.COZ.SAMPJCL(COZCFGD)': text /usr/local/coz/sampjcl/COZPROC -> //'SYS1.COZ.SAMPJCL(COZPROC)': text ... Enter PATH directory in which to create command symlinks or 'none' [/usr/local/bin]:
(Enter)created symlink /usr/local/bin/catsearch -> /usr/local/coz/bin/catsearch created symlink /usr/local/bin/cozserver -> /usr/local/coz/bin/cozserver created symlink /usr/local/bin/cozsftp -> /usr/local/coz/bin/cozsftp created symlink /usr/local/bin/fromdsn -> /usr/local/coz/bin/fromdsn created symlink /usr/local/bin/pdsdir -> /usr/local/coz/bin/pdsdir created symlink /usr/local/bin/read_passwd_dsn.sh -> /usr/local/coz/bin/read_passwd_dsn.sh created symlink /usr/local/bin/saf-ssh-agent -> /usr/local/coz/bin/saf-ssh-agent created symlink /usr/local/bin/safauth -> /usr/local/coz/bin/safauth created symlink /usr/local/bin/todsn -> /usr/local/coz/bin/todsn created symlink /usr/local/bin/zsym -> /usr/local/coz/bin/zsym FOMF0303I /usr/local/bin/ssh-socket-info: chattr() error: rv=-1, errno=8B, rsn=0924041A
***
Unable to set extended attributes for program bin/ssh-socket-info
- see installation guide for more informantion
***
You should update user profiles so that MANPATH contains: /usr/local/coz/doc/man
*** Co:Z Installation complete ****
(see README and LICENSE in install root directory for more information)
Install and configure IBM Ported Tools for z/OS (SSH) per the IBM documentation.
If possible, configure z/OS ssh to use /dev/random. This can significantly decrease startup times for the z/OS ssh client. See the "Trouble Shooting" chapter in the IBM z/OS Ported Tools manual for more information.
Some of the toolkit components require additional configuration. Details can be found in the individual user's guides. See Chapter 1, Introduction for more information.