Rocket® Enterprise Suite

Created On:  13 April 2011 Problem: Some standard queries within Clipper, or newly written queries, can be very useful to complete analysis within the Executive / Portability Assessment Reports.  It is easy to create new queries or run standard queries interactively, but how can these queries be added to the Executive / Portability Assessment Reports, without the need for Development intervention? Resolution: When writing queries within the Modernization Workbench tool, a file called HCSearch.xml, is updated with the query details.  If any queries are written outide of the tool, they must be "imported" into the tool from the Interactive Analysis dialogue, so that the HCSearch.xml file is updated correctly, and then run interactively to validate the results are correct. For this article, the standard query - Data Queries/Computational Data -  is to be included in the Portability Assessment part of the Executive Report.  To do this....1. In the MW-install

Created On:  15 April 2011 Problem: When configuring Enterprise View, you need to identify the location of the workspace (.rwp) file you want to access in the Enterprise View Setup page. Security settings in the Web browser may result in receiving the “.rwp not found” error messages when you attempt to specify the location of the .rwp file.Why is this “workspace not found” error displayed when configuring Enterprise View? Resolution: Using Internet Explorer 8...Internet Explorer 8 displays the message “.rwp not found” when the option "Include local directory path when uploading files to a server" is disabled.Enable the option for each required zone in Tools > Internet Options > Security > Custom level.Using Firefox 3 or Higher...Firefox 3 or higher displays the message “.rwp not found” when an attempt is made to specify the location of the .rwp file. If you are using Apache Tomcat as the application server for EV, work around this problem by edi

Created On:  15 April 2011 Problem: When using Studio Enterprise Edition 6.0 to create a native Mainframe Subsystem project that uses the DB2 directive the following error occurs:  * Compiling C:\\BankDemoDB2\\CBL\\BBANK10P.CBL * Generating obj\\x86\\Debug\\BBANK10P * Data:           0     Code:        6896     Literals:        1656    Creating library obj\\x86\\Debug\\BBANK10P.lib and object obj\\x86\\Debug\\BBANK10P.exp BBANK10P.obj : error LNK2001: unresolved external symbol _SQLGSTRT@12 BBANK10P.obj : error LNK2001: unresolved external symbol _SQLGALOC@16 BBANK10P.obj : error LNK2001: unresolved external symbol _SQLGSTLV@28 BBANK10P.obj : error LNK2001: unresolved external symbol _SQLGCALL@20 BBANK10P.obj : error LNK2001: unresolved external symbol _SQLGSTOP@4 obj\\x86\\Debug\\BBANK10P.dll : fatal

Created On:  11 April 2011 Problem: A Mainframe Express Enterprise Edition 3.1 customer wants to use the "Force Program PHASEIN" option on the  "Developer" tab of "SIT properties".  This should reload programs each time they are called.  However the option seems to be ignored and the Old version of the program is always used. Resolution: This can occur if the programs have been marked RESIDENT or have been loaded with the HOLD attribute.A program can be marked as held when it is loaded by "EXEC CICS LOAD PROGRAM" with "HOLD" optionA program can be marked RESIDENT in the PPT. (on the Advance Tab of the PPT Properties.)Ensure that these options are not set and retry the program. Incident #2498988 Old KB# 33877#MFDS#EnterpriseDeveloper

Created On:  08 April 2011 Problem: I need to change the terminal Emulation from 3270 Model 2  to 3270 Model 5 for my IMS project.  How is this done? Resolution: Make sure that your Terminal Emulator default is for 3270 Model 5.In MFE 3.1 on the IMS tab within the MFE 3.1 project, RIGHT Click on IMS SYSTEM and select properties, select the TM/MFS more tab.Under TN3270 Terminal Emulation tick the 'Enable for MFS Screen Output' and then change the Port Number to the listner port that your Terminal Emulator is using.Then click OK. Incident #2511284 Old KB# 33875#3270Model5IMS#EnterpriseDeveloper#MFDS

Created On:  06 April 2011 Problem: Is it possible to create a Read-Only user in ESMAC?  Is this possible using MF internal security to have a user ID with just read-only access to viewing Resources, SEP's, and clients? Resolution: Unfortunately the default MF internal security is not intended to provide this level of granularity. However, this could be accomplished by moving user definitions and resource controls to an LDAP repository such as Microsoft's Active Directory (AD) or Active Directory Application Mode (ADAM).The section of the documentation titled "Initial Setup of Enterprise Server Security with Microsoft Active Directory" is a good starting point if you wish to make the transition. Incident #2481159 Old KB# 33856#MFDS#EnterpriseDeveloper

