Dovetailed Technologies Solutions Support Contact Us

Revision History

Co:Z Toolkit 2.0.1 - January 14, 2012

This release makes the following minor changes to the 2.0.0 (Beta) release, and is no longer considered "Beta".

  • Fixed a problem in Co:Z SFTP JES support - jobs submitted to //-JES.INTRDR may now be listed after they are submitted.

  • Corrected an issue in Co:Z SFTP where writing to a z/OS dataset using a source file with a line longer than 128K would fail with an error "InputBuffer will not hold xxxxx bytes of new data".

  • Enhanced the sample sftp_batch scripts to support SAF keyrings with private keys stored in hardware. See the comments in sample/scripts/sftp_batch/sftp_connect.sh for more information.

Co:Z Toolkit 2.0.0 (Beta) - December 1, 2011

Note: We recommend that you use this release if you are evaluating or testing Co:Z outside of a production environment. We expect to provide production support for this release level within 60 days. If you are a commercial customer and have specific support requirements, please contact us. This release makes the following enhancements and fixes:

  • Extended Access Volume (EAV) support has been added to Co:Z SFTP.

  • Enhanced the Co:Z SFTP client and server to write log message records (INFO level and above) to SMF 119, using new subtypes 192 (client) and 193 (server).

  • Added a utility program ssh-socket-info which is invoked by the Co:Z SFTP client to get more accurate socket information for SMF records. This program uses the IBM EZBNMIFR network management API, which requires the ssh-socket-info program to be APF authorized. The Co:Z installer will attempt to set the "+a" extattr bit on this program, but will only succeed if the installing userid has READ access to the BPX.FILEATTR.APF SAF resource. If for some reason, this program is not APF authorized, Co:Z SFTP will operate properly, but the SMF socket information is not guaranteed to be accurate.

  • Support for hex pad characters has been added to Co:Z SFTP.

  • Changed the catsearch utility to automatically show user catalog entries. Added an option (-e) to allow for a custom selection of entry types.

Co:Z Toolkit 1.10.1 - November 7, 2011

This release makes the following enhancements and fixes:

  • The Co:Z Launcher now makes the SYSIN DD available for application use.

  • Added several sample shell scripts and JCL to simplify the use of cozsftp in batch jobs. See the $COZHOME/sample/scripts/sftp_batch and the new SFTPPROC, SFTPIND, and SFTPSAMP JCL members in the installation's SAMPJCL PDS.

  • Changed the Co:Z SFTP server to provide FTP style confidence indicator in the CZPOSTPR exit.

  • Fixed a problem in the cozsftp shell script where command line arguments were not being transparently passed to the Co:Z SFTP client. This problem could affect the use of the -oIdentityKeyRingLabel option, which requires quoting. This bug was introduced in release 1.9.0. Contact us if you would like a local fix for releases 1.9.0 through 1.10.0.

  • Fixed a problem where BPXWDYN dataset options were not being properly overridden when associated with a file pattern.

  • Fixed a problem in dataset code where a read error might not be detected.

  • The LOGNAME feature introduced in the previous release was not working properly. This has been fixed.

Co:Z Toolkit 1.10.0 - September 15, 2011

This release makes the following enhancements and fixes:

  • Added a feature to Co:Z SFTP that allows file transfer settings to be associated with POSIX filename and z/OS Dataset patterns. See the updated Co:Z SFTP documentation for details

  • Added the technique option to Co:Z SFTP. This option is used to specify the Unicode System Services Technique used when translating between the client and server codepages

  • Co:Z Batch now automatically sets the LOGNAME environment variable to the current z/OS userid. This is in addition to the existing behavior of setting the HOME environment variable to the current user's home directory.

  • Co:Z Launcher now automatically sets the LOGNAME and HOME environment variables.

  • The pdsdir command has been enhanced (via the -n option) to display only member names.

  • Fixed a problem with dataset pipes handling of hex character line terminators (0xnnnn).

  • Fixed a problem with cozsftp where a non latin locale caused the client to not work properly.

  • Added the sample program CoZSmfServer which demonstrates how SMF records may be received in real time from Co:Z client and server. See the documentation and build instructions in $COZ_HOME/samples/smfapi/CoZSmfServer.C

Co:Z Target System Toolkit 1.0.14 - June 7, 2011

Enhanced Co:Z Agent to track the parent sshd process and detect if it has terminated abnormally (e.g. due to the Job Step being cancelled by the operator). If this condition is detected, the Co:Z Agent will terminate its process group, which will prevent orphaned processes from continuing to run on the target system.

Co:Z Toolkit 1.9.0 - May 16, 2011

