docs

Home All functions Legacy functions Categories

vuSetMailLog()

Clarion prototype

Prototype: vuSetMailLog(*CSTRING InFileName), SIGNED, PROC, PASCAL, RAW, NAME(‘vuSetMailLog’)

Description

This is the legacy vuMail function name for vuLogSetFile().

Preferred function name:

This function is exported for backward compatibility and behaves identically to vuLogSetFile(). It selects the legacy sent-mail CSV log file. Successful and failed send attempts append rows in this format:

Date,Time,From,To,Subject,SavedEmailPath,ResultText

This is separate from diagnostics logging. Use vuDiagnosticsSetFile() for diagnostics and vuClearMailLog() to clear the sent-mail CSV log.

If an outgoing .eml copy is saved because vuSetSaveFolder() or vuGlobalsSetEmailFolder() is set, the SavedEmailPath field contains the saved .eml path. If no outgoing .eml copy is saved, that field is blank.

vuSetDiagnosticsLevel() and the legacy alias vuSetMailLogLevel() do not turn this CSV/activity log on or off. They control diagnostics verbosity only.

Example (Clarion)

rc      LONG
logFile CSTRING(260)

logFile = 'C:\MyApp\Logs\sent-mail.csv'
rc = vuSetMailLog(logFile)

IF rc = 0
  MESSAGE('Mail log was not accepted: ' & vuMailLastError())
END
Home All functions Legacy functions Categories