Rocket® COBOL

This article explains that under certain circumstances the error 9d,104 can occur when running AcuServer. Problem: Why does an AcuServer error 9d,104 occur when running AcuServer? Resolution: An AcuServer error 9d,104 means that the client can't find the TCP/IP layer (sockets). If this happens in the middle of a run instance and during this runtime's execution the AcuServer was killed and restarted, then this error will occur. This can be fixed by using config variable C$DISCONNECT (since version 5.2.1). This issue can also occur because at some point the Linux kernel goes into a busy loop, blocking all executables from running (including the runtime and acuserver). During this looping, the AcuServer socket times out and drops the connection, causing the AcuConnect runtime to return the error to the client runtime. This is a problem with the Linux kernel, and not with the software. To resolve this, you can ignore such time lags (sometimes the runtime c

This article provides sample COBOL programs that demonstrate how threads interact with other threads by sending messages to stop processing. Problem: Heavy processing inside of an application can slow it down significantly, for example when a grid is populated by a large number of records or when many copying files. Resolution: Use the statements SEND MESSAGE, RECEIVE MESSAGE FROM THREAD, and WAIT FOR THREAD to stop processing if necessary. The attached two COBOL programs show how to use these statements in order to provide the end user the opportunity to terminate processing. Old KB# 14871

This article addresses a1004 error during Web-to-Host 5.3.1 installation on IE 5.5. Problem: Error 1004 is reported when installing Web-to-Host 5.3.1 on IE 5.5. Why is this? Resolution: This error message indicates the incompatibility with IE 5.5. The solution is to upgrade IE to at least version 6.0 ServicePack 1. Incident Number: 2281571 Old KB# 14835#Rumba#Web-to-Host#OnWeb#ProClient

This article explains why the cobrun command displays the message cobrun32: cobol version number invalid, call tech support. Problem: The command cobrun displays an error . The UNIX commands echo $COBDIR , cd $COBDIR run fine and display the directory. If the command mflicense is used to display the deployment licenses , the following message is displayed: {directory of Micro Focus product}/bin/mflicense: line 100: {directory of Micro Focus product}: is a directory What can be done to resolve this? Resolution: It is necessary to verify the value of the environment variable. These messages are displayed when this value is with a trailing space. A trailing space can be created with the following sequence: COBDIR='/opt/microfocus/cobol<space>' export COBDIR Old KB# 14887

This article explains how to resolve the Windows Installer Package Error 1721 when installing any Micro Focus product which uses the Microsoft msi installation technology. Problem: When installing a Micro Focus product which uses Microsoft’s msi installation technology you may get the following error message, particularly if you are installing an updated version of a product for which you already have installed on the machine. Error 1721. There is a problem with this Windows Installer package. A program required for this install to complete could not be run. Contact your support personnel or package vendor. Resolution: Start your computer in safe mode. To do this, follow these steps: Restart the computer. After the BIOS information is displayed, press F8. Use the DOWN ARROW key to select Safe Mode, and then press ENTER. Use the UP ARROW key and the DOWN ARROW key to select your computer, and then press ENTER. Log on to the computer as local admin

This article explains the error message Operand Time-Of-Day is not declared. Problem: During compile of a program which contains a ----move time-of-day to ws-time-of-day--- I receive the error message Operand Time-Of-Day is not declared:#compile: gen400.cbl - 760 lines 486 move time-of-day to ws-time-of-day. * 12-S******************** ( 0)** **   Operand TIME-OF-DAY is not declared Resolution: TIME-OF-DAY is a special register data item. This special register requires the compiler directive OSVS. cob -uvC OSVS pgm.cbl Incident Number: 2352310 Old KB# 14859

This article explains how to use Level 49 Unicode host variables and parameters. Problem: Using a relational database within Microsoft SQL SERVER 2008 where table columns are defined as NVARCHAR. In order to read and to update these columns it should be possible to define and to use these columns as well. How can SQL datatype NVARCHAR be used? Resolution: Net Express 5.1 WebSync4: Beginning with that WebSync4 it is now possible to define and to use those host variables correctly as the following: 01 NVARCHARFIELD. 49 NVARCHARFIELD-L PIC S9(4) COMP-5. 49 NVARCHARFIELD-V PIC N(100) USAGE NATIONAL. Use Level 49 for VARCHARs By default, OpenESQL Assistant generates a host variable as a PIC X(n) field for VARCHAR columns. When data is mapped to the host variable, it is null terminated. However, you can set OpenESQL Assistant to generate the host variable with two level-49 variables; one for the length of the data mapped and one for the actual text data. To enable Le

This article explains why COBOL compiler returns 8-S Unknown COPY file <file name> specified. Problem: When compiling a COBOL program that contains copybooks that is greater than 256MB, the compiler returns the following error even though the copybook exists and is case sensitive: *    2  copy "<copybook name". *   8-S**************************  (0)** **    Unknown COPY file <copybook> specified Resolution: The reason this is happening is because the total limit for a COBOL program data division is 256MB. The compiler would only have opened the file and read the first x number of bytes. A too large data division would get a clear message indicating that fact. The file is so large the CBL_OPEN_FILE or CBL_READ_FILE has failed and returned a non-zero file status, hence the error. Old KB# 14889

This article explains how to resolve an Index File Recovery Utility 24,02 COBOL I/O Error. Problem: When using the RM/COBOL Index File Recovery Utility with a large file, it can fail with a COBOL I/O Error 24,02. This error indicates that there is not enough room left to write to the file. How is this resolved? Resolution: This error is caused by the fact that the Index File Recovery Utility opens index files in binary sequential mode. Therefore, in order to resolve this issue, you will need to create a configuration file that enables the use of large sequential files (over 2 GB). The steps to create the configuration file are as follows: Create a text file named runcobol.cfg in the same directory as the Runtime executable (runcobol). Add the following configuration record: RUN-SEQ-FILES USE-LARGE-FILE-LOCK-LIMIT=YES Save the file. The configuration file will be loaded automatically and will allow you to successfully recover your index file. Inc

This article explains an undefined terminal 191 error when running a job in the background. Problem: When running a job in the background we receive the error 191 (Terminal Type Not Defined) returned. Why is this? Resolution: On UNIX when running a job in the background there isn’t a terminal present, so you cannot executes any COBOL DISPLAY statements. If the COBOL program does not contain any DISPLAY statements then remove the CONSOLE IS CRT statement from the ENVIRONMENT DIVISION. The CRT clause causes the runtime to attempt to initialization a terminal. Old KB# 14837

This article explains how to resolve an installation failure that is the result of an error from SetMFFM. Problem: The Relativity Data Manager and Data Server installer can fail with the following message: Operating System Error 0x2 (The system cannot find the file specified.): SetMFFM failed. This error will cause the installer to terminate. It is the result of the installer examining the registry and finding a Micro Focus Net Express entry. The installer will then attempt to verify that the registry entry for the Micro Focus file manager is correct by locating the physical file that is referenced. This verification is performed so that the installer can "pre-check" the Micro Focus file manager check box during the install. Resolution: To resolve this issue, you will need to temporarily remove the Micro Focus registry entries during the Relativity installation. Below are the steps to this procedure: Start the Windows Registry utility (regedit.exe)

This article explains the difference between file status 37 and 9/37. Problem: File status 37 is "An OPEN operation has been tried on a file which does not support the open mode specified in the OPEN statement." File status 9/37 is RTS error 37, "File Access Denied". How do you distinguish between the two? Resolution: File status 37 consists of the characters "3" and "7" (hexadecimal 3937). File status 9/37 is the characters "9" and "7" (hexadecimal 3937). Note: There is no file status "97" with which to confuse the latter. File status 37 is usually a programming error, such as OPEN EXTEND of an indexed file. File status 9/37 is usually a run-time error caused by a conflict between file and/or directory permissions and user access rights. Old KB# 14888

This article explains how to configure the location where target build files are created. Problem: By default when you build a project the int/gnt/exe/dll target files are created in the debug or release folders in the project directory. Is it possible to override this option? Resolution: This is configurable in the Build Types. On the main Net Express menu you use the Project / Types of build menu option. This allows you to override the directory specified. Incident Number: 2422601 Old KB# 14829

This article explains the return code from the runtime system for abnormal terminations. Problem: A COBOL program can end "returning numeric-value" which will put a value in the return-code special register, but the COBOL runtime system can terminate abnormally before the program ends and this statement will never be executed. For example, a run time error 114 (memory bounds error) or 173 (called program not found) will cause abnormal termination of the runtime system. What return code one will one see via "echo $?" thereafter? Resolution: If the COBOL runtime system terminates due to an error, for example, program not found, RTS 114, etc., the return code is always 255. If the runtime system terminates because the program terminates ("stop run" or top-level "goback"), the value of the return-code special register is returned. The return code can be tested in a script or from the command line with the echo command. The variable

This article explains the error 000000 000: Illegal command line when attempting to compile in Net Express 6.0. Problem: Having installed Studio Enterprise Edition 6.0 and then activated it with a stand-alone time-limited license with your 16-digit Authorization Code you may encountered error message ‘000000   000: Illegal command line’ when attempting to compile any program in Net Express 6.0.This problem is caused by an error in populating the lservrc.stn file which is found here: C:\\Program Data\\Micro Focus (on Vista/Windows Server 2008) C:\\Documents and Settings\\All Users\\Application Data\\Micro Focus (on XP). When inserting the Authorization Code into the appropriate field in the Studio Enterprise Edition 6.0 product, a hand-shaking process takes place between the client machine and Micro Focus’ license server machine. If all is well, the license server machine issues the client machine a license via the Internet in the form of a license string which is compose

This article explains that Net Express 5.1 WS4 for Windows 7 or Server 2008 R2 requires installation of a new cut of the base Net Express 5.1 product before being applied. Problem: Net Express 5.1 has been retooled to support Windows 7 and Server 2008 R2. How does this work? Resolution: To use Net Express 5.1 WS4 on Windows 7 or Server 2008 R2, a re-cut base 5.1, or 5.1 WS1 product must be installed before applying the Websync. To use Server 5.1 WS4 on Windows 7 or Server 2008 R2, the re-cut Server 5.1 GA must be installed before applying the Websync. Once any existing 5.1 product installation has been removed, and the re-cut product installed, WS4 can be applied. Net Express 5.1 GA and Server 5.1 GA can be ordered from your Sales representative. Net Express 5.1 WS1 can be downloaded from the SupportLine website. Old KB# 14830

This article describes which processors are supported for native code Problem: Not all processors are supported for native code. To increase the performance it can be necessary under certain circumstances to determine which processor will be supported and how the code can be implemented. Resolution: ACUCOBOL-GT supports several options that cause it to generate and execute object files that contain native instructions for select families of processors. These options may not be combined with other options into a single option. For example, it is an error to specify "-nv"; you must specify "-n -v" instead. The compiler uses cblutil to produce the native-code object file. cblutil is installed in the same directory as the compiler by default. The compiler searches the execution path if it cannot find cblutil in its own directory. You run a native-code object module just like a portable-code object module. You may mix native-code obje

This article provides CBL_OPEN_FILE Documentation clarification. Problem: When opening a file that is, or will, be greater than 4GB using CBL_OPEN_FILE, a file status 181 is returned: Invalid Parameter Error Why is this? Resolution: CBL_OPEN_FILE is used to open an existing file for byte stream operating. When using CBL_OPEN_FILE one of the parameters the routine requires is “access-mode”. The documentation shows the following valid modes: 1. Read only 2. Write only (deny-mode must be 0) 3. Read/write 64  Read/write files greater than 4GB Deny-modes are as follows: 0 Deny both read and write (exclusive) 1 Deny write 2 Deny read 3 Deny neither read nor write Device is reserved for future use (must be zero). When opening a file that is greater than 4GB it looks as if the “access-mode” should be “64”. In actuality you must also pass value 1, 2, or 3 along with the 64. The call to CBL_OPEN_FILE would look

This article explains why the Net Express Startup screen appears, but the IDE will not load. Problem: Net Express attempts to load the last project on startup but for some reason the IDE won't load. Does this mean it is corrupt? Resolution: It may mean the IDE is corrupt, therefore try the following: Open a Net Express Command Prompt. Go to Start > Programs > Micro Focus Net Express 5.0 > Net Express Command Prompt. At the command line enter: mfnetx /n. If this works, you probably have a corrupt project (.APP) file. If the project is corrupt, you will need to recreate your project from scratch. You may want to turn off the feature Reload files and last project on startup by performing the following: Start > Programs > Net Express > Command Prompt. Enter MFNETX /N(no project) which will bring up the Net Express IDE. Select Options > Customize IDE. Select Workspace. Disable Reload Files and Last Project on S

This articles explains how to ensure a Server Express deployment and development environment is licensed properly and ready for use on HP/UX systems. Problem: In Server Express deployment and development licensing is enforced. How can you ensure that the deployment / runtime environment is licensed properly and ready for use? How can you ensure that the development environment is licensed properly and ready for use? Resolution: To ensure the Server Express deployment and development environment is licensed properly and ready for use, you can run the command Apptrack to check deployment license usage. The attached MFLicenseCheck tool will find and report the number and types of installed deployment licenses. It will also analyze deployment license usage for only Server for COBOL/Application Server. It will also report deployment license usage, generated when development licenses are installed. The attached file is for the HP/UX operating system only. To use this

This article explains why the utility cobprof used to generate a PROFILE report might generate a value of 0 milliseconds for some paragraphs that have been executed. Problem: Why in the report generated by cobprof do some paragraphs show an execution time of 0 if they have been executed once? Resolution: In the provided example, the execution of all paragraphs but the first two have taken a lot less than 1 millisecond, and for that reason the result is 0. There are two main goals when using PROFILE: To make sure that our tests have executed all the coded paragraphs so we don’t leave part of the code untested. It is for this reason that the results show the accumulated values of all executions (delete the .ipf file to start from 0). To pinpoint those paragraphs that take most of the execution time so we know where all our optimization efforts should go. In the example, more than 83% of the time goes to 00-CONNECT, so that is the paragraph we should

This article explains how you can delete pages from the command line. Problem: From the command line, how can you delete one or more pages from an EnterpriseLink Repository? Resolution: In the same directory, you need to create two files on Windows, using the file names and contents from the attached document (attached to this article). Note that the value for ELINSTALL should be replaced with your EnterpriseLink installation directory. Old KB# 14629#Rumba#EnterpriseLink

This article explains how to create a application with an Acu COBOL module and a Micro Focus COBOL module. Problem: We would like to use an Acu module and a Micro Focus module in the same application. How is this done? Resolution: The document attached to this article explains how to create an application with an ACUCORP module and a Micro Focus module. Prerequisites : AcuCobol-GT version 8 with shared libraries for UNIX Platforms. Server Express version 5.0 or earlier. Old KB# 14628

This article addresses why the Close browser after session starts option no longer appears in the host wizard for Pro sessions, as it did in previous versions of Web-to-Host. Problem: In the Web-to-Host 5.2 Host wizard, there is an option to run a session in a separate browser window. This option would cause the session to load in its own browser window, while hiding the browser’s tool bar, menu bar, address bar, etc. This option had three sub-options, including Close browser after session starts. With this sub-option selected, the original browser window that was used to navigate to the Web-to-Host session would be automatically closed after the session started, leaving only the stand-alone session window. This is how the option appeared in the version 5.2 Host Wizard: This option no longer exists in Web-to-Host 5.3.2: Resolution: The same functionality can be achieved by selecting the Client Options 2 tab, and checking Start Zoomed: The result will be the same as with the pre

This article provides examples on how to handle SOAP Exceptions in Web Services Client consuming Web Service deployed on Enterprise Server. Problem: It can be quite interesting to catch SOAP Exceptions and get more details about this SOAP Exception when it occurs. How is this done? Resolution: The attached sample and .zip file explain how to proceed. The sample attached will only work with a service generated by Net Express 5.1 WebSync3 or higher (Net Express 6.0). The .ZIP file attached contains: A Net Express Project that contains a sample legacy code named LEGACY from which a service of type Web Service was created with Interface Mapping toolkit (IMTK). Attachments NET-51-20090918.zip Old KB# 14624