Rocket® Enterprise Suite

Problem: are the numbers for the Lines of Code that are shown on the index page for each type for the logical or physical lines of code? Resolution: The Lines of Code that are shown in the Index page of the TYPES on the HTML pages, are for the logical lines of code.  Logical lines of code are the number of lines within the COBOL with copybooks included. Old KB# 1166#EnterpriseAnalyzer#SupportTip

Problem: Would like a function that will give a list of all relations for a specific component or import, or UID Resolution: Using the attached function (showrel), a Revolve user will be able to determine all the relationships of a component/import/UID. Giving the Revolve user: Starting Element==>system_component_cobol :  ORDER.CBL  { D:\\TPS6244\\SAMPLES\\ENTERPRISE\\ORDERAPP\\SOURCE\\ORDER\\ORDER.CBL } ========================================================================== :>attr_reql_component-error                    ==> 0 :>attr_reql_component-line                     ==> 1331 :>attr_reql_component-notice                 &n

Problem: Web Sync for Revolve 7.0 was installed on GA Revolve 7.0, now Job Stream Editor (jobstreameditor.exe) is no longer in bin directory, what happened to it? Resolution: The output for this process was no longer compatible to the new parser for Revolve 7.0.  Rather than create a new version of the Job Stream Editor, it was decided to not include it with the product any longer. Old KB# 1103#EnterpriseAnalyzer#SupportTip

Problem: If option in "utilities/options/general transformation" tab - "Automatically rebuild the cache files" is turned on within the product for the administrator who builds the project, then how is this impacting the users? Resolution: If the option for "Automatically rbuild the cache files" is turned ON, then when the make is performed the fum/ufm files are created in the project folder's admin location. When the User goes into the project, the user is accessing the files in the Project folder, and the fum/ufm files are updated via the "Update Shared" process.   The user should never be prompted to "build cache" files when going to Analysis Tools, if the option is turned on and the administrator of the product's project has performed the "Update Shared" process. Old KB# 1168#SupportTip#EnterpriseAnalyzer

Problem: There are a lot of different extensions in the project and sha folder, what are they referencing? Resolution: File Descriptions: LOG Logs project parsing actions PRJ Holds list of files in the project SCA File used to hold all the search paths RP1 Index mapping logical to physical locations RP3 Index of variable usages RA -   RA7 System Database RL -   RL2 Label Index RT -   RT2 Literal Index RV -   RV2 Variable Index UD -   UD5 User Information Database RD0 Component Database for TEXT components RD1 Component Database for COBOL components RD2 Component Database for JCL components RD3 Component Database for BMS components RD4 Component Database for DBD components RD5 Component Database for MFS components RD6 Component Database for PSB components RD7 Component Database for GEN components RD8 Component Database for ASM components

Problem: If printing from the worksheet what is printed out?  is it the entire worksheet or jut hte sheet showing and it's columns? or just the exact visible sheet? Resolution: When printing from the Worksheet, the results will be the TAB that is showing with the columns that have entries.  If anything showing has an entry in a column not shown in the active TAB window, it will be printed out. Old KB# 1128#SupportTip#EnterpriseAnalyzer

Problem: JCL is VSE format, need to convert to MVS format for Revolve to parse Resolution: Unzip vseconvert.zip(attached to this KB)  into the directory where the *.vse files will be. To run this utility: unzip vseconv.zip and put the dlls and exe in the folder where the VSE JCL exists open cmd prompt execute the exe file as follows: vmconva.exe filename.vse filename.jcl **this must be repeated for EACH filename.vse that exists. A response comes back that states convert complete. There will be a new folder in the source directory named JCL, this folder will be the converted VSE file in MVS JCL format. Attachments: vseconverter.zip Old KB# 1092#EnterpriseAnalyzer#SupportTip

Problem: What version is certified to run on Windows 2003? Resolution: QA has only certifiied Revolve 6.2 and 7.0 on Windows 2003 O/S. Old KB# 1096#EnterpriseAnalyzer#SupportTip

Problem: Is the XML job stream parser case sensitive? Resolution: XML is case sensitive. Since the "native" 7.0 stream definition is XML, it is case-sensitive. The element and attribute name are actually all lower case. Attached an extensively annotated sample of the Revolve 7.0 XML format. In the Revolve 6.x format, the element names are upper case, and the attribute names are lower case. My "standard" for this was to create a 6.x format job stream definition using the old job stream editor. Attachments: nativeJobSchedule.xml Old KB# 1104#EnterpriseAnalyzer#SupportTip

