Co:Z Toolkit User's Guide

Table of Contents

1. Introduction

1.1. Co:Z Launcher Features

1.2. Dataset Pipes Features

1.3. Packaging

1.4. Supported Environments

z/OS Host Requirements

Windows target server requirements

Unix/Linux/Posix target server requirements

2. Installation

2.1. Installation Overview

2.2. z/OS Installation

2.3. z/OS Customization

2.4. Windows Target System Installation

Install Cygwin and OpenSSH on Windows

Configure and test sshd

Install Co:Z target executables

2.5. Unix/Linux/Posix Target System Installation

Configure and test sshd

Install Co:Z target executables

3. Configuration

3.1. CoZLauncher configuration

Required properties

Optional properties

3.2. Console communication

Commands directed to the CoZAgent process

4. Co:Z Cookbook

4.1. Execute commands on a target server

4.2. Launch remote shell that reads a PDS member

4.3. Offload PGP encryption of MVS Datasets

4.4. Use a Linux server as a secure gateway to information on the Internet

4.5. Offload processing of SMF data to a Linux system

5. Running Dataset Pipes

5.1. Running Dataset Pipes with the openssh client

5.2. Running Dataset Pipes with the PuTTY ssh client

6. Dataset Pipes Examples

6.1. Copy an HFS or zFS file to an MVS dataset

6.2. Copy to an MVS dataset, overriding target DCB attributes

6.3. Copy to an MVS dataset, truncating long lines

6.4. Copy to a PDS member

6.5. Specifying dataset names

6.6. Copying user input to the end of an exiting dataset

6.7. Copy an MVS dataset (PDS member) to an HFS file

6.8. Copy an MVS dataset using DISP=SHR

6.9. Copy one MVS dataset to another

6.10. Copy one MVS dataset to another using the same attributes

6.11. Copy one MVS non-text dataset to another

6.12. Copy an ASCII HFS file to an EBCDIC MVS dataset

6.13. Copy an MVS dataset from one z/OS system to another over an SSH connection

6.14. From a workstation, download a MVS dataset over an SSH connection

6.15. From a workstation, upload an MVS dataset (PDS member) over an SSH connection

7. Problem Determination

7.1. Co:Z Toolkit Component Overview

7.2. Common Logging/Tracing Options

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

8. Frequently Asked Questions

A. Dataset Pipes 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 — return the coded character set identifier (CCSID) associated with a character set

showtrtab — simple utility to display a translation table

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

C. Compiling the Co:Z target system sources

D. Licenses

D.1. Co:Z Toolkit: z/OS

D.2. Co:Z Toolkit for target systems

E. References

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

E.2. Using the z/OS Unix Shell

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

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

E.5. The z/OS Unicode Translation Services