MKS Toolkit Release Notes
Version 7.5

MKS Software Inc.
12701 Fair Lakes Circle, Suite 350
Fairfax VA 22033-3831 USA
Support: +1-703-803-7660
+1-703-803-3343
http://www.mkssoftware.com

January 2001

Contents

MKS Toolkit 7.5
Known Issues
Hardware and Software Requirements
Installing MKS Toolkit
Uninstalling MKS Toolkit
Customer Support
Additional MKS Toolkit Resources
Problems Fixed

MKS Toolkit 7.5

MKS Toolkit 7.5 is the latest version of the MKS Toolkit product family. New features in MKS Toolkit 7.5 include:

• Windows Millennium Support. Microsoft Windows Millennium support has been added for the MKS Toolkit utilities, runtime, and deployment components.
  
  
• SNMP (Simple Network Management Protocol) Utilities. MKS Toolkit for System Administrators and all higher products contain the SNMPv2 snmpbulk, snmpget, snmpgetnext, snmpnetstat, snmpset, snmpstatus, snmptest, snmptrap, snmptrapd, and snmpwalk utilities. These are system administration utilities that let you control and monitor network devices and their functions.
  
• Cross-Platform Archiving Enhancements. The tar, cpio, pax, and vpax (Visual Pax) utilities can now store and retrieve Windows NT/2000 security information, while remaining compatible with UNIX archives. Additionally, in order to increase performance, when dealing with standard archives (no Windows NT/2000 security information is being stored or retrieved), these utilities no longer attempt to access security information, regardless of the setting of the TK_NTSECURITYINFO_OFF environment variable.
  
  
• Compression Utilities. MKS Toolkit for System Administrators and all higher products now include the gzip/gunzip and zip/unzip compression utilities. These utilities augment the existing suite of compression utilities: mkszip, uncompress, pack, unpack, zcat, and the -z option of cpio, pax, and tar.
  
  Note: Normally, MKS Toolkit associates the .z and .gz file extensions with the uncompress utility. If, however, when MKS Toolkit 7.5 is installed, file associations already exist for these extensions, the existing associations are not changed.
  
  
• Various New Utilities. MKS Toolkit for System Administrators and all higher products feature the following new utilities:

  	hd            formatted hexadecimal dump
  	passwd        change user password
  	shutdown      shut down a local or remote system
  	view          read-only version of vi
  	whoami        display user name of current user
  

• The ranlib utility. MKS Toolkit for Developers and all higher products also provide the ranlib utility. While the ar command automatically provides the functionality of ranlib, this utility is a convenience for developers who need to maintain Makefiles that are portable across a variety of operating systems.
  
  
• Encryption APIs. MKS Toolkit for Professional Developers and MKS Toolkit for Enterprise Developers now feature fully functional versions of the crypt(), encrypt(), and setkey() encryption APIs. The reentrant forms of these APIs, crypt_r(), encrypt_r(), and setkey_r(), have also been added. The command version, crypt, is included in MKS Toolkit for System Administrators and higher.
  
  
• Updated Debugging Libraries. MKS Toolkit for Professional Developers and MKS Toolkit for Enterprise Developers now contain updated debugging libraries, compatible with Microsoft Visusal Studio 6, to improve integration with third-party debugging applications.
  
  
• Support for Absoft Pro Fortran f90/f77 Compiler Version 7.0. MKS Toolkit for Professional Developers and MKS Toolkit for Enterprise Developers now support versions 5.0, 6.0, and 7.0 of the Absoft Pro Fortran f90/f77 compiler.
  
  
• Groff Utility Suite Add-on. GNU's groff utility suite is now available as a MKS Toolkit 7.5 add-on for owners of MKS Toolkit for System Administrators and all higher products. This suite provides text formatting and processing capability that is compatible with standard UNIX troff. The new MKS Toolkit command gman lets you display standard MKS Toolkit reference pages as well as those in groff format.
  
  If you are installing MKS Toolkit 7.5 from CD, you can install this add-on by clicking the Install groff button on the main installer screen. You can also install it by running the self-extracting executable groff-add.exe found in the AddOns directory on your CD.
  
  If you are an installing a downloaded distribution of MKS Toolkit 7.5, you can obtain the self-extracting executable groff.exe from the Add-ons page (** no longer available) of our web site.
  
  As an example of the groff suite in action, we have included the original groff versions of the reference pages for this suite in the $ROOTDIR/samples/groff directory. You can view these original pages with the following command:

  	gman -i -M $ROOTDIR/samples/groff pagename

  where pagename is the name of the page to display. Note that these original pages occasionally refer to paths beginning with C:/PROGRA~1/MKSTOO~1. This is the short name of the standard installation location for MKS Toolkit (C:/Program Files/MKS Toolkit). If you installed MKS Toolkit in a different directory, please substitute that directory when searching for the file or directory described.

New Features in Previous Releases

If you are upgrading from a pre-7.0 version of MKS Toolkit, or this is your first experience with MKS Toolkit, you may find the following links useful in understanding recent changes to the product:

• New Features in MKS Toolkit 7.0.1:
  http://www.mkssoftware.com/docs/rn/relnotes_tk70.htm#tk_701
  
  
