Use this command to initiate a report or to recover a report with recovery information available.
Standard input, standard output, and standard error might be redirected as desired. By default, all are directed to the initiating terminal.
The output produced depends on the options specified when the report was created, as well as the device type specified when the report is executed.
Administration command
:RUN report [RECOVER sid ] [ device ] [TR] [PA params]
Where:
report is the name of the report.
sid is the session id for recovery information.
Include RECOVER sid to use the recovery information to recover the report. Use the :REP command to find values for sid.
device is a device type that overrides the device type set for the report.
Valid device types are:
LP — Piped to the command defined by the LP alias
TP — Piped to the command defined by an alias
EX — Output to an alias
VD — Output to a temporary file (the name is displayed when the report is initiated)
DI — Direct output to an alias
DP — Direct output to Enterprise Output Manager
params is a string literal (enclosed in quotation marks) to pass to the report.
PA enables you to pass a string literal with a maximum of 254 characters to the report. The report must have the receiving parameter attribute named in its properties prior to generation.
Include TR to enable Trace for the report.
COM+ method
RunReport([in VARIANT vtReport, [in] IMessages* pMessages, [in,optional, defaultvalue("")] BSTR bstrParameter, [in, optional, defaultvalue("LP")] BSTR bstrDevice, [in,optional,defaultvalue("")] BSTR bstrLanguage, [in, optional, defaultvalue(0)] unsigned long ulFlags)
Use this method to initiate or recover a report.
Where:
vtReport is the name of the report.
pMessage is the user s Imessage interface used to retrieve massages.
bstrParameter is the parameter to be passed to the report.
You can pass a string literal with a maximum of 254 characters to the report. The report must have the receiving parameter attribute named in its properties prior to generation.
bstrDevice is a device type that overrides the device type set for the report.
Valid device types are:
LP — Piped to the command defined by the LP alias
TP — Piped to the command defined by an alias
EX — Output to an alias
VD — Output to a temporary file (the name is displayed when the report is initiated)
DI — Direct output to an alias
DP — Direct output to Enterprise Output Manager
bstrLanguage is a language defined for the application.
ulFlags are flags to indicate where the report is run from. (Not used internally.)
Security
Users must be a member of one of the following COM+ roles in order to access this administrative function:
Report Runners
Report Administrators
Application Administrators