The Instrumentation Log window is usually the preferred way to dynamically monitor. your instrumentation output. This window is built into Panorama itself making it easier to use than using an external program like or BBEdit (see Crash Proof Debug Instrumentation Monitoring and Debug Instrumentation Monitoring using an External Program to learn more about using external programs).

To start using the Instrumentation Log window, simply choose Open Instrumentation Log from the Instrumentation menu. The new window will show recent Panorama instrumentation activity, and will automatically update as new activity occurs.

For example, this procedure contains two zlog statements that will output information to the log (the zlog statement is discussed in detail later on this page). If you run this procedure with the Instrumentation Log window open, the information will automatically appear in the log:

The top of the Instrumentation Log window contains a toolbar with common actions:

When you are done with debugging, you can simply close the Instrumentation Log window.

Sending a Note to the Instrumentation Log

The Instrumentation Note dialog provides a way to send an arbitrary message into the instrumentation log. For example, if you are about to start an experiment, you could put a note about it into the log, to help you remember later what you did.

There are three ways to open this dialog:

1) If the Instrumenation Log window is open, simply click on the Note icon (on the far left). 2) Choose Instrumentation Note from the Instrumentation menu in the menu bar (it looks like a magnifying glass). 3) If the Instrumentation preference panel is open, you can also open the note dialog by clicking on the Note icon.)

No matter how you open it, the Note dialog will look like this:

Whatever you type will be sent to the log, with a prefix identifying it as a note, and the current time. It will look something like this:

[NOTE @12:54:34 am] Testing 1, 2, 3

Embedding a Formula in the Note

To embed a formula in the note, enclose the formula in curly braces ({ and }).

Before sending the note to the log, Panorama will calculate the value of the formula and merge it into the note. In this case, the final result looks like this:

[NOTE @12:58:01 am] User is Jim Rea

A second option is to make the entire note a formula.

The example above will produce the same log output as the previous example.

Choosing Which Log the Note Appears In

If there is a copy of Panorama X Server running on the current computer, you have a choice of whether to send note to the local log, the server log, or both.

If you send the note to the server, any formula in the note will be calculated on the server. This makes a great investigative tool to poke around and see what is going on on the server. Keep in mind, however, that you have no control over what database is active, or what record and field are active. So you generally don’t want to use database fields in the formula directly. Instead, use formulas with functions that allow you to specify exactly what database, fields, and records you want to investigate, for example info(, dbinfo(, fieldvalue(, fileglobalvalue(, arraybuild(, lookup( etc.

If you choose the Local + Server Log option, any formulas will be calculated twice – once on the local computer, and once on the server. The result of the local calculation will appear in the local log, and the result of the server calculation will appear in the server log. The results won’t necessarily be the same.

To learn more about using Panorama X Server with instrumentation, see Client/Server Debug Instrumentation.

See Also


10.2NewNew in this version.