This release makes the following enhancements and fixes:

  • Co:Z SFTP now returns the "last referred date" (midnight) from the VTOC for datasets as last changed time. While not accurate, this is a reasonable substitute and better than the base UNIX epoch date of 1969-12-31

  • The cozsftp command is now a shell script. The executable has been renamed to cozsftp_cmd. This should be a transparent change to existing jobs. However, it adds a new capability to allow customization of the cozsftp command line arguments. See cozsftp_client.rc for more information.

  • Fixed a problem with long (>256) character unix file paths in Co:Z SFTP

  • Cleaned up formatting of long dataset name listings in Co:Z SFTP

  • Fixed a problem where disp=mod was incorrectly being added to bpxwdyn allocations of new datatsets in Co:Z SFTP

  • Fixed a problem with the -p option on the get subcommand of cozsftp.

  • Added subcommands ascii and binary to cozsftp. These operate as synonyms to the option settings lzopts mode=text and lzopts mode=binary respectively.

  • Added a new option -N to COZBATCH to respect digits in columns 73-80 in STDIN rather than stripping them out, which is the default behavior.

Co:Z Toolkit 1.8.0 - February 3, 2011

This release makes the following enhancements and fixes:

  • A new Co:Z SFTP client option ssh-le-options can be used to set LE options for IBM Ported Tools OpenSSH. This option can be set in /etc/ssh/cozsftp_config to simplify the process of implementing IBM APAR OA34819.

  • The ssh-le-options settings in the sample configuration files for both Co:Z Launcher and the Co:Z SFTP client were updated to reflect IBM APAR OA34819.

  • A new configuration opton properties-exit was added to the Co:Z Launcher which allows properties to be dynamically provided by a user-supplied exit program or script.T

  • Fixed a bug in Co:Z SFTP that can cause an 0C4 when querying JES spool jobs using a jobname or owner longer than 8 characters.

  • Fixed a bug in Co:Z SFTP that caused the "mode=text" setting to be treated as binary if "mode=TEXT" was given.

Co:Z Toolkit 1.7.8 - January 17, 2011

This release fixes a potential OC4 exception when the 'noreplace' option is used.

Co:Z Toolkit 1.7.7 - January 14, 2011

This release fixes several problems:

  • In Co:Z SFTP, listing dataset levels that contain GDGs may cause a loop/hang condition.

  • An 0C4 exception can occur in Co:Z SFTP if there is an open error on a z/OS dataset.

  • In Co:Z SFTP, a z/OS-formatted dataset listing displays January "Last Referred" dates with a day that is one less than the actual LastReferred date.

  • A debug-level log message was added to Co:Z SFTP client and server to print out the requested and actual REGION size.

Co:Z Toolkit 1.7.5 - December 13, 2010

In addition to the changes made in the 1.7.4 beta release, the following enhancements and minor fixes are included in this production release:

  • A memory leak was fixed in Co:Z SFTP that caused out-of-memory errors if many Unix files were transferred using a small REGION size.

  • A fix to Co:Z SFTP job submission which sometimes prevented the display of job handles if multiple jobs were submitted in the same session.

  • The read_passwd_dsn_sh script was changed to allocate the dataset with DISP=SHR.

  • The lsjes z/OS Unix command was added to Dataset Pipes to support listing the status of jobs and spool files. Thanks to John McKown for the utility name and the idea of offering this feature as a standalone utility.

  • The Dataset Pipes fromdsn command was enhanced to support reading JES spool files.

  • The Co:Z safauth has been enhanced to add DSA key support.

  • Some of the JCL members in the SAMPJCL PDS have been renamed for clarity. See the @@README member for details.

Co:Z Target System Toolkit 1.0.11 - December 13,2010

Production version of the previous (beta) 1.0.9 release. This version has a minor change to the target program child I/O process wait / cleanup.

Co:Z Target System Toolkit 1.0.9 - September 30,2010 (Beta Release)

Note: This release of the Co:Z Target System Toolkit should only be used with version 1.7.4 or later of the z/OS Co:Z Launcher. Previous versions are still compatible with Co:Z Launcher 1.7.4.

  • CoZAgent changed to emit a "Waiting for completion..." message every five minutes. This may be helpful to keep the ssh session alive in some environments where the connection may otherwise timeout.

  • CoZAgent changed to detect cleanup errors with the stdin/stdout/stderr handlers and to exit with RC=103 if one of these child processes did not complete successfully.

  • CoZClient and the fromdsn/todsn clients changed to support a new environment variable: COZ_SSH_OPTS. This environment variable can be set in a client-initiated ssh connection to set user@host and any other ssh option defaults. This variable should not be set when running under the Co:Z Launcher.

