Rocket® COBOL

This article explains why the RTS 173 error on 'cdi2' ocurrs when trying to run cobprof. Problem: In Server Express v5.0, you might get the following error when trying to run the Profiler (cobprof): Load error : file 'cdi2' error code: 173, pc=0, call=1, seg=0 173 Called program file not found in drive/directory Resolution: This is a known issue and is fixed in Server Express v5.0 Websync 4 (WS04) Old KB# 14004

This article explains how to remove a license from the Server Express development license database. Problem: How do you remove a license key from the Server Express development license database (LMF)? Resolution: To uninstall a Server Express development license, follow these steps: Change directory to the /opt/microfocus/mflmf directory. Note: Your mflmf may be in a different path Use the command ./mflmadm to start the License Management utility. Enter /2 to bring up the license entry screen. Put the serial number on the first line up to and including the "AI " Tab to the next line and enter the full license key. Note: The fields are not case sensitive and you may enter the spaces or not as you choose. Press /4 to un-install the license. Press /7 to refresh the license database. Press Esc then "y" to exit. Old KB# 14025#ServerExpress#COBOL#Licensing

This article explains a resolution to an error during a sort operation. Problem: We are receiving an error with an application's internal SORT failing during execution. The error message is: Execution error : file 'extsm' error code: 114, pc=0, call=1, seg=0 114 Attempt to access item beyond bounds of memory (Signal 11) The COBOL syntax was SORT sort-file-name, USING data-file-name GIVING data-file-name. Resolution: In reviewing the application source code's SORT statement, there is a size difference between the USER-SORT-FILE and those of MY-FILEs. SORT USER-SORT-FILE ASCENDING KEY........ USING MY-FILE-IN, GIVING MY-FILE-OUT. The difference is that USER-SORT-FILE is 101 bytes and MY-FILEs are 105 bytes. This size difference is being trapped at runtime as the USING MY-FILE-IN is opened and it's data passed to the SORT record. This size difference causes an out-of-bounds error, a 114 abend, as it attempts to move it into the SORT record buffer. Acc

This article explains what to do if the message "The license key entered is not valid" occurs when installing a license key using mflmcmd. Problem: When trying to install a license key using mflmcmd, we received the error message "The license key entered is not valid" even though the final two characters with the plus sign were successfully entered (in this case, the "AI "), and even though the serial number and license key were valid. Why is this? Resolution: This error is caused by running ./lmfdbrecover from within $COBDIR/lmf and then starting the License Manager with ./mflmman within $COBDIR/lmf. Subsequently, ./mflmcmd will not accept licenses. The lmf subdirectory of COBDIR is not meant to be an official location for the License Manager. It exists only as a set of files, like a template, to be copied to an official location. The script lmfinstall in $COBDIR/lmf is supposed to perform these copies. You could get into trouble when trying to use $COBDIR/lmf a

This article explains a simplified test case resulting in the 154 PERFORM nested too deeply error message. Problem: We received the following error when the program was compiled to .gnt or .so or .exe (not .int), and then only when the PROFILE compiler directive was used. Execution error : file 'b' error code: 154, pc=0, call=1, seg=0 154 PERFORM nested too deeply Following is a simplified test case: 000001 WORKING-STORAGE SECTION. 000002 01 WS98-COUNT PIC S9(4) COMP VALUE 0 SYNC. 000003 000004 PROCEDURE DIVISION. 000005 A-MAIN SECTION. 000006 A-00. 000007 PERFORM B-HANDLE-INSERT-MODE. 000008 PERFORM Z-FINISH. 000009 000010 B-HANDLE-INSERT-MODE SECTION. 000011 PERFORM 500 TIMES 000012 PERFORM F-GET-NEXT-ACCOUNT 000013 END-PERFORM. 000014 DISPLAY "F-EXIT 1 -- " WS98-COUNT. 000015 display " End 1st Loop ". 000016 PERFORM 500 TIMES 000017 PERFORM F-GET-NEXT-ACCOUNT 000018 E

