Welcome to MERANT Micro Focus leading UNIX development tools for distributed computing and e-business applications. This documentation includes installation instructions and licensing agreements for Object COBOL Developer Suite v4.1 for AIX and MERANT Micro Focus new flagship product Server Express for AIX. For more information on these exciting products please visit the MERANT Micro Focus web site at www.merant.com/ads

e-mail ibmaixcobol@MERANT.com

Thank you for considering MERANT Micro Focus solutions for your AIX platform. If you require further information on MERANT solutions please contact our web site at www.merant.com.

Object COBOL v4.1 Read This First and Product Installation Guide

Object COBOL v4.1 Licensing Agreement

Server Express 1.0 Read This First and Product Installation Guide

Server Express 1.0 Licensing Agreement

Object COBOL^™ V4.1 For UNIX^®

Table of Contents

Welcome
Important Licensing Information
Install Type C
Software Installation
For More Information

Welcome to Micro Focus Object COBOL for UNIX

This Read This First and Product Installation Guide provides basic information and installation instructions for Micro Focus Object COBOL V4.1 for UNIX and the License Management Facility used to manage product licenses.

Important Licensing Information

Using Micro Focus Products for UNIX

Before installing and using your Micro Focus product for UNIX you should ensure that you have read and understood the license agreement supplied with the product. If you cannot find the license or do not fully understand it, please contact your Micro Focus Account Representative or your Micro Focus licensed supplier before proceeding.

Throughout this document references are made to $COBDIR. $COBDIR is the location at which you install your COBOL products. The defaults are /usr/lib/cobol for UNIX SVR3 and AIX systems, /opt/lib/cobol for UNIX SVR4 and SCO systems, and /opt/cobol/cobdir for Hewlett-Packard systems. Wherever examples of setting environment variables are provided, product defaults are used.

All example command lines are specific to sh and ksh. If you are using csh you should use the equivalent csh commands for the examples provided.

If you have a previous Micro Focus COBOL product installed we recommend that you make a backup of any COBOL systems files that you may have changed. Examples include cobkeymp, ADISCTRL, cobopt and cobconfig. After you have installed your new Micro Focus COBOL product you might want to apply to the new COBOL product the changes previously applied to these files.

If you are installing a COBOL system over an existing COBOL system, you must delete the existing COBOL system first. Alternatively, you may prefer to move your existing COBOL system to another directory until you have verified the new installation.

This Micro Focus product is managed by a License Management Facility (LMF). This facility helps you keep track of the number of licenses you have for the product. In order to use this product it is necessary for you to install the License Management Facility (which is provided with the Object COBOL software). This software should be installed in a different directory to the COBOL product. The defaults are /usr/lib/mflmf for UNIX SVR3 and AIX systems, /opt/lib/mflmf for UNIX SVR4 and SCO systems, and /opt/cobol/mflmf for Hewlett-Packard systems.

Install Type C - CD-ROM

1. Login as root and create the directory into which you want to install the product. This directory is referred to as $COBDIR. Make this directory the current directory. For example, for UNIX SVR3 (including AIX):

mkdir /usr/lib/cobol
cd /usr/lib/cobol

2. Set the UNIX file creation mask by entering:

umask 022

3. Insert the CD-ROM, labeled Object COBOL V4.1 for UNIX, into the CD-ROM drive (this may involve using a caddy). If the CD-ROM is not automatically mounted, also mount the CD-ROM using the appropriate system commands.

4. Copy the contents of the CD-ROM into the current directory using the following command:

tar xvf /cdrom/ocobol.tar

where /cdrom is the path associated with the mounted CD-ROM.
 

5. Unmount and remove the CD-ROM using the appropriate system commands.

Software Installation

This section provides information on installing the extracted software.

1. When you have extracted the product software from the distribution media, install the software by entering the following command:

sh ./install

2. During the installation process, you are prompted for the location in which to install the product's drivers. The default location for the COBOL driver programs on Hewlett-Packard systems is /opt/cobol/bin and other UNIX systems is /usr/bin.

3. On some operating systems you need to have the C++ compiler, C++ libraries and C++ utilities installed to support Object Oriented COBOL application development.

If your operating system requires this and the necessary files are installed on your machine, then you will be given the option to install the necessary COBOL support (in addition to the default procedural (traditional) COBOL support). If you are given the option, answer either Y(es) or N(o).

If you operating system does not require the C++ components to be installed in order to support Object Oriented COBOL application development then you will not be prompted and you need take no special action.
 

4. Next you are asked whether or not you would like the License Management Facility (LMF) installed. Unless you are re-installing Micro Focus Object COBOL (and LMF is already installed) we strongly recommend that you answer yes by entering:

