Building Source Code Viewer Extension Information
Note:Prerequisite. You must have a valid OUAF Development Environment defined on the computer in order to run this process.
You will need a local folder in which to build the information. This may be called anything you wish and it may reside anywhere (locally) you desire as long as you have write access to the folder.
Note:
If you have run this process previously, old Source Code XML files will still be present. Previous information is NOT deleted.
Open a command window and run the script buildAppViewerSrcXML.bat. This script is available in the SDK shortcuts folder (e.g., C:\ouafsdkXXX\SDK\shortcuts.
This will prompt you for the location of the Source Code Folder, the location of the Destination Folder and the location of the "desc.wrk" file.
Enter the FULL path name to the folder where the source code resides (quotes are not required). Source in this location will be processed to build the required XML files. The process does NOT drill down through different levels of folders; only the folder specified is examined. For example:
C:\spl\<CCB_INSTALLATION>\cobol\source\cm
Enter the FULL path name to the folder where the information is to be built (quotes are not required). These folders need to exist before the script is run. Script will not create the folders. For example:
C:\temp\appViewerData
Enter the FULL path name to the location of the "desc.wrk" file. This is normally found in the Application Viewer under /data/source. This file can be copied locally or used from the Application Viewer location (it is not updated). For example:
C:\spl\<CCB_INSTALLATION>\splapp\applications\appViewer\data\source
The process will then run automatically displaying each source file being processed.
Each source file is processed twice. This first pass extracts a program description from the source file. This should be a quick process as the file is only examined until a description is located. The second pass reads the entire source file and builds the XML file. This process also accesses the current database to check the meta-data for tables used by SQLs within the source.
When the process is complete, the extension information will be present under the destination folder you specified. The structure under the destination will mirror the structure under the data/source/ folder of the Application Viewer (only the CM folder is created). Move the XML files from the CM folder to the corresponding CM folder under the Application Viewer. The information is immediately available.
e.g. if the destination directory is c:\temp\appViewerData then the processed data is available at c:\temp\appViewerData\source\CM. Copy the contents under c:\temp\appViewerData\source\CM to Application Viewer folder C:\spl\<CCB_INSTALLATION>\splapp\applications\appViewer\data\source\CM.
Parent topic