FOXBORO CROSS-REFERENCE UTILITY ver 0.95.2 12/6/2001 Mark Dumond (mdumond@feedforward.com) FeedForward, Inc. - Control Systems Applications Engineering Certified Foxboro Systems Integrator Marietta, GA 30066 770-426-4422 Send bugs and comments to: mdumond@feedforward.com DISCLAIMER: FeedForward, Inc. takes no repsonsibility for any problems that may arise because of this utility. Use at your own risk. ----------------------------------------------------------------------- This program creates a cross-reference of: 1. COMPOUND:BLOCK.PARAMETERS that are used 1. Connected or referenced in other blocks parameter connections 2. Blocks that are connected to it in input parameters or seq code 3. Display connections, both input and output (Display Manager and Foxview) 4. Historian connections 5. Sequence code references, as long as the references are explicit and not de-referenced from a variable (by using single quotes). 6. C:B.P references in ASCII files, like dmcmd files 2. FBM Point usage 1. FBM Letterbug and Point number 2. COMPOUND:BLOCK that uses it 3. Block type ----------------------------------------------------------------------- TO INSTALL: 1. Choose an install directory with plenty of room. Recommend /opt/foxind. 2. (copy xref.tar to /tmp directory) 3. cd /tmp 4. cd [directory you want to install it to, like /opt/foxind] 5. tar xvf /tmp/xref.tar 6. rm /tmp/xref.tar 7. This program only works on AW51 workstations! ----------------------------------------------------------------------- TO CONFIGURE: 1. cd [installdir]/config 2. edit "cps" file to include lines of CP letterbugs to report on 3. edit "dsps.dm" file to be lines of root directory names where DISPLAY MANAGER type displays reside. All sub-directories (recursively) will automatically be included and should not be included in this file. 4. edit "dsps.fv" file to be lines of root directory names where FOXVIEW/FOXDRAW type displays reside. All sub-directories (recursively) will automatically be included and should not be included in this file. 5. edit "dmcmd" file to be lines of root directory names where display manager script files (and/or any other ASCII-based files that may have CMP:BLK.PRMs in them) reside. All sub-directories (recursively) will automatically be included and should not be included in this file. 6. edit "hists" file to include lines of historian names to report on. 7. Only local displays are cross-referenced. Thus, if the xref AW does not contain up-to-date displays, then displays must be loaded on the AW that will be running this xref program. Also, if the displays are Foxview 70 (WinNT) series, they must be converted to Foxview 50 series. 8. Display libraries for Foxview should also be loaded on this xref AW. These directories are /opt/customer/displib/* 9. Any sequence include files should be loaded on the local xref AW, in the appropriate directories. This is because the utility compiles the sequence code to obtain external references. ----------------------------------------------------------------------- TO EXECUTE 1. Make sure that there are no Control Configurators currently active in any of the CPs to be reported on, nor are any of these CPs checkpointing 2. cd [installdir] 3. run 4. The utility will let you know its status as it is executing 5. You may have to wait a while, especially while the utility is working on displays. Sit back, relax, and have some coffee. I have seen this utility take several hours on an AW51B with six CPs, and a 100+ displays. Complex Foxview displays will take the longest amount of time. ----------------------------------------------------------------------- CROSS-REFERENCE OUTPUT 1. xref_all Includes a compilation of control, display, sequence, and historian. It is formated in three columns, sorted on the second column. The first column is a list of inputs to the C:B. The third column is a list of references to the C:B. USE WIDE WINDOW TO VIEW!!! 2. xref_fbm is the cross-reference of FBM/point loading It is sorted alphabetically by FBM letterbug/Point number 3. xref_all.csv It is the xref_all output, but the columns are separated by commas so it can be easily imported into Excel. OUTPUT NOTES: 1. Sequence code references will be shown as COMPOUND:BLOCK.SQCODE 2. If the first column of xref_all contains a display name that is too long, only the last 30 or so characters will be displayed, and the display will start with "/@" to indicate missing characters. 3. Use a wide window to view the xref_all file. (~100 chars wide). ----------------------------------------------------------------------- OTHER UTILITIES 1. find_cb [COMPOUND:BLOCK] finds all references for one specified C:B USE A WIDE WINDOW TO VIEW!!! (~100 chars wide) ----------------------------------------------------------------------- NOTES: 1. If you break (CTL-C) while the utility is doing dumps on the CPs, you may lock the utility out of that CP until you go into the CP with the Control Configurator and override the lock. 2. This utility is not 100% perfect. This utility has only been used in-house and not thoroughly tested. If you have problems, email me. 3. Since FeedForward is providing this utility at no charge, we appreciate keeping our company name lines in tact at the start of executing the utility, and at the top of this document. 4. FeedForward, Inc. takes no repsonsibility for any problems that may arise because of this utility. Use at your own risk.