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. Configuring the dspipes subsystem (Optional)

2.2. Windows Target System Installation

Install Cygwin and OpenSSH on Windows

Configure and test sshd

Install Co:Z target executables

2.3. Unix/Linux/Posix Target System Installation

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. 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 Cookbook

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

fromdsn — write the contents of a z/OS dataset to stdout

todsn — read a stream of data from stdin and write records to a z/OS dataset

dsn_profile — profile information for dataset-name patterns

lookupccsid — Co:Z utility to return the coded character set identifier (CCSID) associated with a character set

saf-ssh-agent — Co:Z utility to enable ssh client authetication via SAF/RACF Digital Certificates

safauth — Co:Z utility to check the current user's authorization to a SAF (RACF) resource.

showtrtab — Co:Z utility to display a translation table

catsearch — Co:Z utility to list z/OS catalogs

pdsdir — Co:Z utility to list Partitioned dataset members and their statistics, if available.

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

C. Setting up a test OpenSSH system on z/OS

D. Compiling the Co:Z target system sources

E. License

F. References

F.1. IBM Ported Tools for z/OS (SSH)

F.2. Using the z/OS Unix Shell

F.3. The z/OS C library fopen() routine

F.4. The z/OS BPXWDYN dynamic allocation service

F.5. The z/OS Unicode Translation Services