Rocket® Enterprise Suite

Problem: When running the script from Tools/Scripts/Utilities/"Generate a script to build this project from scratch" has a problem when CA-7 because it seems to put garbage information in the TWS stream entry. addRel(type="system_component_stream",relation="attr_comp-param-d_twswdr-filename","Empty Set"); or addRel(type="system_component_stream",relation="attr_comp-param-d_twswdr-filename","COBOLPROGRAMNAME"); Resolution: A new builder.rqc was developed to fix this problem and was put in the web sync that is going to be GA in October 2008.  In the meantime, it is attached to this KB article and developed to fix this problem post web sync 5 for Revolve 7.0, ONLY. Go to the product's path, ..\\Revolve 7.0\\SCRIPT\\UTILITY, rename the builder.rqc file, found in this folder path, and place the builder.rqc file attached to this KB article in this path structure.   If Web Sync 6 has been applied, do not do this then.   **The c

Problem: Can the Microfocus Mainframe Access product support the z/OS environment that has the following parm specified in the DIAGxx parmlib member: VSM ALLOWUSERKEYCSA(NO) Resolution: This will normally default to NO on zOS 1.9 (our version at CSIMVS DOES NOT SPECIFY IT - so it is OFF). It looks like some software vendors would require it (notably ADABAS from Software AG, Datacom from CA) The implication is that performance may be improved for very-large databases.  And some software vendors exploit it.  MFA does not.    Other DBMS systems use data spaces rather than CSA. (aka shared memory) Old KB# 3122#MFDS#EnterpriseDeveloper

Problem: Getting cobesdebug to attach to a session can sometimes prove to be a challenge as there are several criteria which must be met for it to work successfully. Here are some tips on making the process easier. Resolution: Firstly, there's been a lot of work done on cobesdebug recently.  A number of fixes went into Server Express 5.0 WrapPack 4 Fixpack 18 and into Server Express 5.1 WrapPack 1.  Ensuring you're using one of these two versions is a good first step. Next ensure the answer to the next three questions is YES: 1.  Is the code compiled for animation? 2.  Is the dictionary file (.idy) and source (.cbl) available? 3.  Is the cobesdebug user id the same as the user id submitting the JCL? The attach is worked out by using a file on disk in the /tmp or $TMPDIR location so check that the cobesdebug session and server using the same /tmp or $TMPDIR locations.  Also check that there's

Problem: Which databases are supported within Enterprise Server? How do I build the XA switch modules? How do I configure the XA switch modules? What name should be entered for the External XA Resource Manger for Oracle / DB2/ SQL Server? How do I diagnose XA switch module errors when starting Enterprise Server? Starting Enterprise Server, I get a Switch Load module name failed to load error. Starting Enterprise Server, I get a SQLCODE -998 subcode X within the console log. Resolution: This article attempts to cover all aspects of database access support within Enterprise Server, under the following sections. We strongly recommend reading the >RDBMS vendor reference material Documentation Supported RDBMSs for Application-managed Services Supported RDBMSs for Container-managed Services IBM DB2 LUW Oracle OpenESQL ODBC one-phase commit SQL Server XA Reference material from RDBMS vendors Resource Manager Configuration, including examples of Open String formats Deployment

Problem: When installing the MFE 3.1 websync, user receives message from the MSI installer "system can not open the device or file specified" when installing fixpack. Resolution: Another msp execution may be running in the background.  Check for the existance of the MSI in the windows task manager and cancel the process or restart the machine. This should release the process and allow user to install the websync or hotfix. Old KB# 3123#EnterpriseDeveloper#MFDS

Problem: We have compiled VRECGEN on our mainframe. The dataset we want to download has DCB=(RECFM=VB,LRECL=12000). VRECGEN fails on the OPEN of the input file. The host says the input dataset is 12000 and the program uses 32000. Can you help please? Resolution: VRECGEN defaults to use 'Occurs 0 to 32700 Times' in the input FD.  Change that to be '0 to 12000'. Then change the output FD to be the same. But the key will be the JCL that will be      DSORG=PS,RECFM=VB,LRECL=12004,BLKSIZE=0             or you can use BLKSIZE=12008 I like BLKSIZE=0 because the system determines the optimum blocking based on the dasd used. The output file will be:      DSORG=PS,RECFM=VB,LRECL=12006,BLKSIZE=0             or you can use BLKSIZE=12010      The default setting in V

Problem: Are there limits? Resolution: XDB has a limit of 750 parameters on a create procedure or call procedure statement.   Old KB# 2958#EnterpriseDeveloper#MFDS

Problem: How to attach documents to an application / organization view Resolution: You can attach (and view) documents to any technical organization view from Configurator, Tech, Builder and Dynamic Inventory (when the Organization view tree is available). 1. Right Click on the desired application and click on "Properties" 2. In the dialog click on "Ext.Properties" 3. Click on "New" and set the following fields (click on them in order to edit them) - Type - Set this to "Document" - Nature (will be automatically set to Alphanumeric) - Name - enter any meaningful name for the attachment - Value - here you have two small icons. Use the ellipsis icon ("...") in order to browse for a document to attach, then click Apply. You can use the other small icon to open the attached document with the default editor/viewer. For documents which will be viewed by many people, you will need to select a document which resides in a shared location (e.g. a shared mapped drive)