Y

If you answer no, you can install LMF at a later time by logging in as root, changing directory to $COBDIR/lmf and entering sh ./lmfinstall.

Important: Until an LMF system is installed on your system you will not be able to use this product.   

5. During the LMF installation process you are prompted for the location in which to install LMF. The default is /usr/lib/mflmf (for UNIX SVR3 including AIX), /opt/lib/mflmf (UNIX SVR4 including SCO), and /opt/cobol/mflmf (Hewlett-Packard systems).

6. You are then asked as to whether you want the License Manager to be started automatically when the machine boots. We recommend that you answer yes by entering:

Y

If you answer no, you can implement this later. Refer to your License Management Facility Administrator's Guide for details.
 

7. Once you have completed these steps, you exit the installation script. You must now ensure that the environment is set correctly to point to the product, its drivers and, where appropriate, other environment variables, as follows. For UNIX SVR3 (including AIX):

COBDIR=/usr/lib/cobol
export COBDIR
PATH=/usr/bin:$PATH
export PATH

On IBM RS/6000 Systems running AIX the following variable also needs to be set:

LIBPATH=/usr/lib:$COBDIR/coblib:$LIBPATH
export LIBPATH

8. Now make the location of the LMF software your current directory and start the License Manager for the first time, as follows. For UNIX SVR3 (including AIX):

cd /usr/lib/mflmf
sh ./mflmman

 

Additional information on Starting the License Manager can be found in the chapter Administration Tasks in your License Management Facility Administrator's Guide.
 

9. The final step, before using Micro Focus Object COBOL, is to add the product licenses to the License Management Facility. Refer to Installing License Keys Initially in the chapter Administration Tasks of your License Management Facility Administrator's Guide. Once you have completed this, you are ready to use the product.

 Object COBOL^™ V4.1 For UNIX^®

BREAKING THE SEALED WRAPPER OF THE MEDIA FOR THE SOFTWARE PRODUCT ACCOMPANYING THIS LICENSE INDICATES YOUR AGREEMENT TO BE BOUND BY THE TERMS AND CONDITIONS CONTAINED IN THIS END USER SOFTWARE LICENSE AGREEMENT. IF THESE TERMS AND CONDITIONS ARE NOT ACCEPTABLE TO YOU, RETURN THE ENTIRE PROGRAM PACKAGE UNUSED AND UNOPENED, INCLUDING THE DOCUMENTATION, THE UNOPENED MEDIA PACKAGE, AND, IF APPLICABLE, ANY SUPPLIED MICRO FOCUS SOFTWARE SECURITY KEY(S), TO THE SUPPLIER OF THE PRODUCT.

1. Grant of License. Micro Focus ("Micro Focus") grants you, as an end user, a personal,exclusive license to use the software ("Software") and documentation ("Documentation") comprising this program package ("Program Package"), only within the continent where you acquired the Program Package, subject to the following terms and conditions and any additional terms and conditions specified as "License Information" in the Documentation.

2. Term of License. Subject to termination for your breach of this Agreement, this Agreement and your license will last indefinitely. If you violate any term or condition of this Agreement, Micro Focus or its agents may terminate this Agreement and your license immediately by giving you written notice of termination. You may also terminate this Agreement and your license voluntarily by giving notice of termination to Micro Focus. You will have no right to keep or use any copy of the Software for any purpose after termination and agree upon request to return the Program Package, and all copies, to Micro Focus.

3. Limited Warranty. Micro Focus warrants for a period of ninety (90) days from delivery to you (the "Warranty Period") that the copy of the Software delivered to you conforms in all material respects to the Documentation and that the media on which the Software is supplied are free from defects in materials or workmanship under normal use. As the sole and exclusive remedy for the media not meeting the above warranty, Micro Focus will repair or replace free of charge any defective recording medium on which the Software is recorded if the medium is returned to Micro Focus by you during the Warranty Period. This warranty does not cover defects due to accident, abuse, service or modification by any unauthorized person, or any cause occurring after initial delivery of the medium to you. As the sole and exclusive remedy for any failure of the Software to conform to the Documentation, Micro Focus shall repair, replace, or correct the Software if such failure is reported during the Warranty Period or, if Micro Focus reasonably determines that such remedy is not economically or technically feasible, Micro Focus or your product suppliers shall provide a full refund of the license fee paid with respect to the particular Software.