Created On:  30 March 2011 Problem: Job appears to complete successfully, but JES is reporting CC = 12. Resolution: This condition code occurs with a program that does not have any embedded SQL is compiled with COBSQL directives and INITCALL to SQL modules. To resolve the issue, you may recompile the program that does not any embedded SQL without COBSQL directives and INITCALL to SQL modules. Incident #2457042 Old KB# 33811#EnterpriseServer#Enterprise#Server#netexpress#COBOL#StudioEnterpriseEdition

Created On:  05 April 2011 Problem: What are the functional differences between Enterprise View 2.1.3 and Enterprise View 3.2? Resolution: The differences are that in Enterprise View 3.2 are as follows:1. There is only one workspace.  Only one workspace can be used with Enterprise View at a time.2. Roles do not restrict features, they only determine the starting dash-board for the user.3. Previous survey responses are not shown and cannot be re-used when responding to a survey.4. Websphere is not supported as a web server.5. Charts cannot show metrics for one object with dynamic drill-down in dash-boards.6. Charts that show objects cannot be filtered by tag.7. Only charts showing object types can have a filter on object type opposing to all charts in EVE8. Various chart options are not available...    - Ability to set color of bars according to value ranges    - Add notes to an area of any chart    - Change the colors on the

Created On:  30 March 2011 Problem: Deleting alternate index (.AIX) or path (.PATH) from ESMAC also deletes the base file. Shouldn't this only delete the alternate index or path, and not the base file? Resolution: On the mainframe, the VSAM files are organized in a way that each alternate index entry (i.e. AIX, PATH, etc.) is associated with its own file while on Micro Focus Enterprise Server, all these alternate index entries are by design pointing to the same file, which is the base. For this reason, it is not recommended to use the Catalog View to delete these entries. You should use instead a JCL to delete them, which will not cause to delete the base's physical file. Incident #2487359 Old KB# 33804#Enterprise#COBOL#StudioEnterpriseEdition#Server#EnterpriseServer#netexpress

Created On:  30 March 2011 Problem: When using Fileshare as a Windows service on recent Windows operating systems, you will encounter a situation where clients cannot connect to servers that are started as services. This is because of enhanced system security that has been implemented by Microsoft and that prevents individual users of a system gaining access to shared memory segments that have been allocated by other users applications. Resolution: System services are usually started by the system ID, not by a user ID. The security measure is intended to prevent accidental data loss, which is why CCI complies with the system default behaviour. However if you wish to specifically allow cross-user connections, you will need to enable the following option in your CCI.INI configuration file:  [ccismem-base] use_global_namespace=yes  This must be present in the configuration of both Fileshare Server and Fileshare Client. Unless the user wishes to protect against accide

