RemoteGetUniqueSqrFile (Method)

Return Value

Type

Meaning

String

A unique temporary Production Reporting filename on the server.

Arguments

(none)

Description

Returns the unique filename for an Production Reporting program.Production Reporting Remote methods RemoteExec and RemoteExecNoWait use this filename to run an Production Reporting program on the server. Using the unique filename to run Production Reporting programs on the server prevents multi-user conflicts. The Production Reporting Remote methods RemoteRun and RemoteRunNoWait utilize this functionality to prevent multi-user conflicts.

This routine generates a filename with the format SQXXX.SQR, where XXX is a six-digit random number. It also checks that the filename does not already exist on the server. If the file already exists, it retries this operation. If, after five attempts, it still fails to generate a unique filename, it aborts and returns the error code SQRR_ERR_GEN_UNIQUE.

There is a chance that another client PC can generate the same unique identifier; however, the chance is small since the unique identifier includes six digits.