Topics   All   Mac OS X (Only)   Windows (Only)   Crossplatform   Server (Not)   Client   Components   Old   Guides
New in version: 4.0   4.1   4.2   4.3   4.4   5.0   5.1   5.2   5.3   5.4   6.0   6.1   6.2    Statistic  

Trace

Component: Plugin
Version: 2.4
Mac OS X: Yes
Windows: Yes
Server: Yes

MBS( "Trace" { ; path } )

Parameters

Parameter Description Example value
path Optional
The native file path to the log file.
"/Users/name/Desktop/debug.txt"

Result

Returns "OK" on success.

Description

Starts logging all plugin calls to a text file.
If you pass a path, debug messages are written to the file. Else the plugin writes to debug console. See Console.app on Mac or DebugView on Windows.
See also Trace.Off and Trace.ErrorsOnly.

On Windows with a FileMaker Server, you can see debug messages in DebugView if you run DebugView application as admin and enable global Win32 listening.
For FileMaker Server on Mac OS X you can see messages in /Library/FileMaker Server/Logs/stderr file.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Log plugin calls to console:

MBS( "Trace" )

Log plugin calls to desktop on Windows:

MBS( "Trace"; "C:\Documents\Christian\Desktop\plugin.txt")

Log plugin calls to temp folder on MAc:

MBS( "Trace"; "/tmp/MBS Plugin Log.txt")

See also


Toolbar.Unregister   -   Trace.AreErrorNotificationsEnabled

Feedback: Report problem or ask question.




Links
MBS Realbasic tutorial videos - Pfarrgemeinde St. Arnulf Nickenich