1. Introduction

Co:Z Dataset Pipes are commands that provide flexible conversion between z/OS data sets and byte streams. The conversion options include code page translation, line termination treatment, and data set record padding / overflow rules.

There are also commands for converting z/OS Unix System Services POSIX files to byte streams.

The Co:Z Dataset Pipes commands can be used in the following modes:

  • z/OS Unix System Services Integration: A z/OS unix process accesses local z/OS services

    The Dataset Pipes streaming commands can be invoked from Unix System Services directly (interactively, or from a shell script) or used as shell commands within a Co:Z Batch job step.

  • z/OS Hybrid Batch: A z/OS jobstep launches a remote process on a target system

    The Co:Z Launcher starts a shell process on a distributed system, redirecting the shell's input and output to traditional z/OS data sets, z/OS POSIX files, or spool files.

    The Dataset Pipes client commands can be used by the remote process to reach back into the launching jobstep to access z/OS POSIX files, data sets and other services.

    The target may be another z/OS system with Co:Z installed.

  • z/OS Remote Services: A remote client initiates a connection to z/OS

    A Linux, AIX or remote z/OS system can use the Dataset Pipes client commands to initiate an SSH connection to a z/OS server.

    Commands can be run individually (each with its own SSH connection), or through a durable connection initiated by the remote system with the cozcontrol command. When using cozcontrol, a single dataset pipes connection is used for multiple command invocations.

Features:

  • Pipe input to an MVS dataset or a POSIX file (todsn and tofile)

  • Pipe output from an MVS dataset or a POSIX file (fromdsn and fromfile)

  • Remote execution over an SSH connection

  • Supports any z/OS dataset which can be opened in sequential, record mode by the fopen() C-library routine. This includes:

    • MVS sequential datasets (QSAM, BSAM)

    • PDS and PDSE members

    • VSAM files (processed in sequential mode)

    • SYSOUT datasets, including the MVS internal reader

  • Supports text or binary conversion via flexible line-termination rules:

    • Cr, Lf/Newline, CrLf, Cr and/or Lf, RDW, none, user-defined-string

  • Supports flexible record padding / overflow rules:

    • wrap, flow, truncate, error

  • Codepage translation via high-performance z/OS conversion services

  • Can specify additional fopen() options and dynamic allocation keywords

    • keywords supported by BPXWDYN can be used to customize dataset allocation

    • allows for SYSOUT, writers or MVS internal reader

  • User and/or system profile can be used to automatically supply conversion options based dataset name matching.


Saint Charles, Missouri
info@coztoolkit.com
+1 636.300.0901

Copyright© 2009 - 2023 Dovetailed Technologies, LLC. All rights reserved. Co:Z® is a registered trademark and Co:Z Toolkit™ is a trademark of Dovetailed Technologies, LLC.

Saint Charles, Missouri
info@coztoolkit.com
+1 636.300.0901

Copyright© 2009 - 2023 Dovetailed Technologies, LLC. All rights reserved. Co:Z® is a registered trademark and Co:Z Toolkit™ is a trademark of Dovetailed Technologies, LLC.