This article provides a possible solution if an error is received when running aslmfinstall from $COBDIR/aslmf. Problem: When trying to run aslmfinstall from $COBDIR/aslmf the following error messages were received: Installing AppTrack... exec(): 0509-036 Cannot load program ./aslmf/init2aslm because of the following errors:         0509-150 Dependent module libcobrts.2.so could not be loaded.         0509-022 Cannot load module libcobrts.2.so.         0509-026 System error: A file or directory in the path name does not exist. Apptrack installation complete Resolution: A suggestion may be to ensure the LIBPATH is set, as one user on AIX 5.3 kept getting this error because he was running as root. Although COBDIR was set (you must run the script from the $COBDIR directory) he had not set the LIBPATH. Once LIBPATH was set to $COBDIR/lib the

This article briefly explains that 9/199 File Status Error means that the runtime system does not understand a status coming in from the operating system. Problem: 9/199 file status or RTS 199 A system call has returned an unexpected errno which is not expected. 9/199 errors are generated when a file handling call fails and the operating system returns an error that does not get translated to a file status value, as it is expected. How can the error number be determined and what does the error indicate? Resolution: Micro Focus COBOL file handle will handle expected values for errnos. The list of errnos is located in /usr/include/sys/errno.h. or /usr/include/errno.h depending on the platform. Errno.h is a table of error numbers and their meaning. Animator can be used to determine what statement is causing the error. File Status Error 9/199 is a legitimate error. It means

This article explains how to keep AppTrack from continually asking for a password. Problem: When running AppTrack for the first time, a password wasI established. Subsequently, AppTrack is asking for the password every time it is used. How can this be avoided? Resolution: With Server Express version 4.0 or higher, you can remove AppTrack and do a fresh install of the AppTrack system and the Application Server licenses. Before beginning, you should have your Application Server licenses available (both the serial numbers and the license keys) because you will need to re-enter them. This procedure can be completed easily within a few minutes. Log in as root. Set the COBDIR environment variable to the location where the COBOL product is installed, and make sure it is exported. Change directories to $COBDIR/aslmf: cd $COBDIR/aslmf Run the script "aslmdbrecover": ./aslmdbrecover At the end of this script, you will be taken into the AppTra

This article describes terminal emulation issues while editing a screenset created with the dialog systems utility (ds). Problem: While editing a screenset created with the dialog systems utility (ds), it failed with error 114 on file 'SSP'. Is the screenset itself corrupted, or there something else going on? Resolution: The problem is most likely caused by terminal emulation issues. The ds utility uses the ADIS module and full screen formatting. It depends on the TERM environment variable being set to a terminfo entry that matches the characteristics of the terminal emulator being used and contains correct entries describing the terminal capabilities. Check to see if TERM is set to "xterm" and if there is a version of "Putty" running as the emulator. The actual "xterm" terminfo entry does not contain sufficient or accurate capability descriptions to match the version of Putty. This can be resolved by using the PowerTerm emul

This article explains how to identify a problem statement in a program. Problem: When running a production program the following error occurs: execution error : file '/home/prd/bin/appgm.int' error code: 163, pc=328c, call=1, seg=0 163 Illegal character in numeric field Is there a way to identify the problem statement in the program? Resolution: To find the area in the program where the error is occurring make sure that the program has a corresponding .idy file. The .idy is produced at compile time when the -a flag is used for .int's or -g for all other formats (for example, .gnt, .o, -so, executable). To create a listing with a cross-reference showing the offsets run the cobfflst command for the COBOL program involved. To get this output go to the directory containing the .idy file for the program and run the cobfflst command. Syntax: cobfflst <infile>[.int] [<listfile>] For example if the program getting the error is test163.c

This article explains how to redirect STDOUT and STDERR to the same LOG file when executing an application. Problem: How do you redirect STDOUT and STDERR to the same LOG file when executing an application? In this sample program, it writes on the STDOUT the display statements and it generates an error because of a not found program. What can be done to avoid this? PROCEDURE DIVISION. perform 2 times display "To Stdout" end-perform *> msg to STDOUT call "DOERROR" *> msg to STDERR Resolution: To redirect STDOUT and STDERR to the same LOG file, use the following: On UNIX: cobrun programname >ABC.log 2>>ABC.log OR programname >ABC.log 2>>ABC.log if linked program On Windows: set COBSW= S run programname >ABC.log 2>>&1 OR programname >ABC.log 2>>