4. Disclaimer of Warranty. Except as provided herein, all conditions, warranties, and undertakings, express or implied, statutory or otherwise, on the part of Micro Focus and its third-party suppliers are excluded including without limitation those of merchantability or fitness for purpose. The Software cannot be tested in every possible operating environment; therefore, Micro Focus does not warrant that the functions contained in the Software will meet your requirements, or that operation of the Software will be uninterrupted, or that this Program Package is error free. You acknowledge that you are responsible for the selection of this Program Package to achieve your intended results and for the installation, use of, and results obtained therefrom. This Agreement, however, shall not purport to exclude or restrict the liability of Micro Focus to any extent not permitted by law.

5. EXCLUSION OF DAMAGES. NEITHER MICRO FOCUS NOR ANY THIRD-PARTY SUPPLIER SHALL BE LIABLE FOR ANY INJURY, LOSS OR DAMAGE WHETHER INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM PACKAGE INCLUDING WITHOUT LIMITATION LOST PROFITS, CONTRACTS DATA, OR PROGRAMS, INCLUDING THE COST OF RECOVERING SUCH DATA OR PROGRAMS, EVEN IF INFORMED OF THE POSSIBILITY OF SUCH DAMAGES IN ADVANCE.

6. LIMITATION OF LIABILITY. ANY LIABILITY OF MICRO FOCUS SHALL BE LIMITED IN THE AGGREGATE TO THE AMOUNTS PAID BY YOU FOR THIS PROGRAM PACKAGE. THIS LIMITATION APPLIES TO ALL CAUSES OF ACTION, INCLUDING BREACH OF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION, AND OTHER TORTS. THE LIMITATION OF LIABILITIES DESCRIBED IN THIS SECTION ALSO APPLIES TO ANY THIRD-PARTY SUPPLIER OF MATERIALS SUPPLIED TO YOU. MICRO FOCUS AND ITS THIRD-PARTY SUPPLIER LIMITATIONS OF LIABILITIES ARE NOT CUMULATIVE. THIS AGREEMENT, HOWEVER, SHALL NOT PURPORT TO EXCLUDE OR RESTRICT THE LIABILITY OF MICRO FOCUS TO ANY EXTENT NOT PERMITTED BY LAW.

7. Ownership. Micro Focus and its suppliers have and will retain all ownership rights to the Software and Documentation, including all patent rights, copyrights, trademarks, service marks, related goodwill and confidential and proprietary information. You have no rights in the Software or Documentation except as explicitly stated in this Agreement. Software provided under this Agreement may contain or be derived from portions of materials provided by a third-party under license to Micro Focus. Any such third-party suppliers are intended beneficiaries of Sections 1, 4, 5, and 6 of this Agreement. Micro Focus has assumed responsibility for the selection of such materials and their use in producing the Program Package.

8. Use by Government of the United States of America. Use, duplication, or disclosure by the Government of the United States is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227­7013 or subparagraphs (c)(1) and (2) of Commercial Computer Software - Restricted Rights at 48 CFR 52.227-19, as applicable. Contact Micro Focus, 2465 East Bayshore Road, Palo Alto, California 94303.

9. Program Package Specific License Terms for UNIX. If the Program Package is a Micro Focus COBOL product for UNIX, per user licensing fees apply. Licenses for additional users on the same installation require an additional single user copy license fee be paid for each additional user. Applications which make use of files contained in Operating System Extensions (OSX) for UNIX or Application Server for UNIX require production licenses for each server and user of the application. This License grants you the right to use certain OSX, Application Server and user licenses. Please see the specific details in the User Documentation. Should you desire more information or need additional licenses please contact your Micro Focus Representative for more information.

10. Security Key(s) - Hardware and Software. If provided, ownership of Micro Focus Software Security Key(s) ("Security Keys") and all intellectual property rights, related goodwill, and confidential and proprietary information in the Security Keys vest in Micro Focus or a third party from whom Micro Focus has obtained the right to license end users. You may not transfer the Security Keys to a third party without the prior written consent of Micro Focus, nor attempt to reverse engineer, reverse compile or disassemble the Security Keys. You agree to return the Security Keys to Micro Focus in the event of the termination of this License as specified in Section 2. The Limited Warranty as specified in Section 3, the Disclaimer of Warranty as specified in Section 4, Exclusion of Consequential Damages as specified in Section 5, and the Limitation of Liability as specified in Section 6 shall apply equally to Security Keys.

11. License Fees, Payment and Terms. You agree to pay the applicable end user license fees, any applicable transportation charges, and any Value Added Tax or other applicable taxes as may be required in the country where you acquired the Program Package, within thirty (30) days of the date of invoice.

