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