Co:Z Toolkit 1.7.4 - September 28, 2010 (Beta Release)
  • Co:Z SFTP - significant enhancements to JES support:

    • Support for submitting jobs to internal reader A handle/name can be used to refer to submitted jobs. New settings jesrecfm and jeslrecl can be used to control format of internal reader dataset.

    • A new setting jesjobwait allows for waiting for job completion before listing or downloading spool files.

    • Support for downloading concatenated spool files for a job.

    • Selection of spool files by either dsid or [step.[procstep.]]ddname.

    • New setting jesstatus can be used to filter job listing by status.

    • sftp-server.sh changed to remove empty log files on completion.

    • Fixed bug where fixed options could be overridden.

  • Co:Z Launcher

    • Added ssh-le-options to property to allow setting of RUNOPTS for ssh child process. Set the default in COZCFGD so to set the initial HEAP size for Ported Tools OpenSSH to avoid storage allocation problem.

    • Fixed a timing bug that sometimes results in not cleaning up child processes. Before this fix, target fromdsn/todsn commands occasionally do not get cleaned up properly.

  • Enhanced to safauth command to allow volser option.

  • Fixed bug in genlines command in processing -l rdw option.

1.7.2 - July 23, 2010
  • Made the Co:Z toolkit compatible with IBM Ported Tools for z/OS version 1.2. Specifically, components in the toolkit that spawn the ssh client have been changed to spawn with a default setting of _BPX_SHAREAS=YES (the old default value was MUST). This accomodates IBM's change to ssh that requires it to run in a separate address space.

  • Added create-symlinks.sh script in the Co:Z install directory. This script can be used to add or replace the symbolic links to the commonly used Co:Z executables.

1.7.1 - <not released - items below are included in all subsequent releases>
  • Added new option (no)replace.

  • Changed the way the sftp-server log filenames are calculated to eliminate a potential race condition on the name.

1.7.0 - June 8, 2010
  • Added support for new /etc/ssh/cozsftp_config and /etc/ssh/cozsftp_server_config site configuration files.

  • Fixed a problem traversing from /+ to its parent (root).

  • Enhanced sftp-server.sh to write a message to the console if the log file or /tmp is full.

  • Sample configuration and .rc files are now packaged in a samples directory.

  • Changed product to use a more corporate-friendly free Community License and made Co:Z FTP-SSH Proxy an add-on component. See the licensing FAQ for more information.

1.6.1 - April 16, 2010
  • Fixed a problem in Co:Z SFTP server where certain options set via the SFTP_ZOS_OPTIONS environment variable can cause a loop.

  • Fixed a problem in Co:Z SFTP client and server where SMF records were not being cut for transfers to SYSOUT datasets.

