RemoteRunNoWait (Method)

Return Value

Type	Meaning
String	The generated remote program name. Use this as an argument from RemoteGetResults and RemoteCleanup.

Arguments

Parameter	Data Type	Meaning
CommandLine	String	The Production Reporting command line. In general, the command line needs the report filename, database user id, and database password. It does not need the ‑keep flag or remote connectivity. Parameters can be passed to the Production Reporting program by placing them at the end of the command line. See“Production Reporting Command-line Flags in Volume 2 of the Production Reporting Developer’s Guide for more information about the Production Reporting command line.
StdOutFile	String	The temporary name that Production Reporting Remote generates to run it on the server. Pass this output parameter as an input parameter to RemoteGetResults.

Parameter

Data Type

Meaning

CommandLine

String

The Production Reporting command line. In general, the command line needs the report filename, database user id, and database password. It does not need the ‑keep flag or remote connectivity. Parameters can be passed to the Production Reporting program by placing them at the end of the command line.

See“Production Reporting Command-line Flags in Volume 2 of the Production Reporting Developer’s Guide for more information about the Production Reporting command line.

StdOutFile

String

The temporary name that Production Reporting Remote generates to run it on the server. Pass this output parameter as an input parameter to RemoteGetResults.

Description

Runs the specified Production Reporting program on the remote server without waiting for execution to complete. This method copies the Production Reporting program file to the server, runs the Production Reporting report remotely on the server, does not wait for the report to complete running, and returns immediately. Use the RemoteGetResults method to check the report run status and to retrieve the report output.

Like the RemoteRun method, the RemoteRunNoWait method generates a unique random name for the Production Reporting program when it is copied to the server. These temporary files are cleaned up when RemoteGetResults is called. This eliminates contention with other users who may be running a program with the same name using the same directory on the remote server.

The SPF report output file has the same path and filename as the specified Production Reporting program file, but the filename has an SPF extension.

As with the RemoteRun method, when the Production Reporting Viewer is displaying report output, close the report prior to running an Production Reporting program to prevent file sharing violations due to overwriting of an open SPF file.

Note:

It is assumed that there is no -F flag or NewReport command used in the Production Reporting program, and that the program generates a single report. It is also assumed that there is no -E flag on the command line, and that the Production Reporting command on the server has the extension SQR. If these assumptions are not true, do not use the RemoteRunNoWait method; instead use the RemoteGet, RemotePut, and RemoteExec methods directly.

The following command line runs the program mytest.sqr using the database login acctg and the password acctg:

mytest.sqr acctg/acctg