15. Creating Reports in OpenROAD : Using the Report Procedure Tool : Report Procedure Tool : Call Interface to Dialog Frames and Reporter Procedures
 
Share this page                  
Call Interface to Dialog Frames and Reporter Procedures
The following sections provide examples and parameter definitions for the call interface.
Calling from the Dialog Frame
callframe Dialogname (PM_RunMode = runmode,
                      PM_PopErr = smallint not null,
                      PM_DirName = dirname,
                      PM_Img_Db = imgdb,
                      PM_ImgDir = imgdir,
                      PM_database = datadb);
Optional Parameters
PM_RunMode
Default is CS_RM_IS (Image Server) –meaningful only if the report uses image trim.
PM_PopErr
When set to TRUE, specifies that errors are displayed in popup windows (default FALSE).
PM_DirName
Specifies the directory for temporary output files. The dialog will try to pick a reasonable directory if none is given.
PM_Database
Required only if data resides in a database other than the current dbsession (default = curframe.dbsession.database (database name) ).
PM_Img_Db
Required only if all of the following are true:
The report uses image trim
PM_RunMode = CS_RM_DI (database images)
Images are stored in a database other than PM_Database (when PM_database is supplied) or images are not stored in the current database
PM_ImgDir
Required only if the report uses disk-resident images and images are not located in original paths.
Calling a Report Procedure
callproc procname(PM_Outputdir = tmpdir,
                  PM_OutputFile = left(repname,8),
                  PM_runmode = runmode,
                  PM_PopErr = poperr,
                  PM_Imgdir = imgdir );
Required Parameters
PM_Outputdir
Specifies the directory for temporary output files
PM_OutputFile
Specifies the temporary output file name
Optional Parameters
PM_Runmode
Specifies the run mode. This is only meaningful if the report uses image trim that is not stored locally on disk. Valid runtime values are:
CS_RM_IS (default) – use image server
CS_RM_DI – use database-resident image trim
PM_PopErr
Specifies whether most runtime errors are displayed in popup windows. Default is FALSE.
PM_ImgDir
Specifies an image directory. Required only if the report uses disk-resident images and the images are not located in original paths. Valid runtime values are:
'dirname' – a valid directory containing all disk-based image trim
'' – use environment variable II_REPIMAGE_DIR, if set; otherwise use original paths
'<embed>' – use original paths; ignore any setting of II_REPIMAGE_DIR