This article explains why the rebuild command is generating a 191 Terminal type not defined error. Problem: The rebuild command in Server Express is a tool that can validate, recover, or convert data files. For a quick start using rebuild, enter rebuild on the command line, with no parameters. It will display a usage screen that summarizes the options. However when we did this, the following error occured: Execution error : file 'ADIS' error code: 191, pc=0, call=1, seg=0 191 Terminal type not defined Why is this? Resolution: Rebuild uses the ADIS module for screen I/O. ADIS requires that the TERM environment variable be set to a valid terminfo entry. The solution is to set (and export) the TERM environment variable to a value such as "vt100" or "ansi" or "vt220" or "xterm", or to a value that best represents the terminal emulation of the terminal window currently in use. If you are

This article explains why, on HP/UX when trying to compile an application, the following error appears: # cob64 myapp.cbl. Problem: An RTS 115 error is returned against odbcecm when compiling an OpenESQL application on HP/UX: # cob64 myapp.cbl Server Express Embedded HTML Preprocessor Version 4.492 Copyright (C) 1984-2006 Micro Focus (IP) Ltd. All rights reserved aCC runtime: Use of "-mt" must be consistent during both compilation and linking. Execution error : file 'odbcecm' error code: 115, pc=0, call=1, seg=0 115 Unexpected signal (Signal 6) cob64: error(s) in compilation: myapp.cbl Resolution: This is an Operating System issue, which can be resolved by installing a patch to the C run-time (PHSS_34041, or the latest recommended patch which supercedes PHSS_34041). Old KB# 14017

This article aims to aid in the improvement of performance when accessing indexed files. Problem: This purpose of the configuration option INDEXCOUNT is to aid in the improvement of performance when accessing indexed files. Resolution: The default value for INDEXCOUNT should be suitable for most files. However, for files where the depth of the tree is greater than 4 or where there are a number of alternate keys defined for the file, increasing INDEXCOUNT can dramatically improve performance. The information required to make this calculation can be gained by using the rebuild tool to validate the file (rebuild -f filename). A general guide to setting INDEXCOUNT is as follows: INDEXCOUNT = (Tree Depth * No Keys) No Keys This parameter is put in the External File Handler configuration file pointed to by the EXTFH environment variable. See the File Handler documentation for specific instructions for using the Externa

This article explains the various reasons why an RTS 115 Unexpected Signal (Signal n) might be generated. Problem: If the runtime system is not expecting the signal at this time, or never expects to catch the signal, then the default runtime system signal handler will produce the runtime error message (where n is the signal number): Execution error : file 'name' error code: 115, pc=p, call=c, seg=s 115 Unexpected Signal (Signal n) Resolution: The COBOL Runtime System posts signals handlers for various signals, including all signals whose Operating System default action is to cause the process to terminate. This allows us to clean up before the process terminates and allows us to achieve other COBOL functionality. When a signal is generated, it is processed using the list of prioritized posted signal handlers. If the Operating System default action is to cause the process to exit, t

This article explains that an OBECT REFERENCE defined in working storage that is used by more than one thread, or passed between threads may cause this error. Problem: We are running an application with COBOL and JAVA and after a period of time the following runtime exception occurs: [java] Exception 24 not trapped [java] the class nilobject (object reference: 00000003) Does not understand: close Hit T to terminate program. Hit any other key to continue. This error happens as a threaded application. If it is run as a single thread, the error does not happen. Resolution: The most likely cause of the problem is an OBECT REFERENCE defined in working storage that is used by more than one thread, or passed between threads. If one thread finalizes the object and another thread then attempts to invoke a method on it, such as 'close' you will see the error that was enco

This article explains what to do if an incompatible version of the system assembler is invoked. Problem: We are receiving a 114 error when running an executable build using the cob command. A truss trace of executable shows the error Incurred fault #6 FLTBOUNDS and the failing executable is a custom created version of the run time system: cob -e "" -x -o ./myrts This error occurs because an incompatible version of the the system assembler is being invoked. To ensure that the correct version of the 'as' command is being used, look at the file $COBDIR/docs/env.txt. In this file the expected assembler version is specified along with the command that can be used to get the version information. Compare the assembler version information on the failing system with the version identified in $COBDIR/docs/env.txt. In some cases there is more than one 'as' command on your system, therefore it is important to place the directory name for t

