vuDiagnosticsSetFile()
Purpose
Sets the diagnostic log file path used by vuDiagnosticsEnable().
Export name
Clarion prototype
Prototype: vuDiagnosticsSetFile(*CSTRING xFileName), SIGNED, PROC, PASCAL, RAW, NAME(‘vuDiagnosticsSetFile’)
Return value
- Returns 1 when the operation succeeds, otherwise 0. Use vuMailLastError() for more detail when needed.
Example (Clarion)
rc LONG
diagLog CSTRING(260)
diagLog = 'C:\MyApp\Logs\vumailkit-diagnostics.log'
rc = vuDiagnosticsSetFile(diagLog)
IF rc = 1
vuDiagnosticsEnable()
END
Notes
- This file is separate from the legacy sent-mail CSV log selected by vuLogSetFile() / vuSetMailLog().
- Pass the address of a CSTRING buffer containing the full path.
- Setting the file path does not automatically enable diagnostics and should not append diagnostics rows until vuDiagnosticsEnable() is called.
- Use vuSetDiagnosticsLevel() to choose Normal or Trace diagnostics detail.