12. Exclusive Agreement. This Agreement is the complete and exclusive statement of agreement between the parties and supersedes all proposals, communications, purchase orders and prior agreements, verbal or written, between the parties. If you acquired the Program Package in North America, this License is governed by the laws of the state of California. If you acquired the Program Package in France, Germany or Japan, this License is governed by the laws of the country in which you acquired the Program Package. In the rest of the world, this License is governed by the laws of England.

 Server Express 1.0

Read This First and

• Welcome
• Important Licensing Information
• Before You Start
• Software Installation
• For More Information

This booklet provides basic information and installation instructions for Server Express™ 1.0 and the License Management Facility used to manage product licenses.

Each application created using a Server Express product that is to be deployed in a UNIX environment must include a Micro Focus Application Server™ 1.0 for Server Express license from MERANT or from your MERANT licensed supplier. Application Server must be installed on the machine on which the application is to run. Please contact your MERANT Account Representative or your MERANT licensed supplier for details on purchasing Application Server licenses.

Throughout this document references are made to $COBDIR; this is the location at which you install your COBOL products. The default is /usr/lpp/cobol for IBM® RS/6000® and PowerPC™ systems running AIX®, and /opt/lib/cobol for all other systems. Wherever examples of setting environment variables are provided, product defaults are used.

To exit from the license administration tool press Escape; confirm by pressing Y.

To ensure that the license server is running type mflmman

Additional information about MERANT and MERANT products is available on the World-Wide Web. Use a browser to connect to http://www.merant.com.

IMPORTANT: MERANT IS PROVIDING THE MERANT MICRO FOCUS SERVER EXPRESS SOFTWARE FOR YOUR USE SUBJECT TO YOUR AGREEMENT TO BE BOUND BY THE TERMS AND CONDITIONS SET FORTH BELOW. IF THESE TERMS AND CONDITIONS ARE NOT ACCEPTABLE TO YOU, DO NOT INSTALL THIS SOFTWARE, BUT RETURN IT UNOPENED TO YOUR DISTRIBUTOR AND YOUR MONEY WILL BE REFUNDED.

END USER SOFTWARE LICENSE AGREEMENT FOR MERANT MICRO FOCUS SERVER EXPRESS v1.0
AND MERANT MICRO FOCUS APPLICATION SERVER v1.0 FOR SERVER EXPRESS

1. Grant of License. MERANT ("MERANT") grants you, as an end user, a personal, non-exclusive, non-transferable license to use the Micro Focus Server Express ("Server Express") and/or Micro Focus Application Server for Server Express ("Application Server") software components and documentation ("Documentation") comprising this program package ("Program Package"), only within the continent where you acquired the Program Package, subject to the following terms and conditions:

2. Term of License. Subject to termination for your breach of this Agreement (including without limitation those obligations for payment of license fees arising under Section 10, below), this Agreement and your license will last indefinitely. If you violate any term or condition of this Agreement, MERANT or its agents may terminate this Agreement and your license immediately by giving you written notice of termination. You may also terminate this Agreement and your license voluntarily by giving notice of termination to MERANT. You will have no right to keep or use any copy of the Software for any purpose after termination and agree upon request to return the Program Package, and all copies, to MERANT.

3. Limited Warranty. MERANT warrants for a period of ninety (90) days from delivery to you (the "Warranty Period") that the copy of the Server Express or Application Server delivered to you conforms in all material respects to the Documentation and that the media on which the Server Express or Application Server is supplied are free from defects in materials or workmanship under normal use. As the sole and exclusive remedy for the media not meeting the above warranty, MERANT will repair or replace free of charge any defective recording medium on which the Server Express or Application Server is recorded if the medium is returned to MERANT by you during the Warranty Period. This warranty does not cover defects due to accident, abuse, service or modification by any unauthorized person, or any cause occurring after initial delivery of the medium to you. As the sole and exclusive remedy for any failure of the Server Express or Application Server to conform to the Documentation, MERANT shall repair, replace, or correct the Server Express or Application Server if such failure is reported during the Warranty Period or, if MERANT reasonably determines that such remedy is not economically or technically feasible, MERANT or your product suppliers shall provide a full refund of the license fee paid with respect to the particular Server Express or Application Server.

4. Disclaimer of Warranty. Except as provided herein, all conditions, warranties, and undertakings, express or implied, statutory or otherwise, on the part of MERANT and its third-party suppliers are excluded including without limitation those of merchantability or fitness for purpose. The Server Express or Application Server cannot be tested in every possible operating environment; therefore, MERANT does not warrant that the functions contained in the Server Express or Application Server will meet your requirements, or that operation of the Server Express or Application Server will be uninterrupted, or that this Program Package is error free. You acknowledge that you are responsible for the selection of this Program Package to achieve your intended results and for the installation, use of, and results obtained therefrom and agree to indemnify, hold harmless and defend MERANT so that MERANT shall bear no responsibility for any loss to or claims by third parties that may arise as a result of your distribution of the Application Server. This Agreement, however, shall not purport to exclude or restrict the liability of MERANT to any extent not permitted by law.