Problem: Question from customer: I found in our MFE docs where we talk about System Limits for XDB and see no direct statement stating the max for an XDB database size. Am I to assume that we don't have limits on the database size other than what the operating system imposes through file size limits or what XDB restricts through other limits such as number of records? Resolution: 200GB is the max table size.  The max record size is 32K.  If every record in the table is 32K, that gives 200GB/32K records or roughly 6,500,000 rows.  Obviously, if rows are smaller we can have more rows per table.  We split the table into multiple 2GB chunks if the table grows beyond 2GB.  There is no limit on the number of tables in a location.  So a location could get fairly large.  We feel comfortable that a client will not exceed our current sizing.  If they do, we'll make it larger. Old KB

Problem: Customer sees the three part table name within the catalog browser in SQLWizard. Would also like to see which database the tables are in. Resolution: To do this, shut down SQLWizard and go to Options - SQL for DB2 - Client. Go to the Browser tab and check Databases under Display. Open SQLWizard and now the qualifier and tables will display under the database name. Old KB# 2962#EnterpriseDeveloper#MFDS

Problem: When debugging some programs with CICS or starting a CICS region you get an error like : 173 Called program file not found in drive/directory MF370UTL.LBR Resolution: Library MF370UTL.LBR is located, by default, at: C:\\Program Files\\Micro Focus\\Mainframe Express\\Base\\Bin You should, as well, have configuration files MF370CLT.CFG and MF370LNK.CFG at folder : C:\\Documents and Settings\\All Users\\Micro Focus\\mfuser\\config This library is installed with the option Assembler Option (MFE370 Assembler Option). So if you get error 173 what you need to do is install this option from the CD and everything will work fine When you restard the CICS region you should see a message saying : 'MF Assembler support loaded succesfully' To resume. Use the CD to install the Assembler Option and the problem should disapear. If you keep having trouble then notify support and inform of everything you have done. Old KB# 3114#MFDS#En

Problem: How to set a special name for all programs Resolution: You can use the SPNM keyword to add an individual special name to a program  but if you want to set up a special name that appears in all programs you can modify the SPECNAME macro in the APSMACS folder. Search for CURRENCY to see where the currency sign special name is brought in and modify to include your special name. Old KB# 2871#MFDS#EnterpriseDeveloper

Problem: I've created/initialised a new DDIFILE, How do I add the DBD members? Resolution: The DBD members can not be manually loaded into the DDIFILE. This is done by the PSB generatoin automatically. When you load and generate a PSB, all of the associated DBD's will be automatically found in the DDISRC folder. The DBD and DDISRC will be loaded during the PSB generation. Old KB# 2891#MFDS#EnterpriseDeveloper

Problem: AMB is giving batserv.exe application error when loading.  When uninstalling and reinstalling, user is still receiving the batserv.exe error. Resolution: This may be due to a bad uninstall of the MFE product.  Upon uninstallation, there may be registry keys still linked to the previous installation. Steps to fix: 1.) Uninstall MFE (this will delete websyncs if installed) 2.) Go into regedit and look for HKEY_CURRENT_USER\\Software\\Micro Focus\\COBOL\\6.0.  Delete the directory. 3.) Reinstall MFE Old KB# 2892#MFDS#EnterpriseDeveloper

Problem: The Password Expiration Manager (PEM) functionality is not included in Mainframe Express Enterprise Edition 3.1, how can it be activated? Resolution: This option has been removed from Mainframe Express Enterprise Edition 3.1 The Password Expiration Manager (PEM) will not function correctly with certain areas of the new z/OS password functionality, for example mixed case passwords are not supported by PEM.   Micro Focus recommends the use of the MFA Drag & Drop tool for changing passwords.  Old KB# 2943#MFDS#EnterpriseDeveloper

Problem: How to edit a data structure - Why does the MFE editor say that I can not edit a data structure. I AMB generation works OK and the editor finds a member but it can not be edited. Resolution: The current architecture only allows you to edit a member that is in the current project. You can view members from other folders in the workgroup but you can not edit them.  This is by design because if we allow a copy like this from a workgroup folder we might be allowing the end programmer to circumvent the SCM model. Old KB# 2875#EnterpriseDeveloper#MFDS

Problem: I'm trying to find what these error messages mean, I cannot find them in the message references.  this works on the mainframe in APS 4.0: ************************************************************* ??? ERROR (LEVEL 8) MESSAGE# IG-PARSE-16100-00-E Syntax error. The parser detected an invalid construct. ...ERROR occurred near '"WHERE OTEIP-KEY = WS-OTEIP-KEY"', line 1691 while parsing the statement:      $DB-OBTAIN("REC EAISOTEP" "WHERE OTEIP-KEY = WS-OTEIP-KEY")                               The current activity is: Parsing, lexing, and generating the compiled macro form ************************************************************* ************************************************************* ??? ERROR (LEVEL 8) MESSAGE# IG-PARSE-16700-00-E *** ERROR: Co

