The following is a list of "universal" switches seen in NeXtMidas. A "universal" switch is
a switch that is common across a wide range of commands. These switches are typically handled
by NeXtMidas proper and not by a specific command. (Most explain files omit universal switches.)
General |
Switch |
Description |
Default |
/BG |
Run command in BackGround. |
FALSE |
/CMDCLOSETIMEOUT=<seconds> |
Provides a way to specify how long to wait for a command to
complete (i.e. CLOSE) for MidasBean.close(). It is rare that this switch is needed.
Since NeXtMidas 3.1.1.
|
1.0 |
/CMDOPENTIMEOUT=<seconds> |
Provides a way to run commands in a pipe section
to NOT wait for a very slow starting command's open() to complete before
running next command in the pipe section. It is rare that this switch is
needed. Graphical commands SHOULD NOT be executed on Java's EventDispatchThread
(i.e AWT/Swing Thread or EDT) as a general rule of thumb since graphical primitives
can wait on the EDT to display/attach panels, etc. which will then cause a
deadlock. But if you must do so, this switch is provided as a crude way
to set a wait timeout for the command to initialize and open before continuing.
Note: The issue with using a timeout is that a subsequent command that depend
on a previous command to create a file/pipe/resource may fail if the
previous command's init/open had timeouts before it finish opening it's resource.
Since NeXtMidas 2.7.4.
|
-1 for effectively infinite |
/ID=<id> |
Associate an ID to a primitive for message passing, registry, etc. |
Based on name of command |
/MSGID=<id> |
Sets the ID of the registry entry that will process messages sent
by this command. Using /MSGID=MAIN will send all messages
to the macro's processMessage procedure. |
none |
/POLL=<seconds> |
Time between rereads of a file (in seconds). |
0.0125 (1/80th of a second) |
/QUIET |
Deprecated: Use /VERBOSE=FALSE . |
n/a |
/S=<sup> |
Specify the support of the command (M,P,...) when a command is
both a macro and a primitive (limited support). |
Based on commands.cnf |
/VERBOSE |
Produce more screen output. |
FALSE (in a macro)
TRUE (at the shell prompt) |
Macros & Pipes |
Switch |
Description |
Default |
/MFN=<name> |
Internal Use Only: Override the macro file name. |
n/a |
/MSGDEBUG=<MessageToStringMask> |
Enable debugging printout of messages processed (e.g. received) by macro.
Default for just specifying as a state switch is NAME|INFO|DATA|QUALS|FID|TID.
Since NeXtMidas 2.7.1.
|
NONE (i.e. OFF) |
/PS=<bytes> |
Pipe Size in bytes. (See the PS= qualifier.) |
131072 |
/SHAREMASK=<mask> |
Specifies what is shared with parent (i.e. RESULTS).
Since NeXtMidas 2.7.3.
|
NONE |
/TL=<elements> |
Transfer Length in logical elements. (This is a "common" switch,
used by many primitives, see individual primitives for details.) |
n/a |
General Graphics |
Switch |
Description |
Default |
/DISPLAY= |
Set the display mode (Icon,Back,Front,Maximized) for graphical command on startup.
See also /ICON switch. (Since 3.1.1).
|
Based on panel config |
/ICON |
Make graphical command come up in iconified state.
See also /DISPLAY= switch. (Since 3.1.0).
|
false |
/NOALTTITLE |
Prevent events such as mouseovers to change the title of the graphical window. (Since 3.3.0). |
false |
/THEME=<theme> |
Color theme, see PANEL explain
file for more details. |
^ENV.THEME |
/WIN=<window> |
Name of panel in registry to host a GPrimitive. |
Based on panel config |
/WDISP=<display> |
Override the display device for displaying a window. For example:
/WDISP=0 uses display #0 and /WDISP=1 uses display
#1. Number of available displays is platform-dependant. |
Current display |
/WFS=<pixels> |
Window Font Size (pixels). |
Based on theme |
/WIN=<window> |
Name of panel in registry to host a GPrimitive. |
Based on panel config |
/WIN.<cmd>= |
Similar to /WIN. |
Based on panel config |
/WPOS=(x,y[,w,h]) |
Set Window POSition and size of graphic.
(x,y) upper-Left corner of plot [required]
(w,h) width and height [optional] |
Based on panel config |
/WTITLE=<title> |
Window TITLE |
Name of macro |