This article explains how a Net Express revoke key is generated to deactivate the product. Problem: How is a Net Express revoke key generated in order to deactivate the product? Resolution: From the Windows Start menu, click ALL Programs > Micro Focus Net Express > Configuration > License Management System. The License Management System Configuration window should appear. Check your product and its components. Click Revoke license. Using the generated license key, go to the Licensing Solution web pages at http://supportline.microfocus.com/licensing/LicensingHome.asp to generate your own product revoke/deactivation key.Old KB# 13967#COBOL#netexpress#Licensing

This article explains what is involved in transferring an Application Server license from one computer to another. Problem: What is involved in transferring an Application Server license from one computer to another? Resolution: Transferring an Application Server license from one computer to another depends on the setup access to runtime and\\or licenses. If the license database is installed on a server, you need to point a client to it, setting ASLMFNET=\\\\server\\sharename pointing to the server where the license resides. If the runtime and license is installed directly on a users machine, then it must be uninstalled from the old machine and reinstalled on the new machine before running APPTRACK to install the license number. However, if you are running static EXEs and just need the license on a client machine, simply create a directory and put the following files in it (these can be copied from the Application Server CD): prodfile semfile apptra

This article explains how a Net Express reset key is generated to reactivate the product after a problem. Problem: How can a  Net Express reset key generated to reactivate the product after a problem? Resolution: Within a DOS command window, navigate to the product's \\base\\bin directory. Enter the command PROTCFG /FORCE_RESET. The License Management System Configuration window appears. In the License Management System window, click the appropriate check box to select your product and components. Click REQUEST RESET License. Using the generated license key, go to the Licensing Solution web pages at http://supportline.microfocus.com/licensing/LicensingHome.asp to generate your own product reactivation key. This will provide the ability to reset the product license within 30 days. Use the response key generated from the License Solution web pages to activate the product. Reactivate the product. Old KB# 13968#Licensing#netexpre

This article explains why the error 912-s dictionary invalid may occur when compiling a COBOL program. Problem: We are receiving the error 912-s dictionary invalid when compiling a COBOL program. Why is this? Resolution: This error indicates a fault in the compiler, so first try the latest WebSync. If this does not resolve the problem, then please contact Micro Focus technical support. Old KB# 13959

This article addresses whether there is any effect on a Net Express license after renaming a server post-migration from Windows 2000 to 2003. Problem: We are migrating from Windows 2000 to a Windows 2003 server, and want to know if CLU09ALL is applied, will renaming the server cause the license to be corrupted when it is in evaluation mode or full license mode? Resolution: For development products released before 2006 you need to have CLU09ALL applied before renaming machine. For development products using Microsoft Install shield no updates are required. Old KB# 13960

This article explains how to resolve the error message "Unable to add licenses to the security key" in License Server 4.0. Problem: When inserting a Response key into the License Server, we received the error message "Unable to add licenses to the security key". How is this resolved? Resolution: A possible reason for this error is that the IUSER_servername (where servername is the actual name of the machine) entry in the server Admin group is not set to Power User (or even better, Administrator).  This is required because Microsoft IIS needs to have at least Power User privileges to be able to add its entries to the registry since Microsoft has tightened up on the registry access in Windows. The steps below should resolve the matter: Log on with full administrator privileges. Go to Control panel. Double click the administrative tools icon. Double click the computer management icon. Expand the "Local users and groups" entry. Expand the us

This article explains what to do if the message "Unable to connect to License Manager" occurs. Problem: When running APPTRACK we encountered the error "Unable to connect to License Manager". Does this type of error only occur in the Windows runtime product server for COBOL version 5.0 WrapPack 5 onwards? Resolution: License Manager runs as a Windows Service. First, check that the Micro Focus License Manager has been started. Run the services menu (services.msc) or access it via the control panel.  Search for Micro Focus License Manager. If it is present, hit the Start option. If not present, from a DOS prompt, enter the command mflmwin -i which will install the service and should also start it. If it doesn't start automatically, then start it using the Services menu. Old KB# 13972#Licensing#netexpress#COBOL

This article explains how to generate a Net Express product activation key required by the licensing management system for a full license. Problem: You need a product activation key to activate a full license for Net Express. Resolution: From the Windows Start menu, click Programs > Net Express > Configuration > License Management System. Check Net Express and the components you want to activate. Click Generate Full License. Start a browser and go to the Micro Focus Licensing home page at http://supportline.microfocus.com/licensing/LicensingHome.asp. Generate the activation key. Use the generated key to activate Net Express. Old KB# 13966#netexpress#COBOL#Licensing