Created On:  31 March 2010 Problem: When attempting to invoke the "cobjrun" command, the following error message appears:cobjrun: Failed to locate an appropriate executable for tool 'cobjrun' Resolution: The problem could be that COBOL has not yet been set up to work with Java on the machine.  Two things must be done:1) run java_setup2) run cobsjeThe java_setup script is usually executed during installation.  That is, when the main Server Express install script runs, it invokes $COBDIR/bin/java_setup.  But if the person performing the installation decides to opt out of setting up Java, the screen shows: Should you want to use Java with COBOL later on,as super user run the command $COBDIR/bin/java_setupto select the version of Java you wish to use.On the chance java_setup was not run during installation, there is no harm in running it again.  Log in with root credentials, set the COBDIR environment variable (if it's not already set), then invoke $COB

Created On:  05 April 2011 Problem: When trying to use Modernization Workbench, the Oracle listener starts for a few seconds then stops.  This stops access to any workspace by Modernization Workbench.  How can this be corrected? Resolution: The probable reason for this is an incorrect HOST entry in the Listener.ORA and TNSNames.ORA files.  To overcome the problem, open the properties of "My Computer" and open the Computer Name tab.  Make sure the exact name from this tab is entered in both of the Listener.ORA and TNSNames.ORA files.For example - Listener.ORA....LISTENER =  (DESCRIPTION_LIST =    (DESCRIPTION =      (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))      (ADDRESS = (PROTOCOL = TCP)(HOST = NWB-PHMW3211G.microfocus.com)(PORT = 1521))    )  )For Example - TNSNames.ORA......RMW_REPOSITORY =  (DESCRIPTION =    (ADDRESS = (PROTOCOL = TCP)(

Created On:  29 March 2011 Problem: As soon as we start debugging a CICS transaction, Mainframe Express runs the CESN transaction, even though no transaction is specified in the INITIAL TRANSID.   Is there a way to stop the CESN transaction from running? Resolution: To override the CESN trxn when debugging, you either need to specify a different trxn in the Initial Transaction Id on the Start Debugging screen or if you do not want to run a trxn at all then select the CICS tab.Next, right click on the CICS System folder icon on the right hand side at the top of the tables list (PCT,FCT,PPT,SIT).  This will display a Properties link, select this and remove the CESN trxn code from Initial Transaction Id field on the Overrides tab.Once you have done this, when you start debugging you will get a blank screen instead of the CESN trxn. Incident #2473448 Old KB# 33795#MFDS#EnterpriseDeveloper

Created On:  29 March 2011 Problem: When trying to Change Active Database Engine from 'XDB' to 'IBM DB2 for Windows' the change is not saved on exit from the Mainframe Express Database Configuration window. Resolution: This problem occurs in Windows 7 if the change has not been applied as Administrator.1.  Select Start > All Programs > Micro Focus Mainframe Express 3.1 > Configuration2.  Right Click on Database3.  Select 'Run as Administrator'4.  Accept the User Account Control Prompt5.  Make the required change to the Active Database Engine in the Mainframe Express Configuration Window.6.  Click ok The changes should now be saved. Old KB# 33793#MFDS#EnterpriseDeveloper

Created On:  30 March 2011 Problem: A printer exit routine reads print records that contain null or Hex'00' characters, but these null characters somehow get removed and cause the printout to be shifted gradually to the left line by line.Example:If the print out from the Cobol program is as follows:1 12345 364848  288823 7913784 2 27837 737237  372327 23778383 73878 890380  098393 3893888And if the second position in the above records is Hex'00', the printer exit gives the output as:112345 364848  288823 7913784227837 737237  372327 2377838373878 890380  098393 3893888 Resolution: The default behavior is to strip out NULL characters during READ operations, so to resolve this issue, you will need to set the File Handler configuration option INSERTNULL to OFF. Here are the steps to achieve this:  1. create a CFG file with the following lines [XFH-DEFAULT] INSERTNULL=OFF  2. set the EXTFH environment variable to point to t

Created On:  29 March 2011 Problem: One of the properties of an individual Server (within Enterprise Server) is the number of "Requested Licenses".  This is the number of ES licenses that will be allocated initially, for the use of that one Server, from the total pool of ES licenses as shown in AppTrack and/or eslmfgetpv.  This property can be changed in the Enterprise Server Administration web interface, on the Server > General tab.But changing the number of Requested Licenses on the Server > General tab, does not seem to have an effect.  For example if the number is changed from 1 to 2, and then a person clicks Apply, then goes back to the main page showing all servers, the number of allocated licenses shown for the server in question remains 1 and does not immediately go up to 2.  Experimentation has shown that the number can be made to go up to 2, by starting extra SEPs for the server in question.  Why does the number not go up immediately

Created On:  29 March 2011 Problem: After installing Studio Enterprise Edition 6.0 you open Visual Studio 2008 and you are not able to see the Enterprise Server regions in the Server Explorer tab of Visual Studio. Resolution: To be able to view the Servers in the Visual Studio Server Explorer you will need to do a repair on the Studio Enterprise 6.0 installation. You can do this by going to Control Panel > Add/Remove programs and selecting Studio 6.0 and clicking on Repair.  This will run though the installation again an re-register Studio Enterprise 6.0 with Visual Studio 2008. Old KB# 33788#EnterpriseDeveloper#MFDS

Created On:  29 March 2011 Problem: When trying to compile using COBSQL I am getting the error message:  "CSQL-F-009: Irrecoverable error"And specifying the directives PREPROCESS(cobsql) and PREPROCESS(CP), or as an alternative, the abbreviations P(cobsql) and P(CP), for example:cob -C "P(cobsql) CSQLT=ORACLE8  P(CP) SY ENDP" hello-world.cbl* Micro Focus COBSQL Integrated Preprocessor with ASCII/EBCDIC Support* Server Express V5.1 Copyright (C)1984-2010 Micro Focus (IP) Limited.* URN AAAPA/ZZ0/00065* CSQL-I-008: Invoking CP Preprocessor* CSQL-F-009: Irrecoverable error in CP -- Terminatingcob32: error(s) in compilation: hello-world.cbl Resolution: The "cp" preprocessor's name is case-sensitive.  If you specify it in uppercase:  P(CP),  it will not be recognized.  It must be specified in lowercase:  P(cp)For example:cob -C "P(cobsql) COBSQLTYPE==ORACLE8 P(cp) SY ENDP" hello-world.cblThis will make the error go away. Incident #2508358 Old

Created On:  31 March 2011 Problem: First, some background information on intrinsic functions ORD and CHAR:Intrinsic function ORD takes a single character as an argument, and returns an integer representing the ordinal position of the character in the program collating sequence.  Below is sample code with output -- this is not a code fragment, but a complete COBOL program, suitable for cutting-and-pasting:UNIX prompt > cat demo-ord.cbl     1  01 char-ws pic x value "F".     2  01 ord-ws  pic 9(3).     3  move function ord(char-ws) to ord-ws.     4  display "The ordinal position of character ",     5          char-ws, " in the".     6  display "program collating sequence is: ",     7          ord-ws.UNIX prompt

Created On:  28 March 2011 Problem: Displaying a data item that contains the form feed character x'0c' causes the screen to be cleared. How does one prevent this character from clearing the screen?In the following example, 'Hello world!" will be displayed first, and the screen will be cleared upon displaying the form feed character on the next line. The program will stop with the 'Hello world again!' line only on screen.000070 WORKING-STORAGE SECTION.     77 Form-Feed-Char PIC X VALUE X'0C'. 000109 000110 PROCEDURE DIVISION.         DISPLAY 'Hello world!'         DISPLAY Form-Feed-Char         DISPLAY 'Hello world again!'         GOBACK. Resolution: Here are two alternatives to prevent the form feed character from clearing the screen:a) Always build the program as an executable - this means all console I/O

Created On:  28 March 2011 Problem: During compilation, I receive the message:CSQL-I-018: Invoking ORACLE8 Precompiler/TranslatorEven though I am not using Oracle version 8, instead I am using Oracle 9 or 10 or 10g. Resolution: This informational message pertains not to the version of Oracle you are using, but to the version of the COBSQL pre-compiler.  For more information, refer to the Server Express documentation, Database Access Guide, Chapter 9: COBSQL.To use COBSQL at all in the first place, you must specify the compiler directive PREPROCESS(COBSQL).  Having specified that, there are several COBSQL options you can specify in addition.  One such COBSQL option is named COBSQLTYPE (or CSQLT for short).The documentation says:COBSQLTYPE directive --- Specifies which precompiler to use.Syntax: --- COBSQLTYPE={ORACLE | ORACLE8 | SYBASE | INFORMIX-NEW}As you can see, this directive could take one of four possible values.  Pertaining to Oracle, th

Created On:  29 March 2011 Problem: After installing Studio Enterprise Edition 6.0 on Windows 2008 Server R2 and going into the Enterprise Server Administration page, it shows the Administration page as empty only showing the title.An attachment to this article shows a screenshot of the screen which you will get. Resolution: To be able to view the servers in the Enterprise Server Administration page you will need to lower the security policies for Windows 2008 Server R2. This should then allow the explorer to show the contents of the Server administration page. Incident #2498908 Attachments empty_admin_page.JPG Old KB# 33785#EnterpriseDeveloper#MFDS

Created On:  28 March 2011 Problem: Is Revolve 7.0 compatible with Windows 7? Resolution: You need to make sure that Revolve 7.0 WrapPack #2 is installed since this is a full software installation.  Once WrapPack #2 is installed, you will need to install WrapPack #9 which contains compatibilty for Windows 7. Old KB# 33775#SupportTip#EnterpriseAnalyzer

Created On:  30 March 2011 Problem: According to the documentation, Studio Enterprise Edition 6.0 supports several Language Environment (LE) commands, such as CEELOCT and CEESECS, but any attempt to call them fails with program not found. Resolution: These LE commands or modules are resolved in LE370.LBR, so the program that will call these modules will need to be compiled with the directive INITCALL(LE370.LBR). In other words, LE370.LBR module has to be loaded in memory prior to call the LE modules. Incident #2485504 Old KB# 33806#MFDS#EnterpriseDeveloper

Created On:  29 March 2011 Problem: How can I establish if my program is running as a BMP or an MPP? Resolution: This can retrieved by issuing a CALL AIBTDLI with the INQY function and ENVIRON as the subfunction.There are a number of data items returned from this call including:PSB namePSB Type - MPP, BMP etcIMS Transaction codeUseridThis can be run in Mainframe Express or Enterprise Server.  A sample program is attached to show the data returned. Attachments IMSINQY.CBL Old KB# 33794#EnterpriseDeveloper#MFDS