1.6.0 - March 30, 2010
  • Fixed a problem in the Co:Z SFTP where dataset write errors might not be reported correctly.

  • Fixed a problem in the Co:Z SFTP server where no error was being reported if too many catalog search entries were being read during a client listing request. The client will now report a directory read error and the error log will contain a message.

  • Fixed a problem in the Co:Z SFTP server which can prevent uploading to a SYSOUT dataset.

  • Fixed saf-ssh-agent so that it reports the exit code of the command run under the -c option. Also fixed a potential race condition where the agent might not start in time for the ssh client to use it.

  • Changed cozsftp and CozClient to retry fork() when receiving EAGAIN on z/OS. This is in response to IBM USS DOC APAR OA30943 (Problem #1).

  • Added a new z/OS shell command "safauth" which can be used to check the current user's authorization for a SAF resource.

1.5.3 - January 19, 2010
  • Enhanced saf-ssh-agent with a new option (-c) that accepts a command (such as ssh) to run as a child process so that it can authenticate via SAF RACDCERT digital certificates.

  • Enhanced Co:Z SFTP to provide an interface to z/OS JES job status and spool files. Future releases of Co:Z will also support enhanced job submit, cancel, and purge facilities

1.5.2 - December 8, 2009
  • Minor fix to Co:Z SFTP for the space=blk setting. This will cause the BPXWDYN keyword block(n) to be used, where n is either the value on the blksize keyword or 0 if the blksize keyword is not set.

1.5.1 - December 2, 2009
  • Minor fix to Co:Z SFTP FTP-compatible user exit support so that check-command exits are properly called when setting the unit and ucount options.

1.5.0 - November 2009
  • Support added to enable the use of RACF RSA Digital Certificates for OpenSSH client authentication. This feature can be exploited by both the Co:Z Launcher and the z/OS SFTP client (cozsftp).

  • Co:Z Launcher MVS console communication has been enhanced to automatically fold input to lower case. The underscore ('_') escape character can be used to force the character that follows to upper case.

  • The todsn command -x option has been enhanced to allow the BPXWDYN DD or FI keyword to allow the use to specify a specific DD name to dynamically allocate rather than using a default system-assigned DD name.

  • Fixed a problem in cozsftp with large buffers (-B option) that was causing hangs and or poor throughput.

  • Fixed a problem in Co:Z SFTP so that when processing HFS/zFS files, ASCII linefeed characters (x'0a) are properly substituted for ASCII NEL characters (x'85'). This problem had affected some users who requested linerule=crlf with codepages that by default converted EBCDIC linefeed to ASCII NEL (x'85').

1.4.1 - October 2009

This release includes the following changes to Co:Z SFTP from the prior GA release:

  • Support for IBM FTP compatible user exits.

  • minor bug fixes to several fields in SMF 119 records that were not produced the same as IBM FTP.

  • the CONDDISP=DELETE option will now delete MVS datasets or HFS/zFS files that are being written to by either the SFTP client or server in the case of an incomplete or interrupted file exchange.

  • Corrected MVS dataset name handling with repect to "./" and "../" appearing in file names.

  • Corrected an 0C7 that occurred when processing PDS directories with old SPF format statistics

1.3.2 - July 2009
  • Reworked Target System Toolkit to build on more *nix platforms, including FreeBSD.

  • Added a new dataset prefix //!xxx.yyy which forces the dataset xxx.yyy to be treated as a dataset rather than a "directory" even if datasets xxx.yyy.zzz exist.

  • Fixed dataset estimated size calculation so as to avoid under estimating, which could cause performance problems with some SFTP clients.

  • The file permissions for non-resident datasets were being reported as 000. This has been fixed so that these datasets have a mode of 0666.

1.3.0 - June 2009
  • Co:Z SFTP has been enhanced to allow for an initial directory (or dataset qualifier) to be configured.

  • SMF 119 records with failure codes are written when cozsftp or sftp-server terminates unexpectedly during file transfer.

  • The software license has been simplified. The Co:Z components available in source form are now distributed under a more permissive license (no longer GPL).

  • In some cases, dataset estimated size was not being properly estimated. This has been corrected.

  • The allowmount keyword has been renamed mount to be consistent with current BPXWDYN implementations.

1.2.5 - April 2009
  • Co:Z SFTP has been enhanced to allow for the recall of migrated datasets.

  • DTLSPAWN has been improved and renamed COZBATCH.

1.2.4 - March 2009
  • The Co:Z Launcher can now launch process on not only Windows, *nix, etc, but also another z/OS machine. The target z/OS must also have the z/OS toolkit installed. A new "-local" option is available on the z/OS fromdsn and todsn commands that allows a remotely launches z/OS process to use local dataset I/O.

  • Co:Z SFTP has been corrected to allow group and generic unit names on the BPXWDYN "unit=" setting.

1.2.1 - January 2009

This release has some minor fixes to Co:Z SFTP.

  • Navigating alias dataset levels as a "directory" now works better.

  • SMF recording can be completely disabled by setting the "nosmf" option in the SFTP_ZOS_OPTIONS environment variable.

  • fixed a problem with date formatting in long directory listings while using certain locales.

1.2.0 - December 2008
  • Co:Z SFTP added to the Co:Z Toolkit.

  • A Beta release of Co:Z FTP-SSH Proxy has been added.

1.0.8 - June 2008
  • Changed todsn command so that binary or unterminated source lines properly flow to fill up output records to their maximum size. Previously, short records could result on 128kb boundaries when the output records were variable length.

  • Change the todsn command so that the fopen() option "recfm=*" is added if recfm is not specified. This causes the DCB parameters on existing output datasets to be used if not explicitly overridden.

1.0.7 - May 2008
  • Changed CoZLauncher to terminate app when STOP command received.

  • Changed todsn and fromdsn to honor switches that override -b.

  • Changed CoZLauncher and DTLSPAWN to report region size with DEBUG level logging.

  • Added the ssh-shareas property to allow the ssh client to be spawned in a separate address space if desired.

1.0.6 - March 2008
  • Added the server environment variable COZ_FORCE_ICONV to force the use of iconv for translation, even if Unicode System Services is available.

  • Increased performance of single byte character set translations.

1.0.5 - February 2008

Changed the -b option on fromdsn/todsn to disable all translation, even if a source or target codepage was specified.

1.0.0 - December 2007

Co:Z Toolkit initial release

Copyright 2009 Dovetailed Technologies, LLC. All rights reserved.