SATAN Help
HINTS HOW TO HANDLE SATAN UNDER MICROSOFT WINDOWS
(Due to the flexibility of MSWindows most of the following solutions are not
unique. You might find even better ones. It is assumed that the installation of SATAN
is performed according to the procedure described in HELP INSTALL.)
1. CHANGE THE WINDOWS-EXPLORER TO LIST THE FILE QUALIFIER
For some of the applications below you need to change the qualifier of a file
(e.g. pictures.GRF, exec.SCOM, $SATAN.BAT). Changing the qualifier is possible in the
WINDOWS-EXPLORER when the qualifiers are listed. This is not the default option. To change
this option:
Start the WINDOWS-EXPLORER
Chose "VIEW - FOLDER OPTIONS - VIEW"
Deactivate "Hide file extensions for known file
types"
2. HOW TO START SATAN IN A SPECIFIC DIRECTORY
Use the WINDOWS-EXPLORER to create a dataset $SATAN.TXT. Enter SATAN in the
first line. Change the file qualifier from TXT to BAT. Now you can start SATAN by clicking
on the $SATAN.BAT file in the WINDOWS-EXPLORER in the actual directory. That means that
SATAN uses this folder for input and output as default.
3. EXCECUTE SATAN COMMAND WHEN STARTING SATAN
Create a dataset $INIT.SCOM and write the commands you want to be excecuted
when starting SATAN. The commands in $INIT.SCOM are executed automatically when SATAN is
started. The commands in \COMMANDS\$INIT.SCOM are executed even before, independently of
the folder where SATAN is started.
4. EXECUTE SATAN COMMANDS BEFORE LEAVING SATAN
Create a dataset $EXIT.SCOM and write the command you want to be
executed
before leaving SATAN. The commands in $EXIT.SCOM are executed automatically before
leaving SATAN. The commands in \COMMANDS\$EXIT.SCOM are executed first before leaving
SATAN in any folder.
5. PERFORM A SATAN ACTION WITH A DATASET
WINDOWS/NT allows to move a dataset name from the WINDOWS EXPLORER into the
SATAN
command windows by the mouse. SATAN is prepared to perform the appropriate action
automatically, e.g.
picture.GRF -> display the picture
exec.SCOM -> execute the command file
data.DMP -> fetch the data in the DMP file
data.LMD -> read the list-mode data
6. HISTORY OF COMMANDS
Preceding commands can be repeated.
WINDOWS/NT: Use the arrows up and down to select a command from the history.
WINDOWS95: Use the "<" and ">" characters as pseudo
commands in
SATAN to select a command from the history.
See also topic 8.
7. ROLLING BACK IN THE SATAN COMMAND WINDOW
WINDOWS/NT provides a window buffer which allows to roll back in the SATAN
command
window. To define the command buffer, see topic 8.
8. CHANGING THE PROPERTIES OF THE SATAN COMMAND WINDOW
CLick on the upper bar of the SATAN command window with the right mouse
button. Enter the desired options.
Recommended OPTIONS are:
Command Buffer Size 50
Number of Buffers 4
QuickEditMode OFF
InsertModus ON
Recommended LAYOUT is:
Window Buffer width 80
height 400
Window Size width 80
height 25
When leaving the menu, make these changes valid for all windows of this type.
9. DEFINING DEFAULT APPLICATIONS FOR SATAN FOLDERS
When clicking on the file name in the WINDOWS EXPLORER, the appropriate
application should be started automatically. Define the application in the following way:
START -> SETTINGS -> FOLDER OPTIONS -> TYPES
Define the following applications:
File application
*.GRF -> NOTEPAD EDITOR
*.SCOM -> NOTEPAD EDITOR
*.DMP -> NOTEPAD EDITOR
*.PLI -> E:\IBMPLIW\Bin\ibmwlx40.exe "%1"
(This language-sensitive editor is installed with the PL/I compiler. Depending on your
installation of PL/I, "E:" must be replaced by the appropriate drive letter of
your installation. This editor may also be used for other languages like Fortran,
C
10. INCLUDING FIGURES (EPS) IN WORD FILES.
Microsoft WORD supports postscript files only partly. They can be
included and printed, but they are not shown on the screen. However, there is a way to
include the figure in the WORD file, avoiding this disadvantage.
o Produce an EPS file from the GRAF figure by GCOPY
or GPLOT.
o Display the EPS file with the GSVIEW.
o Chose the appropriate size on the screen to get the required resolution. The size
may exceed the screen. The resolution needs to be rather high for good printing quality.
o Use the COPY option of GSVIEW to copy the bitmap of the figure to the buffer.
o Use the PASTE option of WORD to paste the figure from the buffer into the WORD file
on its appropriate position in the text.
11. USING THE PL/I DEBUGGER
The PL/I compiler provides also a debugger for interactively
debugging PL/I routines. The following actions have to be taken for running the user-defined analysis
routine with the debugger.
o Start a DOS command window in the folder FRSTOOLS\TRI.
o Enter the command "PLI GRAF (GONUMBER TEST)"
o Start a DOS command window in the folder which contains your analysis routine.
(In the following, the expression
"analysis-routine" has to be replaced by the name of your analysis
routine.)
o Enter the command "PLI analysis-routine
(GONUMBER
TEST)"
o Enter the command "SLINK analysis-routine.OBJ /DEBUG"
o Start the debugger (START->PROGRAMS->IBM VisualAge
PL/I->Debugger)
o Type the executable to be loaded: analysis-routine.EXE, however with the full
file name, e.g. C:\MYROUTINES\MYANALYSIS.EXE
o Specify the program language: "PL/I"
o Click on "load": The source text of GRAF.PLI appears in the debugger
window.
o Chose "source" -> "open new source" and
type "analysis-routine.PLI": The source text of your analysis routine
appears in the debugger window.
o You may set a break point by double-clicking on the line number.
o If you run the debugger the first time, enable "tool-tip evaluation"
in the "source" menu. If this option is activated, the values of the
variables are evaluated by putting the mouse on the variable name in the source
text.
o Work with the debugger as described in the help system of the debugger. (Basic
options are "step" to execute the next statement and "run"
to run the code up to the next break point.)
o SATAN can be controlled as usual by the SATAN command window. Consider that
the path where SATAN runs is the one of the PL/I debugger. Thus, in general full
path names have to be entered when SATAN commands refer to file names, e.g. "AFETCH
* / PATH(C:\RUNXX\MYANALYSIS) DSN(ALLDMP)".
o Additional information may be found in the PL/I help system (START ->
PROGRAMS -> IBM VisualAge PL/I -> INFORMATION -> PROGRAM
GUIDE
12. For looking up the usage of PL/I follow this link to the VisualAge PL/I Language Reference
of IBM .
