Tutorial
This is a brief tutorial to familiarize you with the new features of the Report Procedure Tool.
Before You Begin
1. Start Reporter and load a report from the database or import one from a file.
2. To test most of the new features you should use a report with at least two different image trims and have at least one of each kind: database-resident and disk-resident.
3. Copy disk-resident images to a directory that is different from the one defined in the report. All runtime disk-based images should reside in the same directory.
4. Compile or print the report in Reporter. Once run or compiled, the report document may be closed.
5. Click Tools, Procedure List.
Using the Procedure Tool
When the Procedure Tool starts, depending upon the settings, it may:
• Load the application list for the current database
• Load the report list for the current application
• Load the default Image Server Frame from disk
If the Procedure Tool is run more than once in the same session the global Image Server may already be initialized. If auto load is set for the Image Server you will be given a chance to retain the in-cache version of the Frame and not re-load from disk.
When the Procedure Tool Frame appears, all Report procedures created in the current session by successfully compiling or printing reports are listed as Session Reports. The reports do not have to be open. The title of the frame will include the working directory.
File Names
When report components are saved to disk the use of files is controlled by two options (Options/Files):
• Replace Existing: If TRUE, overwrite without prompting if file already exists, otherwise prompt for confirmation.
• Use Default Names: If TRUE, derive names from component names, otherwise display a file popup.
Saving Report Procedures
Any report procedures or dialog frames that have already been exported during this session will have "Y" in the Procedure Saved and/or Frame Saved column. To Export a report or its associated components (frame and image server), choose File/Save Session Report. The current procedure and/or its components (see Reports/Options/Include) will be exported to files as described above.
Running Report Procedures
A dynamic procedure may be run directly from here. The default mode for running the dynamic procedure is "runtime," using an image server and/or directory if image trim support is required. To run a procedure as if from Print in the main window, set Images/Options/Use Image Server and Images/Options/Use Image Directory to FALSE.
To re-run a report that you are designing, if the report has not changed since the last run, or you want to run the previously printed version before regenerating a new version from a changed design, it is quicker to use Reports/Run than the Main Window’s File/Print.
Importing Reports to Target Applications
Note: In order for a target application to use report procedures, it must include repcomp.img and repopen.img.
1. Select the target database, if necessary, by entering a valid 'node_name::database_name' into the Database entry field.
2. If the Application list is not loaded or is out of date, click View/Refresh Applications. If the Applications option field displays "Load Applications" then selecting this option will also load the application list.
3. Select the target applications from the Applications option field.
4. If the Application Report List is not loaded or is out of date, click View/Refresh Reports, or if the Application Reports List displays "Load Reports" click on this row to load reports.
5. Click Reports/Import to Application or Reports/Write Install Script—only one of these options is available at a given time and is controlled by Reports/Options/Immediate.
If the selected report or any of its specified components (Reports/Options/Include) has not been saved during the current session you will be prompted to:
• Continue: Use a corresponding component on disk.
• Cancel Install: Abort attempt to import the procedure.
• Save Now: Export the required components and continue. If some requested component cannot be saved you will be allowed to cancel the installation.
Otherwise you will be prompted to confirm the components to be imported.
If Reports/Options/Immediate is TRUE, the exported report components will be imported into the target application; otherwise an import script will be written and can be run via Reports/Batch Install.
Note: Reports/Options/Replace Existing:
• If TRUE will apply the '-m –nreplace' flag to the import without prompting for confirmation.
• If FALSE and name conflicts are detected, you will be given the option to Skip, Cancel Install, or Replace. Name conflicts can only be detected if the current application report list is up to date.
Working With Image Trim
As described previously, reports that use image trim in their definitions may require additional support when imported to target applications. If this support is not provided the report can still be run:
• with image-trim – if database or disk resident images are available on the target machine/database and stored as on the design machine/database.
• without image-trim – if original images are not available.
Image Directories
Disk-resident image trim must exist in the original directory from which it was defined or in a single directory anywhere on the local machine if the environment variable II_REPIMAGE_DIR is set to point to that directory or the parameter PM_IMGDir is passed to the report or its dialog frame. For a given report, alldisk-resident image trim must be stored in the same way.
In the Procedure Tool a report can be run in either mode determined by the setting of Images/Options/Use Image Dir. The image directory can be set by Options/Files/Image Directory and this will override II_REPIMAGE_DIR if that is also set.
Image Servers
Image trim that was database-resident at design time may exist in the Reporter images catalogs that must be a copy of the design database Reporter images catalogs, or the image bitmaps may be copied into an Image Server Frame.
An Image Server is an OpenROAD frame managed by a Reporter-defined userclass. The Image Server Frame becomes part of the target application for report procedures and may be constructed by the Procedure Tool. An appropriate Imager Server frame must be created or loaded from disk. Options/Files/Image Server may set a default name and it is expected to reside in the working directory.
Images/Image Server/Load – load an image server frame from disk and initialize the Global Image Server object
Images/Image Server/Create – build a new image server frame
Note: In either case, if an Image Server is already initialized you will be prompted to keep or replace it.
Images/Image Server/Add Images – determine which database-resident images are required by the specified report(s) and add them to the image server frame. Each image has a unique ID that corresponds to the ID in the design database. Multiple documents can share the same image.
Note: A Single Image Server Frame can support multiple reports but all must come from the same design database.
Images/Image Server/Add Image Options:
– Replace Existing: (currently, always FALSE) – any attempts to add an image trim that is already present will be ignored.
Note: Each report can add an association for an existing image to the server frame—these associations are held in a viewable TableField (View/Image Server)
– Add Selected/Add All: add images from current procedure or all procedures listed as Session Reports
File/Save Image Server: Export the image server to disk. Only available if server has been modified.