HP Micro Focus Object COBOL/UX Release Notes for Version B.13.35 HP 9000 Computers on HP-UX 11.x First Edition 5967-0046 February 1999 Printed in: U.S.A. © Copyright 1999 Hewlett-Packard Company.
Legal Notices The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material. Including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance or use of this material. Copyright © 1999 Hewlett-Packard Company.
Trademarks © Copyright 1980, 1984, 1986 AT&T Technologies, Inc. UNIX and System V are registered trademarks of AT&T in the USA and other countries. UNIX® is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited. © Copyright 1985-1986, 1988 Massachussetts Institute of Technology. X Window System™ is a trademark of the Massachussetts Institute of Technology.
Contents 1. New and Changed Features New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 New Micro Focus Object COBOL Version 4.1.20 . . . . . . . . . . . . . . . . .10 Revised Online HP Micro Focus Object COBOL/UX Programmer’s Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 New ldtab Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents FLEXlm Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 FLEXlm Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 The License Request Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Installing and Setting Up the FLEXlm License Manager . . . . . . . . . . . Installing FLEXlm with hpmfocdsini . . . . . . . . . . . . . . . . . . . . . . . . . Redeeming Your Licenses . . . . . . . . . . . . . . .
Contents Troubleshooting FLEXlm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54 Troubleshooting Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54 Wrong hostid for Machine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54 lmver Cannot Find FLEXlm Library liblmgr.a . . . . . . . . . . . . . . . . .54 Who do I call if I need help with FLEXlm? . . . . . . . . . . . . . . . . . . . .55 Known Problems. . . . . . . . . . . . . . . .
Contents 8
New and Changed Features 1 New and Changed Features IMPORTANT With your COBOL product, you may have received Release Notes for all current versions of HP Micro Focus Object COBOL/UX available on your hardware. You only need the Release Notes for HP Micro Focus Object COBOL/UX developed for your HP-UX operating system version. Ignore the other Release Notes that are not for your version of HP-UX. This release document describes HP Micro Focus Object COBOL/UX B.13.
New and Changed Features New Features New Features New Micro Focus Object COBOL Version 4.1.20 HP Micro Focus Object COBOL/UX B.13.35 provides the Micro Focus Object COBOL version 4.1.20 to Hewlett-Packard customers. This release are supported on HP9000 computers running HP-UX 11.x. Micro Focus Object COBOL, version 4.1.20 gives you the ability to compile object COBOL applications.
New and Changed Features New Features New ldtab Processing When a COBOL program or custom run-time system is built by cob, the COBOL run-time system symbol table (ldtab) will be optimized to: • reduce building time • reduce the amount of data space initially required by the executable • eliminate data dependencies on system libraries that could otherwise limit binary compatibility. For most users this change will only result in the benefits noted above.
New and Changed Features New Features Once a successful CBL_HP_SH_LOAD has occurred, COBOL programs in the shared library can be accessed through any of the following mechanisms: • COBOL call verb statement • cobcall • cobfunc • using CBL_HP_SHL_FINDSYM and then calling the program indirectly See the section “New API to Support Loading HP-UX Shared Libraries Containg COBOL Programs” in the online of the HP Micro Focus Object COBOL/UX Programmer’s Guide in $COBDIR/docs/html/library.htm.
New and Changed Features Removed Features Removed Features All Motif Functionality All Motif functionality has been removed from HP Micro Focus Object COBOL/UX, including the graphical mode version of the Dialog System and the Fileshare View utility, fsviewmot. Use fsclose to shut down a background fileshare process (fs -b). See chapter 18 in the Programmer’s Guide to File Handling manual for details.
New and Changed Features Features That May be Removed in Future Releases Features That May be Removed in Future Releases File Handler Utilities The Micro Focus File Handler utilities may be removed in a future release. Use the rebuild utility instead. See $COBDIR/docs/rebuild.1 for information on rebuild. Run-time Support for Classic gnts As of version B.12.25, all gnts produced will have characteristics previoiusly available only when useing the HP platform-specific snt executable form.
Installation Information 2 Installation Information Read this entire chapter and these Release Notes before installing version B.13.35 of HP Micro Focus Object COBOL/UX. Immediately after installing the product, review the online documents included in $COBDIR/docs.
Installation Information Compatibility with Previous Versions Compatibility with Previous Versions If Your Code Was Built With This Version of COBOL B.13.2x (V4.1 base on HP-UX 11.x) B.12.2x (V4.1 base on HP-UX 10.20) These Types of Code can be run on Version B.13.35 (MF V4.1.20 base on HP-UX 11.x) Compatible Code .int, .gnt, .snt, shared-bound executables (lib*.sl and a.out) B.11.2x, B.11.30 (V4.0 base on HP-UX 10.20) 1.
Installation Information Compatibility with Previous Versions If Your Code Was Built With This Version of COBOL B.09.xx (V3.1 base on HP-UX 10.0x) These Types of Code can be run on Version B.13.35 (MF V4.1.20 base on HP-UX 11.x) Compatible Code .int, .gnt, .snt B.08.1x (V3.1 base on HP-UX 9.x) Notes: 1. Due to the HP-UX system limitations, all objects, shared libraries, and archive libraries (.o, lib*.sl, lib*.
Installation Information Compatibility with Previous Versions If Your Code Was Built With This Version of COBOL B.07.xx (V3.0 base on HP-UX 9.x) These Types of Code can be run on Version B.13.35 (MF V4.1.20 base on HP-UX 11.x) Compatible Code .int code Notes: 1. Only .int code is compatible from version B.07.xx. After you install this release, you must do the following: a. Regenerate native code (.gnt, .snt, .o) and rebuild any shared or archive libraries. b.
Installation Information System Requirements System Requirements Version B.13.35 runs only on HP-UX 11.x. Programs compiled with version B.13.35 will not run on HP-UX 10.20 or on systems that have a previous version of Micro Focus COBOL installed. Moving an earlier version of the compiler from HP-UX 10.x (or earlier) to HP-UX 11.x is not supported. To install HP Micro Focus Object COBOL/UX, you must have the following system components: • A Hewlett-Packard 9000 computer • HP-UX operating system version 11.
Installation Information Installing HP Micro Focus Object COBOL/UX Installing HP Micro Focus Object COBOL/UX After loading the HP-UX 11.x operating system, you can install your HP Micro Focus Object COBOL/UX. To install your software, run the SD-UX swinstall command. It will invoke a user interface that will lead you through the installation.
Installation Information Installing HP Micro Focus Object COBOL/UX B.13.35: $ $COBDIR/bin/cobrun Cobol/HP-UX HP35326 B.13.35 Copyright Hewlett-Packard Co. 1989-1998 V4.1 revision 20 build 10/10/2 G; 31898. Run Time System OXUPK/BMB/01335L In this example, Cobol/HP-UX is the original product name, HP35326 is the support number, and B.13.35 is the HP version number for this release. Note that the letter at the end of the second line may be different than what is listed here.
Installation Information Installing HP Micro Focus Object COBOL/UX Identifying Compiler Version Used with cobwhat Some releases of the product require users to re-compile their sources because some new versions of the run-time system will not execute an .int file that was compiled on a previous version of COBOL. The run-time system can abort while executing an .int file that has not been recompiled. cobwhat enables you to identify the version of the compiler or NCG used to create a COBOL executable form (.
Installation Information Installing HP Micro Focus Object COBOL/UX Output: -------------------------------------------------File : pi.gnt (executable) PII 98113012165559 GNB-153056000AA PA-RISC ncg B.13.35 -------------------------------------------------File : pi.o PII 98113012165764 GNB-153056000AA PA-RISC ncg B.13.35 -------------------------------------------------File : pi.idy Micro Focus COBOL for UNIX V4.1 revision 020 -------------------------------------------------- Example: $ cobwhat pi pi.
Installation Information Installing HP Micro Focus Object COBOL/UX Installing the Online Documentation Files This version of COBOL includes html (hyper-text markup language) files for both HP Micro Focus COBOL/UX Programmer’s Guide and the Micro Focus Object COBOL manual set. These files are in a compressed format after you install COBOL. You can choose to install the HP manual, the Micro Focus manuals, or all.
Installation Information Product Configuration Product Configuration HP Micro Focus Object COBOL/UX is already configured to run on your HP 9000. You can change the default configuration and you can control certain machine independent features, such as the message text that HP Micro Focus Object COBOL/UX displays. See the Micro Focus Object COBOL Programmer’s Guide to Writing Programs, “Application Configuration System” for more information.
Installation Information Product Configuration 26 Chapter 2
License Management with FLEXlm and COBOL 3 License Management with FLEXlm and COBOL Introduction to FLEXlm This version of HP Micro Focus Object COBOL/UX includes GLOBEtrotter Software’s flexible license management tool, FLEXlm. FLEXlm provides a flexible and secure method of managing concurrent use license access to software from a multi-platform, heterogeneous user environment.
License Management with FLEXlm and COBOL • A network that allows TCP/IP communication between workstations and servers. This is normally included in the HP-UX operating system. • The FLEXlm software installed on machines that will be the license servers. • A license.dat file that contains the FLEXlm file entries. To redeem your licenses and receive the license.dat file entries, follow the directions in “Redeeming Your Licenses” on page 34.
License Management with FLEXlm and COBOL • The license client (HP Micro Focus Object COBOL/UX) The license client, HP Micro Focus Object COBOL/UX, is linked with the FLEXlm Client Library that provides the communication with the license server. During execution, the license client communicates with the vendor daemon to request a license. The License Request Process When you run a FLEXlm-licensed application, a license is automatically requested and the following process occurs: 1.
License Management with FLEXlm and COBOL Figure 3-1 The License Request Process NOTE Time Allocation of Licenses If a license is granted, the minimal time allocated to that license is one hour. The license stays with the user for one hour after the completion of the COBOL component that requested it (for example, a compile or Animator session). This allows a user to run multiple components without losing the license.
License Management with FLEXlm and COBOL seconds before continuing execution. If you frequently receive these overdraft warnings, you may not have purchased enough licenses to meet your actual needs. NOTE Exceeding License Allotments If all purchased and overdraft licenses are in use, any attempt to start a licensed component by a host, user, or ttyname that does not hold a license produces an error message on stderr indicating a license denial, and the component will terminate.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager Installing and Setting Up the FLEXlm License Manager HP Micro Focus Object COBOL Developer Suite uses GLOBEtrotter’s Flexible License Manager (FLEXlm version 5.12a) software to provide license enforcement for components of this suite. The HP Micro Focus Object COBOL Developer Suite utilizes floating licenses (as opposed to node, terminal, or user locked licenses) to provide the greatest flexibility.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager All path references and examples in this document refer to this default path. If you install your FLEXlm components in a different location or if you already had a version of FLEXlm installed, please note that your FLEXlm location will be different than the examples in this document. Installing FLEXlm with hpmfocdsini The FLEXlm software is not automatically installed when the COBOL is installed.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager Redeeming Your Licenses With your COBOL product you received either a Software License Certificate or a License Entitlement Certificate. You will find the License File Request Form on the back of your certificate. NOTE If you cannot locate these documents or have questions about FLEXlm, contact Licensing Services at: Hewlett-Packard World Wide Licensing Services California, U.S.A.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager To complete the License File Request Form, you will need to know both your hostid and hostname of the license server system (or systems if you have redundant servers). The hostid and hostname were displayed by the hpmfocdsini script and a copy of the information was left in the /var/tmp/hpmfocdsini.log file that hpmfocdsini generated. NOTE Note that /var/tmp/hpmfocdsini.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager Creating or Updating the license.dat File This section describes adding COBOL license file entries to the license.dat file and some common configurations. For more complex configurations, please consult the appropriate GLOBEtrotter FLEXlm documentation at their website: http://www.globetrotter.com The license.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager $ /usr/local/flexlm/bin/lmdiag hpmfcobol If this does not work, you may need to stop all of the lmgrd processes on your network and then restart them as described in the section, “Starting lmgrd (License Manager Daemon)” on page 40. 3. If you did change or add an options file, you will need to shutdown the lmgrd with lmdown and then restart it to cause the new options file to be read.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager NOTE The server line contains a port address of 7788. You will need to change this port address if you have another FLEXlm lmgrd already using port 7788 to serve another license.dat file, or if you have to have some other process using this port. NOTE You can verify that the license file is valid by running lmcksum: $ lmcksum -c /usr/local/flexlm/licenses/license.dat 2.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager The debug log file output can be switched after the daemons are running. The technique to do this involves piping the stdout of lmgrd to a shell script that appends to the file for each line. To do this, instead of the normal start-up of $ lmgrd > filename.log, start lmgrd this way: $ lmgrd | sh -c ‘while read line; do echo “$line” >> \ filename.log ; done’ With this start-up method, the output file, filename.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager if [ -f /usr/local/flexlm/bin/lmgrd ] then LM_LICENSE_FILE=/usr/local/flexlm/licenses/license.dat export LM_LICENSE_FILE LIC_DATA=‘dirname $LM_LICENSE_FILE‘ echo Starting FLEXlm license daemon su nonrootuser -c “/usr/local/flexlm/bin/lmgrd -c $LM_LICENSE_FILE \ >$LIC_DATA/license.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager NOTE If you have more than one SERVER line in your license.dat file, (for example, if you are using a redundant server configuration), you need to start lmgrd on all of the machines listed on SERVER lines before lmstat will show that the licenses are available.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager was installed), you must correct the path on the DAEMON line before you will be able to successfully start the FLEXlm license manager and run HP Micro Focus Object COBOL/UX. Vendor Daemon Options File You can customize and control use of FLEXlm licenses by using the vendor daemon options file, hpcuplangs.opt.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager REPORTLOG specifies the log file written which is suitable for use by the Enhanced User Tools report-writer available from GLOBEtrotter Software. If filename begins with a plus sign (+), the file will be opened for append; otherwise the file will be overwritten each time the daemon is started.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager Creating the Vendor Options File Using any text editor, create an options file with the appropriate options described in “Using Options” on page 42. You can put the options file anywhere; however, the recommended path for the options file is the following: /usr/local/flexlm/options/hpcuplangs.
License Management with FLEXlm and COBOL Installing and Setting Up the FLEXlm License Manager Whenever you change the fourth field on the DAEMON line in the license.dat file or you change or add an options file, you will need to shutdown the lmgrd with lmdown and then restart it to cause the new options file to be read. Obtaining Additional Licenses To purchase more licenses, contact your HP Sales Representative or Order Coordinator and request the additional licenses.
License Management with FLEXlm and COBOL FLEXlm Utilities FLEXlm Utilities When hpmfocdsini installs the FLEXlm components, it installs the license administration tool, lmutil. lmutil contains several utility programs embedded within it. You can use these utilities to better manage the use of FLEXlm licenses. By default, the utilities are placed in /usr/local/flexlm/bin.
License Management with FLEXlm and COBOL FLEXlm Utilities All of the utilities accept the following arguments: -v print version and exit -c license_file operate on the license.dat file specified by license_file Brief descriptions of the utilities are included in the following sections. Complete information on the use of FLEXlm tools and utilities can be found in the GLOBEtrotter FLEXlm End User Manual at: http://globetrotter.com/manual.
License Management with FLEXlm and COBOL FLEXlm Utilities Using lmdiag This utility allows you to diagnose problems encountered when trying to check out a license. Its usage is as follows: lmdiag [-c license_file] [-n] [feature] where -c license_file is the path to the license.dat file that contains the features you are having trouble with. -n run in non-interactive mode. lmdiag will not prompt for any input. Extended connection diagnostics are not available. feature diagnose this feature only.
License Management with FLEXlm and COBOL FLEXlm Utilities If a license file is not specified with the -c option, lmdown operates on the license file specified by the LM_LICENSE_FILE environment variable. If a LM_LICENSE_FILE environment variable is not found, it tries to use /usr/local/flexlm/licenses/license.dat. In most cases, specify the exact location of the license.dat file you want lmdown to operate on.
License Management with FLEXlm and COBOL FLEXlm Utilities Using lmremove This utility generally allows the system administrator to remove a single user’s license for a specified feature. However, you cannot use lmremove to remove a COBOL license. If you attempt to do this, lmremove appears to succeed and lmgrd logs a message stating that the license was removed; however, the license is not given up and returned to the pool of available licenses.
License Management with FLEXlm and COBOL FLEXlm Utilities Its usage is: lmstat [-a] [-S] [daemon]] [-f [feature]] [-i feature] [-s [server]] \ [-t value] [-c license_file] [-A] where -a displays all information about all features. -A lists all active licenses. -c license_file specifies license file to operate on. -f feature_name lists the users of the specified feature. -i feature_name prints information about the named feature, or all features if no feature name is given.
License Management with FLEXlm and COBOL FLEXlm Utilities Using lmver This utility reports the FLEXlm version of a library or binary file. Its usage is: lmver [filename] where -filename is the name of a program or library. For example, to determine the version of FLEXlm used by COBOL, type: $ lmver $COBDIR/coblib/libcobol.sl You can use the following command to get the FLEXlm version of a binary: $ strings file | grep Copy If you omit the argument, lmver tries to find the FLEXlm library liblmgr.
License Management with FLEXlm and COBOL FLEXlm Directory Structure FLEXlm Directory Structure The script hpmfocdsini installs the FLEXlm components in and below the directory flexlm, which is installed by default in /usr/local. If you specified an alternate location to hpmfocdsini, substitute that path for /usr/local in the following lists: /usr/local/flexlm/bin/ lmcksum lmdiag lmdown lmgrd lmhostid lmremove lmreread lmstat lmswitchr lmutil lmver /usr/local/flexlm/licenses/ licenses.
License Management with FLEXlm and COBOL Troubleshooting FLEXlm Troubleshooting FLEXlm This section documents areas of FLEXlm that have given customers difficulty in the past. NOTE If you cannot find the answer to your question here, you can find additional information on configuring and administering FLEXlm GLOBEtrotter’s FLEXlm End User Manual, and their FAQ at GLOBEtrotter’s web site: http://www.globetrotter.
License Management with FLEXlm and COBOL Troubleshooting FLEXlm If you omit the argument, lmver tries to find the FLEXlm library liblmgr.a and warns you that it cannot find it. Who do I call if I need help with FLEXlm? If you have questions about FLEXlm, contact Licensing Services at: Hewlett-Packard World Wide Licensing Services California, U.S.A. Phone: 650-960-5111 fax: 650-960-5670 e-mail: hplicense@mayfield.hp.com Hours: Monday through Friday, 8am-5pm PST Grenoble, France Phone: +33.(0)4.76.14.15.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) FLEXlm Error Messages (Return Status Values) The following information on FLEXlm error messages (status return values) is from the GLOBEtrotter Software FLEXlm Reference Manual, Appendix D, "Status Return Values." It is reprinted here with permission from GLOBEtrotter Software. These error messages are also located on the HP Micro Focus Object COBOL web site: http://www.hp.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) standard file /usr/local/flexlm/licenses/license.dat,(or C:\FLEXLM\LICENSE.DAT on Windows and Windows NT) or the file specified by the vendor (via lc_set_attr()), or the file specified by the user in LM_LICENSE_FILE. -2 LM_BADFILE A A A A "invalid license file syntax" feature name is > MAX_FEATURE_LEN, daemon name is > MAX_DAEMON_LEN. server name is > MAX_SERVER_NAME.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) for all users of Micro Focus Object COBOL. -9 LM_NOTTHISHOST "invalid host" The hostid specified in the license file does not match the node on which the software is running. -10 LM_LONGGONE "feature has expired" The feature has expired, i.e., today's date is after the expiration date in the license file. -11 LM_BADDATE "invalid date format in license file" The start or expiration date in the license file is invalid.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) -16 LM_CANTREAD "cannot read data from license server" The process cannot read data from the daemon within the timeout interval. The connection was reset by the daemon (usually because the daemon exited) before the process attempted to read data. -17 LM_CANTWRITE "cannot write data to license server" The process could not write data to the daemon after the connection was established.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) -23 LM_BUSYNEWSERV server "license server temporarily busy (new connecting)", The vendor daemon is in the process of establishing a quorum condition. New requests from clients are deferred during this period. This request should be retried.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) -32 LM_NOSUCHATTR "No such attribute" A call to lc_get_attr() or lc_set_attr() specified an unknown attribute code. -33 LM_BADHANDSHAKE "Bad encryption handshake with daemon" The client performs an encryption handshake operation with the daemon prior to any licensing operations. This handshake operation failed.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) -40 LM_CANTMALLOC "Cannot allocate dynamic memory" The malloc() call failed to return sufficient memory. -41 LM_NEVERCHECKOUT "Feature was never checked out" This code is returned by lc_status() if the feature requested has never been checked out. -42 LM_BADPARAM "Invalid parameter" A call to lc_set_attr() specified an invalid value for its attribute. lc_get_attr(LM_A_MASTER,...
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) The expiration date format in FLEXlm licenses are good until the year 2027. This is probably a bogus date. -50 LM_EXPIREDKEYS "FLEXlm key data has expired" The FLEXlm Demo vendor keys have expired. Contact Globetrotter Software for new demo keys. -51 LM_NOFLEXLMINIT "FLEXlm not initialized" A FLEXlm function was called before lc_init() was called. Always call lc_init() first.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) encrypted and checksummed for security and integrity. The checksum will usually fail because of poor networking communications. -60 For internal use. -61 LM_SERVNOREADLIC "Cannot read license file from server" This occurs when the license file, via LM_LICENSE_FILE, or lc_set_attr(LM_A_LICENSE_FILE, path), is incorrectly defined. This only occurs when LM_LICENSE_FILE is set to port@host.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) On some operating systems, the end-user can significantly change the date using the TZ environment variable. This error detects this type of theft. -72 LM_OLDVENDORDATA "'Old-style' vendor keys (3-word)" V3.0 uses 4-vendor keys. This error detects that the LM_CODE macro was used with only 3 keys.
License Management with FLEXlm and COBOL FLEXlm Error Messages (Return Status Values) This is only supported with a v5.0+ client. -84 LM_USER_BASED in `Incorrect number of USERS/HOSTS INCLUDED options file -- see server log' When a feature has the USER_BASED attribute, this error occurs when there no INCLUDE line in the end-user options file for this feature, or the number of users included exceeds the number authorized. See Section 10.1.4, `FEATURE or INCREMENT Line,' on page 92, especially USER_BASED.
Documentation COBOL Information 4 Documentation COBOL Information The documents described in this section are available with HP Micro Focus Object COBOL/UX. To order sets of the printed documentation contact your Hewlett-Packard Sales Representative and request product number B5449EA. However, please note that the printed documentation set was not revised for Micro Focus version 4.1.20; only the online html files were revised.
Documentation COBOL Information Locating COBOL Information The table below summarizes where to find your COBOL information: Information $COBDIR/ docs/html/ library.htm $COBDIR/ docs Printed HP Micro Focus COBOL Website(a) HP Micro Focus Object COBOL/UX Programmer’s Guide Yes Yes Micro Focus Object COBOL v4.1.20 documentation set Yes Yes Micro Focus Object COBOL v4.1.
Documentation COBOL Information Online html Manuals Hewlett Packard now includes the Micro Focus documentation set and the Hewlett-Packard HP Micro Focus Object COBOL/UX Programmer’s Guide online in html (hyper-text markup language) format. You can view and print these manuals with any html browser, such as Netscape’s Navigator. These files are shipped with the product in a compressed format. After COBOL is installed, you can use the docstool script to uncompress and install the online manuals.
Documentation COBOL Information • Dialog System Character Tools • License Management Facility Administrator’s Guide • Master Index and Glossary Online Files in $COBDIR/docs Hewlett-Packard includes three online files along with the Micro Focus files in the $COBDIR/docs directory. hp_README This document from Hewlett-Packard contains a report of closed defects for this release. In some releases this file may be empty. hp_relnotes.txt This document is the text file of this HP release document.
Documentation COBOL Information callfh.1 This document describes the enhanced callable file handler from Micro Focus. changes.1 This document is for use when maintaining applications created using Micro Focus COBOL systems. It describes the differences that may cause problems and ways of overcoming these problems. It includes documentation of obsolete features no longer documented in the manuals but maintained for compatibility. cobsql.
Documentation COBOL Information features.1 This document summarizes new features and all Early Release features. Early Release features are normally documented in online documents and not in the printed books. fhutil.1 This document describes the File Handler utilities supplied with Micro Focus OSX to enable you to port files between Micro Focus COBOL systems for UNIX and Micro Focus COBOL systems for DOS, Windows, Windows NT, Windows 95, and OS/2 and to maintain these files after porting. readme.
Documentation Other Useful Information • anim(1) • cobrun(1) To be able to access the COBOL man pages with the man command, you must first set and export the MANPATH environment variable, even if you leave the product in the default installation location. See “Known Problems” on page 76 for more information.
Documentation Other Useful Information • How HP-UX Works: Concepts for the System Administrator • Installing and Administering NFS Services • HP-UX Symbolic Debugger User's Guide • HP/DDE Debugger Reference • HP/DDE Debugger User's Guide • HP/DDE Debugger Technical Addendum • Using the X Window System • Programming with Threads on HP-UX • Managing HP-UX Software with SD-UX Third Party Documentation OSF DCE Threads is an advanced topic and general information about threads and programming with threads can b
Known Problems, Limitations, and Fixes 5 Known Problems, Limitations, and Fixes For a list of HP Micro Focus Object COBOL/UX problems and their fixes, see the Technical Knowledge Database on the HP Electronic Support Center website: http://us-support.external.hp.com/ http://europe-support.external.hp.com/ The Technical Knowledge Database is available to customers with support contracts. Step 1. Once at the website, enter your User ID and Password, then click Okay. Step 2.
Known Problems, Limitations, and Fixes Known Problems Known Problems You Must Set COBDIR, SHLIB_PATH, and MANPATH This version of HP Micro Focus Object COBOL/UX contains a defect that requires that you set and export the environment variables COBDIR, SHLIB_PATH, and MANPATH, even if you leave the product in the default installation location (/opt/cobol/cobdir).
Known Problems, Limitations, and Fixes Limitations Limitations HP-UX Large Files are Not Supported As of HP-UX 10.20, HP-UX supports files larger than 2 gigabytes. HP-UX large files are not supported with HP Micro Focus Object COBOL/UX; however, the COBOL run-time system generates an error message (194 file size too large) if HP-UX large files are manipulated from COBOL code. If you must manipulate HP-UX large files, use C code.
Known Problems, Limitations, and Fixes Workarounds and Fixes Workarounds and Fixes +help Troubleshooting for Systems Running HP CDE The +help option to ld(1) and other compiler products may not work on systems running HP CDE. If it does not work, ensure the environment variable DTHELPSEARCHPATH is set. (It may not be set if you rlogin to a system, for example.) If it is not set, use the following command to set it: $ eval $(dtsearchpath) Ensure the LANG environment variable is set, typically LANG=C.
Known Problems, Limitations, and Fixes Closed Defects Closed Defects The following defects have been recently closed in HP Micro Focus Object COBOL/UX. You can find a detail report for these closed defects in $COBDIR/docs/hp_README.
Known Problems, Limitations, and Fixes Closed Defects Product: COBOL/HP-UX S800 Product Nuumber: 35326B ________________________________________________________________________ Number: 1653050005 document that SIGQUIT detected from COBOL spawns a subshell Signed off 07/02/98 in release B11.25 ________________________________________________________________________ Number: 1653083782 h2cpy does not translate C structures with float or double Signed off 09/10/97 in release B08.
Known Problems, Limitations, and Fixes Closed Defects MFCOBOL B.11.2x CBL_CHECK_FILE_EXIST gives incorrect file size results Signed off 09/10/97 in release B11.28 ________________________________________________________________________ Number: 1653223230 MFCOBOL B.11.2x: adiscf enable/disable fkeys “Invalid option” 5003379099 Signed off 02/11/98 in release B11.
Known Problems, Limitations, and Fixes Closed Defects B.10.xx: rts 114 occurs when EXTERNAL data items accessed, SQLPROT used Signed off 10/16/97 in release B10.42 ________________________________________________________________________ Number: 4701329854 MFCOBOL compiler loops or compiler error 301-S on INITIALIZE w qualifier Signed off 10/16/97 in release B11.
Known Problems, Limitations, and Fixes Closed Defects MFCOBOL B.10.40 slow Fileshare performance COMMIT; multiple sync calls Signed off 07/02/98 in release B11.28 ________________________________________________________________________ Number: 4701352252 ncg problem: works as GNT but not as EXE w procedure pointers Signed off 10/16/97 in release B11.28 ________________________________________________________________________ Number: 4701356006 B.11.
Known Problems, Limitations, and Fixes Closed Defects $set flag(saa) gives extraneous compiler error: 643-OSVS, Source overlap Signed off 10/16/97 in release B08.75 ________________________________________________________________________ Number: 5003198424 copy lib not found, if COBOPT, COBCPY and COPYEXT are set Signed off 10/16/97 in release B08.
Known Problems, Limitations, and Fixes Closed Defects MFCOBOL B.10.41, B.11.26, B.08.76: COMPUTE w array: wrong result gnt,exe Signed off 10/16/97 in release B10.42 ________________________________________________________________________ Number: 5003356261 Intermittent Fileshare server abort with misc return code Signed off 10/16/97 in release B10.