• New Features in MKS Toolkit 7.0:
  http://www.mkssoftware.com/docs/rn/relnotes_tk70.htm#new

Known Issues

• On Windows Millennium, if you select multiple .ksh files and right-click on Edit from the context menu, a separate viw.exe is launched for each .ksh file. That is, it is the equivalent of

viw file1.ksh
viw file2.ksh
viw file3.ksh

This is due to operating system changes on Windows Millennium. On other versions of Windows, selecting multiple .ksh files and right-clicking Edit is the equivalent of

viw file1.ksh file2.ksh file3.ksh

Hardware and Software Requirements

MKS Toolkit products run only on Windows systems with Intel 32-bit processors.

All MKS Toolkit products will install on Windows 95, Windows 98, Windows Millennium, Windows NT 4.0 (Workstation, Server, or Terminal Server) with Service Pack 4+, and Windows 2000 (Professional, Server, or Advanced Server). Applications migrated from UNIX with either MKS Toolkit for Professional Developers or for Enterprise Developers will run on any of these platforms.

There are limitations for Windows 95, 98, and Millennium. Many MKS Toolkit utilities are Windows NT- or Windows 2000-specific. These are clearly documented on the reference pages (Start > Programs > MKS Toolkit > Documentation > MKS Toolkit Utilities Reference). Additionally, the SLnet Telnet Server (provided in MKS Toolkit for Interoperability and MKS Toolkit for Enterprise Developers) only runs on Windows NT/2000. In addition, because of the lack of certain OS features on Windows 95, 98, and Millennium, certain of the MKS Toolkit UNIX APIs run in degraded mode (or return without doing anything) on those platforms. These are discussed in the MKS Toolkit Cross-Platform Developer's Guide and in great detail in the reference page for each API (Start > Programs > MKS Toolkit > Documentation > MKS Toolkit UNIX APIs Reference).

