Dovetailed Technologies

Table of Contents

1. Introduction
1.1. Co:Z Dataset Pipes Features
1.2. Co:Z Launcher Features
2. Co:Z Launcher Installation
2.1. Co:Z Launcher environment requirements
2.2. Configuring the dspipes subsystem (Optional)
2.3. Unix/Linux/POSIX Target System Installation
Configure and test sshd
Install Co:Z target executables
2.4. Windows Target System Installation
Install Cygwin and OpenSSH on Windows
Configure and test sshd
Install Co:Z target executables
3. Co:Z Launcher Configuration
3.1. Co:Z Launcher Properties
Required Properties
Optional Properties
3.2. Configuration Best Practices
When tunneling
When not tunneling
3.3. Console communication
Commands directed to the CoZAgent process
4. Running the Co:Z Launcher
4.1. Running with SSH_ASKPASS Authentication
4.2. Running with an OpenSSH keypair
4.3. Running with a RACF Digital Certificate
5. Co:Z Launcher Examples
5.1. Execute commands on a target server
5.2. Launch remote shell that reads a PDS member
5.3. Offload PGP encryption of MVS Datasets
5.4. Use a Linux server as a secure gateway to information on the Internet
5.5. Offload processing of SMF data to a Linux system
6. Running Dataset Pipes
6.1. Running Dataset Pipes with the openssh client
6.2. Running Dataset Pipes with the PuTTY ssh client
7. Dataset Pipes Examples
7.1. Copy an HFS or zFS file to an MVS dataset
7.2. Copy to an MVS dataset, overriding target DCB attributes
7.3. Copy to an MVS dataset, truncating long lines
7.4. Copy to a PDS member
7.5. Specifying dataset names
7.6. Copying user input to the end of an exiting dataset
7.7. Copy an MVS dataset (PDS member) to an HFS file
7.8. Copy an MVS dataset using DISP=SHR
7.9. Copy one MVS dataset to another
7.10. Copy one MVS dataset to another using the same attributes
7.11. Copy one MVS non-text dataset to another
7.12. Copy an ASCII HFS file to an EBCDIC MVS dataset
7.13. Copy an MVS dataset from one z/OS system to another over an SSH connection
7.14. From a workstation, download a MVS dataset over an SSH connection
7.15. From a workstation, upload an MVS dataset (PDS member) over an SSH connection
8. Problem Determination
8.1. Co:Z Toolkit Component Overview
8.2. Common Logging/Tracing Options
8.3. Enabling Component Logging
Set the default logging threshold for the batch launcher job
Set the default logging threshold for the target system components
Enabling ssh diagnostic messages
9. Frequently Asked Questions
A. Command Reference
catsearch — Co:Z utility to list z/OS catalogs
cozclient — run a zos command from a remote system via ssh
dsn_profile — profile information for dataset-name patterns
fromdsn — write the contents of a z/OS dataset to stdout
fromfile — write the contents of a z/OS POSIX file to stdout
jessym — Command line interface to the JES Symbol Service
lookupccsid — Co:Z utility to return the coded character set identifier (CCSID) associated with a character set
lsjes — Co:Z utility to display JES job and spool file status
pdsdir — Co:Z utility to list Partitioned dataset members and their statistics, if available.
safauth — Co:Z utility to check the current user's authorization to a SAF (RACF) resource.
saf-ssh-agent — Co:Z utility to enable ssh client authetication via SAF/RACF Digital Certificates
showtrtab — Co:Z utility to display a translation table
toasa — read a stream of data from stdin converting ASCII form-feed characters to ASA carriage control characters in stdout
todsn — read a stream of data from stdin and write records to a z/OS dataset
tofile — read a stream of data from stdin and write to a z/OS POSIX file
wto — Co:Z utility to issue a Write To Operator (WTO) from USS.
zsym — Co:Z utility to list system symbol values.
B. Client Authentication Mechanisms
B.1. Interactive password authentication
B.2. OpenSSH keypair authentication
B.3. OpenSSH SSH_ASKPASS authentication
B.4. RACF Digital Certificate authentication
Renewing RACF self-signed certificates
C. Co:Z Environment Variables
D. Setting up a test OpenSSH system on z/OS
E. Compiling the Co:Z target system sources
F. Windows Desktop Target System Installation
F.1. Install Cygwin and OpenSSH on Windows
F.2. Configure and test sshd
F.3. Install Co:Z target executables
G. License
H. References
H.1. z/OS OpenSSH
H.2. Using the z/OS Unix Shell
H.3. The z/OS C library fopen() routine
H.4. The z/OS BPXWDYN dynamic allocation service
H.5. The z/OS Unicode Translation Services
Copyright© 2009-2017 Dovetailed Technologies, LLC. All rights reserved.
Co:Z® is a registered trademark of Dovetailed Technologies, LLC.