Problem: Where is the Source Connect Configuration definitions kept in the windows registry? Resolution: The Source Connect Configuration definitions are kept in the following registry key: HKEY_USERS\\Software\\Micro Focus\\Mainframe Access3.0\\Server within the "Standard server machine parms"Old KB# 2944#EnterpriseDeveloper#MFDS

Problem: When an IMS screen is generated in AMB, the GENMFS is successfully created, but the MFSGEN in MFE fails because it can't find the IMSCONFG file or user is not authorized to read the IMSCONFG file. I/O ERROR 9/009 OPENING IMSCONFG   - Invalid directory or no authority CHECK "IMSCFG" VARIABLE SETTING Resolution: The error occurs when the CONFIG folder is not found in the product folder location.  Without this folder the IMS step will fail in MFE.  The folder is created when the CICS option is installed with MFE and the folder is then used with both CICS and IMS screens.  If you don't install MFE-EE with the CICS option you don't get a default CONFIG folder in the product folder. One workaround to this problem is to manually create the CONFIG folder in the product directory. Another possible solution would be to install MFE-EE and take the default to install CICS. Old KB# 2887#EnterpriseDevel

Problem: - SQL Target   (Defaults to HCO) - Allow Mixed Case   (Defaults to Yes) - Generate Redefines   (Defaults to Yes) How can I change the defaults so these are initially set correctly for our environment? Resolution: The database view properties are stored in the folder DDISYMB with a .prp extension. The .prp file is created with the save/build action is initiated for the subschema. Once created the .prp file are used for subsequent generations. Old KB# 2890#EnterpriseDeveloper#MFDS

Problem: Generated BMS in AMB has OUTLINE=LEFT statement this is not present in the BMS generated on the mainframe. Resolution: The Appmaster Builder generated BMS is correct and the mainframe BMS is incorrect. In this case, the coder had specified OUTLINE=LEFT in his screen painter but on the mainframe, this code in error was not put into the BMS. In AMB, the correct BMS as specified by the developer is being produced. If this is not the desired result, remove the OUTLINE=LEFT from the screen painter and regenerate the screen. Old KB# 2878#MFDS#EnterpriseDeveloper

Problem: We're in the process of planning a z/OS V1R9 upgrade and are checking on compatibilities of our ISV software with this version of the operating system. We currently are running MicroFocus APS for z/OS V5.0 and MicroFocus Mainframe Access V3.0 and would like to know if either product needs upgrading or maintenance in order to run under z/OS V1R9? Resolution: You should be OK with this planned upgrade to z/OS 1.9. The products do not have any licensing or hooks into the OS version so there should be no impact after this upgrade. We have several customers that have reported moving to z/OS 1.9 and we have no reported problems.  We do have a newer MFA release available which is available on the website and we recommend making plans to upgrade to the newest release but again, we have customers using MFA 3.0 with many version of z/OS and expect no problems. Old KB# 2899#MFDS#EnterpriseDeveloper

Problem: I get this message when I try to open the Analysis Browser in AMB. I've done a scan and can't find it on any of my drives. Where's it come from? Resolution: Try selecting actions from the main menu. It's not available from right mouse on an application. Actions/analysis option/macro definition/generate macro definition. They made the macro definition optional because that implies you want to analyize every APS macro call in addition to all of your own source. I've run some analysis options on your large applications and they already run pretty long even without adding in the AMB macros. Old KB# 2869#EnterpriseDeveloper#MFDS

Problem: It is common to want to put a text field into a UNION in such a way that the table associated with the union is displayed.  User will then know which table row is coming from which table. Resolution: Note that the text field ws-literal1 is populated with 'cmsl' if the row comes from the first table in the union and 'cmss' if it comes from the second table in the union. DB-PROCESS REC CMSETFLD-REC ... DB-PROCESS-ID SBRCSR ... LEFT(('CMSL',4),WS-LITERL1,'Y') AS LITERL1X ... SBR_NO ... RECORD_NO ... WHERE SBR_NO = :SETFEA-SBR-NO-S ... UNION ALL DB-OBTAIN   REC CMSETFST-REC ... LEFT(('CMSS',4),WS-LITERL1) AS LITERL1X ... SBR_NO ... RECORD_NO ... WHERE SBR_NO = :SETFEA-SBR-NO-S Old KB# 2884#EnterpriseDeveloper#MFDS

Problem: The installation of Mainframe Access Server references MFAS and MFAAS. What are these?  What function do they perform? Resolution: MFA is the Mainframe Access host server for Drag & Drop, Compare and Synchronize Monitor, Data Connect and Source Connect. MFAS is the auxiliary server for Data Connect. Many customers use this support for large host datasets that are accessed infrequently. MFAAS is the auxiliary server for Endevor or Changeman. If you do not use Endevor or Changeman, then that portion of the MFA host Server install can be ignored. Old KB# 2938#MFDS#EnterpriseDeveloper