The development products work with Microsoft Visual C/C++ versions 5.0 and 6.0. Both MKS Toolkit for Professional Developers and for Enterprise Developers support both versions of the Standard Template Library. In addition, they both support the Absoft Pro Fortran f90/f77 compiler, versions 5.0, 6.0, and 7.0 (http://www.absoft.com/).

The typical disk space requirements are:

Product	Typical Size
MKS Toolkit for System Administrators	67M
MKS Toolkit for Developers	73M
MKS Toolkit for Interoperability	100M
MKS Toolkit for Professional Developers	115M
MKS Toolkit for Enterprise Developers	210M

MKS Toolkit products do not have any particular hardware requirements. Any machine that is sufficient to run the underlying operating system is sufficient to run any MKS Toolkit product.

Installing MKS Toolkit

Before installing MKS Toolkit 7.5, we recommend that you uninstall any previous version of MKS Toolkit. If you have a previous version of MKS NuTCRACKER Professional, we recommend that you uninstall it, or install MKS Toolkit on another machine.

When installing MKS Toolkit for Professional Developers or MKS Toolkit for Enterprise Developers, the following additional requirements apply:

• Microsoft Visual C/C++ (version 5.0 or later) must already be installed on your system.
  
  
• You must install from an account with local or domain administrator privileges. You do not need to be an Administrator, but your login ID must be a member of the local or domain Windows Administrators group before you can install.

All MKS Toolkit products share a common installer. To install your product:

1. If you are installing from a CD, insert the MKS Toolkit distribution CD; the installer should start automatically. Click the Install Toolkit button. If you are installing from an electronic distribution, run the self-extracting installer. Click the Install Toolkit button.
   
   
2. If the installer does not start automatically, run the setup.exe installation program from the main directory of the distribution.
   
   
3. Click Next on the Welcome dialog to continue, then click Yes to accept the license agreement.
   
   
4. Enter your name and company in the appropriate fields if they are not already present or are incorrect.
   
   Enter your serial number in the Serial No field. If you have a version of MKS Toolkit already installed, the serial number for the existing MKS Toolkit appears in the field automatically.
   
   If you downloaded MKS Toolkit from our web store, your serial number will be supplied via e-mail from MKS Software. If you purchased MKS Toolkit on CD, your serial number will be included on a sheet of paper with your CD.
   
   If you do not have a serial number, check with your company's purchasing department or the reseller from which you purchased MKS Toolkit, or if you downloaded MKS Toolkit from our web store, contact tk_info@mkssoftware.com.
   
   
5. From the Setup Type and Target Directory dialog box, select one of the installation options—Typical, Compact, Custom, or NuTCRACKER Workstation Only. The Compact and Typical options are defined differently for each MKS Toolkit product. The Custom option lets you select the various components included in MKS Toolkit product you have purchased. (The NuTCRACKER Workstation Only option is for installing the runtime component to support an application migrated with one of the MKS Toolkit migration products. This is not an option to choose for an initial installation.)
   
   This dialog box also displays a default installation directory in the Installation Root Drive/Directory field. If you want to install in a different directory, use the Browse button to select that directory. If a previous installation of MKS Toolkit is present on the system, you cannot change the installation directory.
   
   
6. If you are installing MKS Toolkit for Enterprise Developers, you must next select either the standard Motif library or the Wintif library, which provides the user with a runtime choice of either a Motif or a Windows look-and-feel. Distributing an application built with Wintif requires the purchase of an extra-cost Wintif distribution license.
   
   
7. If your MKS Toolkit product includes an X server, the Select X Server(s) to Install dialog will appear. You can install any or all (or none) of the X servers. If you choose an X server, a Select Root Directory dialog will appear for each server. Select a directory into which to install the server or accept the default directory.
   
   You will then have the choice of selecting an X server that the system will start when no X server is running and DISPLAY=localhost.
   
   Note: Depending on the product, you may not have a choice of servers. You may not install both English and Japanese X servers on the same machine.
   
   Distributing one of the MKS X servers requires the purchase of an extra-cost distribution license.
   
   
8. If your MKS Toolkit product includes telnet capabilities, you will be asked for an installation directory.
   
   
9. You may then select the Start menu folder where the MKS Toolkit will appear. The default folder is MKS Toolkit.
   
   
10. A dialog will appear summarizing your selections. Click Next to begin the installation. The installation will take several minutes depending on the speed of you machine.
    
    

Uninstalling MKS Toolkit

To uninstall MKS Toolkit, run the TKUninstall utility found in your system directory (you can find your system directory with the windir -s command).

Alternatively, you can uninstall the components manually with the following procedure:

1. From the control panel, run Add/Remove Programs.
   
   
2. Remove, in order, each of the following (if present):

   MKS Evaluation Guide
   MKS Toolkit 7.x
   MKS Platform Components 7.x

You must reboot your system before reinstalling MKS Toolkit.

Customer Support

To receive support for your MKS Software product, you must buy a Preferred Customer Support (PCS) contract for that product. Some MKS Software products come bundled with PCS. For others, PCS is optional. PCS is renewable annually for a small fee and entitles you to unlimited customer support, patches, bug fixes, and all product upgrades for the duration of the contract. In any given 12-month period, MKS Software typically releases one minor upgrade (maintenance), one major upgrade (new features), and several patches, none of which you will want to miss.

In addition, customers with PCS may elect to receive periodic mailings from our customer support organization. These mailings—geared at end users—outline new features, give tips for using features, discuss how to solve common problems, and provide other frequently requested information. Moreover, as MKS Software moves more of its internal support information onto the support web site, only those customers with PCS will be able to access this controlled information, that will include instant status about reported issues, a searchable database of frequently asked questions, and much more detailed self-help information.

If you are a new customer or you have never activated your PCS account, you must register with our customer support organization. Registration—mandatory before you can receive support—is simple. The easiest way to register is by filling out the registration form during product installation, or you may do so at any time over the web at http://www.mkssoftware.com/register. And please be assured that this information is used for no other purpose than to provide support to you. Your personal information will not be given to anyone else.

Without PCS, you will not be entitled to any support, patches, bug fixes, upgrades, mailings, or self-help information. If you do not have PCS, all of our sales channels offer MKS Software products with bundled PCS for your convenience. If you already have product, but need PCS, you may purchase a PCS contract by contacting MKS Software directly at 800-637-8034 or +1-703-803-3343.

With PCS, you can request customer support by contacting us using one of the means listed below and in your request, include the name and version number of the product that you are using, your serial number, and the operating system and version/patch level that you are using. Contact MKS Software customer support at:

Additional MKS Toolkit Resources

There are several other sources for additional information about our MKS Toolkit products.

We have general product information, including technical specifications, detailed utility listings, and datasheets at:

We offer a resource kit including example scripts, additional utilities, more tutorials, and a wide variety of other useful information at:

We have a number of additional articles, tutorials, and white papers about using features of the MKS Toolkit at:

• MKS Toolkit Documentation: http://www.mkssoftware.com/docs

Through the years, we have accumulated a lot of technical details about the MKS Toolkit products and have put this information in a searchable database at:

Our customers commonly ask certain questions. These questions and their answers are in our Frequently Asked Questions pages at:

Problems Fixed

The table below documents issues that were fixed in the MKS Toolkit 7.5 release.

For convenience, the following abbreviations are used in this table

TKSA — MKS Toolkit for System Administrators
TKDev — MKS Toolkit for Developers
TKIO — MKS Toolkit for Interoperability
TKPDev — MKS Toolkit for Professional Developers
TKEDev — MKS Toolkit for Enterprise Developers

Problems Fixed in Previous Releases

If you are upgrading from a pre-7.0 version of MKS Toolkit, or this is your first experience with MKS Toolkit, you may find the following links useful in understanding recent changes to the product:

• Problems Fixed in MKS Toolkit 7.0.1 Release:
  http://www.mkssoftware.com/docs/rn/relnotes_tk70.htm#probs_701
  
  
• Problems Fixed in MKS Toolkit 7.0 Patch 1:
  http://www.mkssoftware.com/docs/rn/relnotes_tk70.htm#probs_patch1
  
  
• Problems Fixed in MKS Toolkit 7.0 Release:
  http://www.mkssoftware.com/docs/rn/relnotes_tk70.htm#probs