ArborX


!

Longname: !   Open the Documentation Legend
Released: not available 
Created: not available 
Last modified: 6.52a 
See also: event

Summary
Shells out of Arbortext APP to DOS. You can run a DOS command from Arbortext APP using ! to shell out to DOS or, more smoothly, ! ! to carry out a DOS command and return you to Arbortext APP. Before running the shell macro, you may need to configure Arbortext APP to allow more memory to other programs. For more information see the Installation manual.)
Example extract

On a single-monitor system you can enclose the shell command within brackets, and follow it with a wdr macro to redraw Arbortext APP's screen once the command has been carried out, e.g.:

 ( ! ! dir):wdr

Syntax (SVNNA)
! Ø
!  keyword:b?
keyword:b

The DOS command to be run when you shell out of Arbortext APP. If you do not specify a command the message Type 'exit' to return to 3B2 will be displayed over the command-line prompt when you shell out to DOS. If a command has been specified the message Press any key to return to 3B2 will be displayed on your screen after it has been executed.

If you use two exclamation marks command will be run, and you will be returned to 3B2 automatically. This is particularly useful on dual-monitor systems, where the second monitor can be used to display DOS activity without conflicting with Arbortext APP's own display.

You should never attempt to restart Arbortext APP when shelled out of the program. Doing so will probably cause your system to hang. (You could try including an exit command at the start of your 3b2.bat file if you find that you are frequently trying to restart Arbortext APP whilst shelled out; this should not do anything when you are not shelled out.)
Example

The macro below will make a new directory.

 ! ! md c:\temp\chris_temp
Example

Another use for the shell macro in this form can be to 'echo' text to an ascii text file. This could be useful if you need to keep track of, for instance, the time spent on a particular project and need to keep a record of your hours; or, more ambitiously, to send data from a Arbortext APP script to a database or billing system.

The first macro shown below opens a new text file with the words 'WORK RECORD' on line 1. Note that any file of the same name will be overwritten:

 !! echo WORK RECORD >c:/3d/mytime.txt

You could then add details, using the DOS echo command with two >> characters:

 !! echo Corrections to text file, 5hrs >>c:/3d/mytime.txt

The text file would now contain two lines as shown below:

 WORK RECORD 8
 Corrections to text file, 5hrs 10
Example

The example below will run MS OUTLOOK when executed, or any other application given the correct path name:

 !!start "" "C:\Program files\Microsoft Office\Office\OUTLOOK.EXE"

Or a simplified version, this will run Word Perfect when executed:

 ! wp
Example

The example below will open the Advent 3B2 web site.

 !!start "" "http://www.3b2.com"
Example

You can also use DOS redirection filters. The macro shown below would produce a directory listing in the file list.txt.

 !! dir >list.txt

Document created on 08-Feb-2003 (revision 1)