1. Introduction

IBM z/OS OpenSSH include a port of the OpenSSH tools. These tools provide for secure remote login and program execution (ssh) and file transfer (sftp and scp). The sftp and sftp-server commands implement a file transfer program that is similar to ftp, but use ssh for their underlying secure transport. The sftp specification [1] accounts only for binary transfers. The IBM z/OS sftp client has been enhanced to support ASCII-EBCDIC conversion. Dataset support is not provided.

The Co:Z Co-Processing Toolkit for z/OS includes Co:Z SFTP - a port of the OpenSSH (v8.4p1) sftp-server subsystem and sftp command (renamed as cozsftp). Extensive enhancements have been made to support z/OS facilities such as z/OS datasets and spool files. IBM z/OS OpenSSH is required because Co:Z does not provide the base ssh and sshd components.

1.1 Features

  • Co:Z is compatible with most existing sftp products (see the section called “Remote Client Requirements”).

  • Transfers datasets via the get and put commands

  • Navigates z/OS catalogs via the cd command.

  • Lists dataset information and PDS directories via the ls command.

  • Records SMF 119 records if user has BPX.SMF SAF authorization.

  • Supports IBM FTP compatible user exits. A guide to setting up and using these exits can be found here: http://coztoolkit.com/docs/sftp/coz_sftp_exits.pdf.

  • Supports direct access to datasets which can be opened in sequential, record mode by the fopen() C-library routine. This includes:

    • MVS sequential datasets (QSAM, BSAM, VSAM)

    • PDS and PDSE members

    • SYSOUT datasets, including the MVS internal reader

  • Supports JES2 and JES3 job submission, status and spool file transfer on z/OS 1.9 or later. Future releases of Co:Z SFTP will also support cancel and purge facilities.

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

    • Cr, Lf/Newline, CrLf, Cr and/or Lf, RDW, none

  • Supports flexible record padding / overflow rules

  • Supports dataset dynamic allocation (BPXWDYN) keywords

  • Supports name patterns to automatically associate file transfer options to POSIX files and datasets

1.2 Supported Environments

z/OS Requirements

[Note]Note
Running Co:Z SFTP with z/OS userids that have superuser authority or UID=0 OMVS segments is not recommended.

Remote Client Requirements

  • Co:Z SFTP is compatible with a wide variety of operating systems, including Windows, *IX variants, z/OS...

  • Products supporting the SSH File Transfer Protocol, such as:

    • OpenSSH

    • puTTy psftp

    • winSCP

    • gFTP

    • Many commercial implementations.

    Note: Not all products support all of the Co:Z SFTP extensions. Refer to Client Compatibility for additional information.


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.