Problem: Works on some programs but not on a few.  Associated Variable on context menu, on a few screen fields doesn't seem to pick up the associated COBOL variables, getting no results. Resolution: The programs that had screens showing up in Program Browser, had screens and coding that weren't used any longer.  This caused the "Associated Variables"  to return no COBOL Variables associated with the Fields in the screen. Old KB# 1089#EnterpriseAnalyzer#SupportTip

Problem: Revolve project - open - could not be loaded.  OK until yesterday.  Nothing has changed. Resolution: Reviewed contents of the project folder, looking for RP1 and RP3 files.  Traditionally the RP1 file is about 3x the size of the RP3 file, these files must be present for the project to be opened.  If the RP1 or RP3 files are missing, finding them in a previous back up and opening the project should restore any problems.  Upon closing project, verify that the RP1 and RP3 files still exist.    Also verify that there aren't any .lck files. Old KB# 1093#SupportTip#EnterpriseAnalyzer

Problem: The Tools Menu does not contain a (REQL) Shell entry. Resolution: The Shell must be enabled under Utilities, Options, User, User Settings, REQL Shell. Old KB# 1163#EnterpriseAnalyzer#SupportTip

Problem: The TWS streamfile added to Project via REQL needs to point to WDR file, how?  There are 2 files that need to be considered for a TWS streamfile add to a project.  An ADR and WDR, the ADR is added explicitly to the project, the WDR is an option of the component set up in Project Manager or Utilities/Options/Component Parameters - Stream.  How can this be done via REQL? Resolution: By setting up the stream file for a TWS type stream file: addComp(c:\\pathtoadr\\abc.adr,type="system_component_stream") Addrel(Type="system_component_stream",relation="attr_comp-param-i_job-stream-type",2); Addrel(type="system_component_stream",relation="attr_comp-param-d_twswdr-filename","path to WDR file") by using these 3 lines for a TWS stream file, the Stream file will add to the project without a problem. Old KB# 1154#SupportTip#EnterpriseAnalyzer

Problem: Project built with just one COBOL and search on COPYBOOKS but the entirety of the copybooks weren't brought in, why? Resolution: Revolve will not accept any COPYBOOKS in the Identification, Data and Environment Divisions, therefore, anything found within this area of a program, is treated as a comment.  It is best to expand the detail in the copybook for each program and hard copy it into the program. Old KB# 1148#EnterpriseAnalyzer#SupportTip

Problem: Would like to know what the basic steps of creating a  project and maintaining it - basic "how tos" Resolution: Attached is an article that details the following points: 1)  Structure of source on computer, not Mainframe based 2)  Creating source folders based on structure from the mainframe 3)  Using Search Paths when building a project 4)  Where should projects reside? 5)  What happens when a copybook for both Assembler and COBOL have the same name? 6)  Special needs for adding Macros for an Assembler program 7)  What extension would need to be added to the project? 8)  Creating a rebuild script of the project Attachments: RV70 hintstips.doc Old KB# 1126#EnterpriseAnalyzer#SupportTip

Problem: When would the Execution Indirection be used as opposed to explicitly adding a relationship? Resolution: Using execution indirection for programs that use parameters to determine which entry point to call, which data file to access, etc. For example, there maybe a program called "LINK" that takes one parameter. LINK just loads and calls the program name that's passed in as a parameter. Suppose program PROGA calls LINK like this: ==================== PROGA. ... CALL LINK("PROGB"). GOBACK. ==================== If LINK is set up using Execution indirection, Revolve knows to automatically set up a system_invokes_entry relation between PROGA and PROGB. No manual addition of the relation between PROGA and PROGB is then needed. Old KB# 1149#EnterpriseAnalyzer#SupportTip

Problem: Revolve 7.0 supports TWS stream files now, how do these get loaded? Resolution: There are 2 files needed, the Application Description Report and Workstation Description Report. Add the ADR as a stream file - DO NOT PARSE THIS YET In Project Manager, highlight the stream file, press the OPTION icon change the option from the default of CA-7 to TWS, map to the WDR file. Press OK Make the project IF you have the WDR file in the PROJECT folder and it's the same name as the ADR file, then it will automatically be picked up. Old KB# 1087#EnterpriseAnalyzer#SupportTip

