This section 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 coztoolkit.com).
Upload coz-vv.rr.mm.bin file to the z/OS 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 be either UID=0 or have BPX.SUPERUSER authority or have both BPX.FILEATTR.APF and BPX.FILEATTR.PROGCTL authority. These permissions are required in order to enable APF authorization on the
ssh-socket-infoutility and to mark Co:Z SFTP programs as program controlled. If these permissions are not available during installation, the product will still install but may not work properly if SMF recording is enabled. See the Enabling SMF recording section in the Co:Z SFTP User's Guide for additional information.
Make the installer file executable:
chmod +x coz-vv.rr.mm.bin
Run the installer:
./coz-vv.rr.mm.binThis software is licensed under the Co:Z Community License Agreement available for review at https://coztoolkit.com/docs/coz/licenses.html or as part of this install package in file LICENSE (the "License"). Please read the License carefully. The License sets forth the terms on which Dovetailed Technologies, LLC, a U.S. Missouri limited liability company, makes available the Co:Z Co-Processing Toolkit for z/OS at no charge for download, installation and use by the community. THIS COMMUNITY LICENSE DOES NOT PERMIT OUTSOURCERS TO MANAGE, OPERATE, OR SUPPORT THE SOFTWARE. By downloading, installing or using the software, you acknowledge that you have read, understand and agree to be legally bound by 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)
z/OS OpenSSH is a prerequisite for Co:Z. Proper configuration and tuning of z/OS OpenSSH can greatly improve overall performance, specifially for z/OS ssh client startup times. See our IBM z/OS OpenSSH - Quick Install Guide for additional information.
Review the @@README member of the PDS containing Co:Z Sample JCL and PROCS. Review the following component specific members ensuring that they have been correctly tailored for your configuration by the installation process:
Co:Z Launcher and Dataset Pipes: COZPROC and COZCFGD
The RUNLNCH, RUNLNCHK, and RUNLNCHP are basic Co:Z Launcher samples using different authentication methods. Additional examples can be found in the User's Guide.
Co:Z SFTP: SFTPPROC and SFTPIND
While other samples are provided, the SFTPSAMP member contains sample JCL for the perferred method of using the Co:Z SFTP client in batch. These samples use the Co:Z SFTP batch scripts installed in
<COZ_HOME>/samples/sftp_batch. See Using the Co:Z SFTP client in batch in the User's Guide for additional information.
For additional configuration and usage information, refer to the indiviual component User's Guides:
These steps are required only if you wish to use POSIX as a Target system for the Co:Z Launcher or the Dataset Pipes commands remotely. You do not need to install Co:Z on a remote system in order to use Co:Z SFTP.
Most Linux and Unix distributions include OpenSSH. Follow the instructions for your operating system for installing and configuring the OpenSSH server (sshd) on your system.
Test logging into
ssh <userid>@localhostThe authenticity of host 'localhost (127.0.0.1)' can't be established. RSA key fingerprint is cc:7c:3d:b5:3e:43:5a:6f:12:e2:1a:af:80:45:ae:fa. Are you sure you want to continue connecting (yes/no)?
yesWarning: Permanently added 'localhost' (RSA) to the list of known hosts. <userid>@localhost's password:
logoutConnection to localhost closed.
Test Linux ssh from z/OS:
Repeat the above test from your z/OS userid to confirm that there are no firewall issues.
ssh -p <port> <userid>@linux_host
Note: These sources have been tested on a variety of POSIX systems, but we offer no guarantees for your particular system. If you have difficulty building, please feel free to contact us regarding our testing and certification schedule.
Transfer (in binary) the Co:Z Target System Toolkit source tarball
coz-toolkit-v.r.m.tar.gzfrom the website downloads page to your target system.
Extract the source:
tar -xzvf ../coz.v.r.m-src.tar.gz
AIX Note: If you wish to build with xlC, you will need to
export CXXFLAGS=-qarch=pwr5prior to the following steps.
Note: root access will be required to install at the default location, which is
Note: the installation directory must be in the default
PATH used when logging into
sshd. On some some distros, you may need to
/etc/profile to add these binaries to
this FAQ entry).