IBM Rational Developer for System z Unit Test v8.0.3.1 Release Letter

Product Description

Rational® Developer for System z® Unit Test provides System z functionality, with selected emulated I/O devices. This Program is licensed only for development and test of applications that run on IBM® z/OS®. The Program may not be used to run production workloads of any kind, nor more robust development workloads including without limitation production module builds, pre-production testing, stress testing, or performance testing.

The service level Rational Developer for System z Unit Test v8.0.3.1 includes the following:

Service for the System z emulation software at driver level RDZ803_z1091-1-2.41.48.

Rational Developer for System z Unit Test v8.0.3.1 is provided for both Desktop User and Server User editions of the product. However, information on the license server only applies to the Server User edition.

The following documents are references for the offering:

IBM Rational Developer for System z Unit Test: Configuration Guide, SC14-7281-02
System z Personal Development Tool 1090 User's Guide, G229-1101
Redbook - System z Personal Development Tool Volume 1: Introduction and Reference, SG24-7721
Redbook - System z Personal Development Tool Volume 2: Installation and Basic Use, SG24-7722
Redbook - System z Personal Development Tool Volume 3: Additional Topics, SG24-7723

Enhancements and new function in Rational Developer for System z Unit Test v8.0.3.1

z/VM® Data Migration Utility. This version includes a client-server utility for moving 3380, 3390 CKD, 9336 FBA, and tape volumes from a remote z/VM system to Rational Developer for System z Unit Test. Reference the latest version of Redbook, SG247723, IBM System z Personal Development Tool, Volume 3 Additional Topics, chapter 11, DASD volume migration.

Fixes in Rational Developer for System z Unit Test v8.0.3.1

A new utility, SecureUpdate_authority, provides non system administrators the authority to pDeveloper form token updates. These authorized users can administer token updates using the zpdtSecureUpdate command from any directory.
A new utility, clientconfig_authority, provides non system administrators the authority to configure key server and UIM settings. Authorized users configure key server and UIM settings with the clientconfig command.
Fixed the UIMD failure when the system was not configured with a unique node name.
Added token recovery code to minimize false “zPDTA license has expired” messages.
Changed the way zPDT messages were being handled during termination of zPDT.
The output of the token command now provides both zPDT license information and CP serial number information.
Auto-restart of the USB key daemons resolves a problem when rebooting on native Linux openSUSE 12.1, Fedora 15, and Fedora 16.
Added uimserverstart and uimserverstop scripts to simplify UIM Server management.
The z1090instcheck was modified to call uimcheck, a new utility to verify connection to the UIM Server
The use of the Safenet Token Monitor utility (http://localhost:7002) has been enhanced to allow or disallow remote clients to access the token server.
Added an ‘aws’ option as a prefix to any zPDT command to look into /usr/z1090/bin directory only and not through the normal unix search path.
Added localtoken option to awsstart command to use token installed in client.

System Configuration and Prerequisites

The supported levels of Linux used with Rational Developer for System z Unit Test v8.0.3.1 are the 64-bit version of Red Hat Enterprise Linux 5.3 and 64-bit version of openSUSE 11.1, 11.2, or 11.3.

Install Rational Developer for System z Unit Test v8.0.3.1 (RDZ803_z1091-1-2.41.48)

If you are installing the product for the first time, refer to the IBM Rational Developer for System z : Configuration Guide, SC14-7281-02 . Please be sure that you have installed the appropriate version of Linux and the prerequisites before proceeding to install the product code.

Note: Although Rational Developer for System z Unit Test is a 64 bit program, you must have 32 bit runtime support installed for the installation and operation of the program.

If you have already installed the appropriate version of Linux and the required prerequisites outlined in Redbook SG24-7722, and you are upgrading from Rational Developer for System z Unit Test, to install this level, please proceed to the next step.

The Installation Disc of the Rational Developer for System z Unit Test software media pack includes an installation wizard named RDzUT8031-wizard.bin that creates a set of files that you will use to install Developer for System z Unit Test. The wizard displays the offering license and allows you to select a target directory for storing the installation files and documentation. After you run the wizard, accept the license, and select a target directory, the wizard unpacks the installation files and documentation into the target directory and finishes. After the installation files have been created, use a command line to change to the directory containing the installation files and run the install program named RDZ803_z1091-1-2.41.48. This program must be run with superuser authority (root privilege).

When you have finished running the install program, use the instructions for configuring your Linux system files located in the second Redbook volume, System z Personal Development Tool: Installation and Basic Use (SG24-7722). For information on the configuration of license servers, see Appendix D. License and serial number servers of the Configuring z/OS 1.12 with IBM Rational Development and Test Environment for System z Guide , SC14-7281-03 or, Appendix D. License and serial number servers of the Configuring z/OS 1.13 with IBM Rational Development and Test Environment for System z Guide , SC14-7281-04.

If you are installing IBM Rational Developer for System z Unit Test on a system that will not use a license server or you are setting up a license server, be sure to plug the USB hardware key into an available USB 2.0 slot. If you are planning to install the USB hardware key in a USB hub make sure that the hub is externally powered, otherwise, you could damage the USB hardware key. Ensure that the system clock is correct before plugging in the USB hardware key. If this is a brand new USB hardware key that has not been activated yet, you will need to install a license updafile to be able to activate the USB hardware key.

If you need to update or obtain a license update file for the USB hardware key, effective with this release, the utility SecureUpdateUtility must be run as root from the /usr/z1090/bin directory.

After making configuration changes to the Linux system files as described in Redbook SG24-7722, be sure to run the command z1090instcheck to check if conditions of your system are favorable for IBM Rational Developer for System z Unit Test. You should run this command from the userid configured to run the Unit Test application. The location of the program is /usr/z1090/bin/z1090instcheck.

1090 Directory Structure

The following is the directory structure set up by the install process. If the structure is not in place, the awsstart command will create it for you.

/<homeDir>/z1090/logs		various traces are placed here	
/<homeDir>/z1090/configs	IOCDs, IOCP, activation profiles
/<homeDir>/z1090/disks		emulated disk volumes
/<homeDir>/z1090/tapes		emulated tape volumes
/<homeDir>/z1090/cards		input to emulated card reader
/<homeDir>/z1090/list		emulated printer output

(where </homeDir> is what ever the home directory is for the given user).

Known Restrictions and Exceptions

Restrictions.

SNA is not supported.
Multicast IP currently not supported via OSE managed devices. Multicast IP is supported with OSA defined in OSD mode.