5. EXCLUSION OF DAMAGES. NEITHER MERANT NOR ANY THIRD-PARTY SUPPLIER SHALL BE LIABLE FOR ANY INJURY, LOSS OR DAMAGE WHETHER INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM PACKAGE INCLUDING WITHOUT LIMITATION LOST PROFITS, CONTRACTS, DATA, THIRD PARTY LOSS OR LOSS OF PROGRAMS, INCLUDING THE COST OF RECOVERING SUCH DATA OR PROGRAMS, EVEN IF INFORMED OF THE POSSIBILITY OF SUCH DAMAGES IN ADVANCE.

6. LIMITATION OF LIABILITY. ANY LIABILITY OF MERANT SHALL BE LIMITED IN THE AGGREGATE TO THE AMOUNTS PAID BY YOU FOR THIS PROGRAM PACKAGE. THIS LIMITATION APPLIES TO ALL CAUSES OF ACTION, INCLUDING BREACH OF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION, AND OTHER TORTS. THE LIMITATION OF LIABILITIES DESCRIBED IN THIS SECTION ALSO APPLIES TO ANY THIRD-PARTY SUPPLIER OF MATERIALS SUPPLIED TO YOU. MERANT AND ITS THIRD-PARTY SUPPLIER LIMITATIONS OF LIABILITIES ARE NOT CUMULATIVE. THIS AGREEMENT, HOWEVER, SHALL NOT PURPORT TO EXCLUDE OR RESTRICT THE LIABILITY OF MERANT TO ANY EXTENT NOT PERMITTED BY LAW.

7. Ownership. MERANT and its suppliers have and will retain all ownership rights to the Server Express, Application Server and Documentation, including all patent rights, copyrights, trademarks, service marks, related goodwill and confidential and proprietary information. You have no rights in the Server Express, Application Server or Documentation except as explicitly stated in this Agreement. Server Express or Application Server provided under this Agreement may contain or be derived from portions of materials provided by a third-party under license to MERANT. Any such third-party suppliers are intended beneficiaries of Sections 1, 4, 5, and 6 of this Agreement. MERANT has assumed responsibility for the selection of such materials and their use in producing the Program Package.

8. Use by Government of the United States of America. Use, duplication, or disclosure by the Government of the United States is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227-7013 or subparagraphs (c)(1) and (2) of Commercial Computer Software - Restricted Rights at 48 CFR 52.227-19, as applicable. Contact MERANT, 701 East Middlefield Road, Mountain View, California 94043.

9. License Key(s). If provided, ownership of MERANT Software License or Security Key(s) (collectively "License Keys") and all intellectual property rights, related goodwill, and confidential and proprietary information in the License Keys vest in MERANT or a third party from whom MERANT has obtained the right to license end users. You may not transfer the License Keys to a third party without the prior written consent of MERANT, nor attempt to reverse engineer, reverse compile or disassemble the License Keys. You agree to return the License Keys to MERANT in the event of the termination of this License as specified in Section 2. The Limited Warranty as specified in Section 3, the Disclaimer of Warranty as specified in Section 4, Exclusion of Damages as specified in Section 5, and the Limitation of Liability as specified in Section 6 shall apply equally to License Keys.

10. License Fees, Payment and Terms. You agree to pay the applicable end user license fees, any applicable transportation charges, and any Value Added Tax or other applicable taxes as may be required in the country where you acquired the Program Package, within thirty (30) days of the date of invoice.

11. Assignment and Delegation. You may not assign this Agreement or any rights under it and may not delegate any duties under this Agreement without MERANT' prior written consent. Any attempt to assign or delegate without that consent will be void.

12. Third-Party Software Terms and Conditions. Components of the Program Package provided by third-party suppliers may be subject to any separate terms and conditions included with or contained in the setup installation segments of such third-party software components.

13. Exclusive Agreement. This Agreement is the complete and exclusive statement of agreement between the parties and supersedes all proposals, communications, purchase orders and prior agreements, verbal or written, between the parties. If you acquired the Program Package in North America, this License is governed by the laws of the state of California. If you acquired the Program Package in France, Germany or Japan, this License is governed by the laws of the country in which you acquired the Program Package. In the rest of the world, this License is governed by the laws of England.