Problem: A copy of the Readme file is attached to this article. Resolution: Attachments: Readme for Revolve v7 WS02.zip Old KB# 1118#EnterpriseAnalyzer#SupportTip

Problem: When loading a Revolve project, an error is reported. Where do I find additional information about the load error? Resolution: If something fails during the load, an appropriate message will be written to the ctf log file only. It is not written to the revolve.log file. Because of this you either need a ctf configuration file in the default location (i.e. the bin directory of Revolve), or the environment variable set with the appropriate location of that configuration file. Without this, nothing will be written. When a project fails to load a message is written to the .log file that looks something like this: 680 MF.RV.RVCORE.RVUTIL 3 : "mf.rv.rvcore.rvutil" ".\\util.cpp 1853 UTIL_openFile - Failed to open file c:\\testproj\\testproj.RP1 - error 2" Old KB# 1121#SupportTip#EnterpriseAnalyzer

Problem: Customer has multiple projects and wants to know if it would be best to be stored on a network drive and how to access them. Resolution: 1.  The first rule of creating projects for Revolve is to make sure each project is in its own folder.  There should not be more than one .prj file in a folder.  Violation of this rule can cause synchronization issues to one project as other projects that model the same components are updated. 2.   Keeping a standard for the projects, where they are stored, is necessary for the whole of the department using Revolve.         a.  It would be best to store all projects on a network drive dedicated to the Revolve source and projects.         b.  It is important that all users of Revolve map the network drive letter the same, as this mapping is used to locate and display the correc

Problem: Using ACL Exclusion list in script to build project wasn't working because those components were being explicitly added to the project.  Automatic Component Locator Exclusion works to keep a component from be included into the project if it's added via search directory.  In this case it was being added explicitly so the ACL Exlcusion list wouldn't work.   To remove specific components it was best to use REQL removecomps function Resolution: Using this syntax: removecomps(system_component_cobol="programname.cbl") for each individual component will remove the component from the project. Old KB# 1176#SupportTip#EnterpriseAnalyzer

Problem: When upgrading from Revolve from 6.2 to 7, using the fix pack RVP3270020075.exe from the web site, the version of Revolve in the Help / About dialogue is unchanged.  Why..? Resolution: The patch does not update Revolve 6.2 at all, it installs Revolve 7.0 and applies the fixes to it. So the version for Revolove 6.2 will remain unchanged. The version of the installed Revolve 7.0 is   7.002.0075 Old KB# 1120#SupportTip#EnterpriseAnalyzer

Problem: On a Windows 2003 machine, Adding PLI to Revolve using the preprocessor and has MFE 3.0, why doesn't it build correctly as it dows on a Windows XP machine? Resolution: There is a problem with PL/I on Windows 2003, to fix this, follow these steps: 1.  Go to Control Panel/System/Advanced Tab/Performance/Settings Button - 2.  In tab Data Execution Prevention - Click ON DEP 3.  press ADD and scroll to find MFPLI\\BIN directory and highlight PLI.EXE Old KB# 1084#EnterpriseAnalyzer#SupportTip

Problem: Should Load Selected to add a component be the way to load the components to the project?  What does Update Status of a component mean? Resolution: Using Load Selected impacts just that component and the direct imports for that component.  Using MAKE will bring in any components that are affected by the originating component and the components that impact that component. For example: ProgA calls ProgB ProgB calls ProgC ProgC calls ProgD ProgA calls ProgD Copybook1 is in all programs. If a Load Selected is done on ProgA, only ProgB and ProgD will be affected directly, so the update would also be done on these components. If a MAKE were done, all of the components would be updated. Old KB# 1139#EnterpriseAnalyzer#SupportTip

Problem: In Revolve 6 when when viewing source in the  "VIEW SOURCE CODE"  panel, there are 3 icons "CODE FLOW VIEW", "INVENTORY VIEW" and "SCREEN VIEW". Where can  CODE FLOW, INVENTORY and SCREEN views be found in Revolve 7.0 Resolution: These functions can now be found under the DIAGRAMS menu. CODE FLOW VIEW  - From the Diagrams menu, choose Program Flow INVENTORY VIEW - From the DIagrams menu, choose Inventory SCREEN VIEW - From the Diagrams mene, choose SCREEN Old KB# 1177#SupportTip#EnterpriseAnalyzer