Dovetailed Technologies

Appendix E. References

E.1 z/OS OpenSSH

Using remote todsn and fromdsn clients requires that z/OS OpenSSH or IBM Ported Tools OpenSSH be available and configured on z/OS. z/OS V2R2 includes OpenSSH. Earlier versions of z/OS require IBM Ported Tools OpenSSH v1.2 (or later) to be installed. See the version of our Quick Install Guides matching your z/OS OpenSSH version for additional information.

E.2 Using the z/OS Unix Shell

The Dataset Pipes todsn and fromdsn commands may be used from any of the following z/OS Unix shell environments:

  • The TSO "OMVS" command

  • The BPXBATCH utility, running under MVS batch or TSO

    Note:The BPXBATCH enhancement OA11699 significantly improves its usability.

  • The z/OS Unix Shell under a telnet or ssh console.

For more information on z/OS Unix, see:

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

The Dataset Pipes utilties open MVS datasets in "record mode" using the z/OS C library fopen() routine. For example:

fopen( name, mode);



either "//'fully.qualified.dsn'" or "//dd:ddname" depending on whether BPXWDYN allocation keywords were used (Section E.4, “The z/OS BPXWDYN dynamic allocation service”).

  • "rb,type=record,noseek" - if reading (fromdsn)

  • "wb,type=record,noseek" - if writing (todsn)

  • "ab,type=record,noseek" - if appending (todsn -a)

Additional open mode options may be specifed by using the -o option.

The Dataset Pipes utilites read and write records using the z/OS C library fread() and fwrite() routines. For more information on the capabilities of record-mode dataset processing with the z/OS C library, see:

E.4 The z/OS BPXWDYN dynamic allocation service

The Dataset Pipes utilities allow for flexible allocation of MVS Datasets through use of the BPXWDYN text-based allocation service. If you specify allocation keywords, either with the -x option, or by using the allocKeywords option, then a new system-assigned DDNAME will be allocated with BPXWDYN and that DDNAME will be opened with Section E.3, “The z/OS C library fopen() routine”fopen().

You may use any allocation keywords defined by BPXWDYN, except the following:

  • DA(), DSN(), FI(), DD(), MSG(), or REUSE() (automatically supplied)


  • RTDDN, RTDSN, RTVOL (only works if called from REXX)


For more information on using BPXWDYN allocation keywords, see:

E.5 The z/OS Unicode Translation Services

The Dataset Pipes utilities rely on the z/OS Unicode Conversion Service when possible, for codepage/character set translation.

This subsystem provides hardware-assisted high-performance codepage conversions services. This is the same service used by later versions of z/OS DB2, so many shops already have it configured in their environments. For z/OS 1.6 and later, the service is configured by default, with a starter set of codepage (CCSID) mappings.

For more information on configuring and customizing this subsystem:

When Unicode Conversion Services are not available, Dataset Pipes falls back to iconv for codepage translation

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