═══ 1. Overview ═══

          (C) Copyright International Business Machines Corporation 1993.
                                All rights Reserved.

                                 Augustus MMDCCXLIII AUC


                          IBM United Kingdom Laboratories Ltd.

This program may be of interest to those people who examine 370, 386 assembler, 
PASCAL(Ada), PL/AS(PL/I, REXX), C and FORTRAN etc. under OS/2. It was developed 
along with the CMS programme ANALYSE as part of the CICS restructure project to 
help understand convoluted 370 assemble programmes. 

This programme will provide basic browse functions for all files with a record 
size =<256 as well as highlighting specified keywords and allowing user defined 
Marker references and flow lines, and for language files such as 370 & 386 
Assemble, PASCAL, PL/AS, C, and FORTRAN etc. ALPHA will also draw branch flow 
lines from 'Jump/GOTO' instructions to labels in the same window, will display 
the programme call structure, and expand the procedure call in a secondary 
window. 

The programme is written in PASCAL and MASM for OS/2 using Presentation Manager 
calls. 


═══ 2. Installation ═══

The minimum requirement is to transfer the binary file 'ALPHA EXEBIN' to a 
directory on your PS/2 as 'ALPHA.EXE'. 

If you want different colours, fonts etc. you can copy the text file 'ALPHA 
PRF' to the PS/2 as 'ALPHA.PRF' and edit the file. You can also install the 
'Alpha' fonts by transferring the binary file 'ALPHA FONBIN' to the PS/2 as 
'ALPHA.FON' and using the 'Add font' command of the Installation menu on the 
'Control Panel' of OS2 V1.3. On OS/2 V2.x select 'System Setup' from 'OS/2 
System' and use 'Add' in the 'Edit font' of the 'Font Palette'. 

If you wish to access files from the host then you should also install a 
Transfer_pgm such as ALMCOPY from the OS2TOOLS disk. You can send commands to 
the host if you also install a Command_pgm such as OS2CMD. 

If you wish to access the OS/2 help file, ALPHA.HLP, it must be installed in 
the HELP path. 


═══ 3. Starting up Alpha ═══

The syntax for starting up the Alpha programme is :- 

[C:\]<START> ALPHA <file name> </p <profile name>> </m>

Where the option /m may be specified to cause the programme to be started 
minimised. This is intended for use in the 'STARTUP.CMD' file as an alternative 
to having the programme in the "Group - main" window, e.g. START ALPHA /p /m 

The option /p may be specified to cause the file of initial values of colours, 
font etc. to be read. The default file name for this profile is 'ALPHA.PRF'. 
This file may be used to set alternative start up values such as the keyword 
colours, see Profile. If a file name is not supplied on the OS/2 command line 
then the first display will ask for the file name to be browsed. The Enter key 
or Enter button should be used to terminate the string, e.g. 

    C:\WORK\TEST.A37<Enter_key>

On OS/2 V1.3 if  is minimised or active with or without a file allocated and 
the file manager window is active then a selected file may be moved from the 
file manager window by dragging mouse button 2 and releasing it over the  icon 
or main window. This will cause the new file to be allocated. 

Note:  If the window fails to appear the error, WinGetLastError, is written to 
       the OUTPUT device. 

This should be directed to a printer or file e.g. ALPHA >PRN | >file_name 


═══ 4. Description ═══

This programme may be used to browse any file with a record size =<256 and may 
also be used with language files such as :- 370, 386 assembler, PASCAL(Ada), 
PLS C, or PL/AS(PL/I, REXX) programmes etc. on a PS/2 under OS/2 to help in 
analysing their structure. 

The basic browse functions are :- 

  1. Home - Move to top of file 

  2. End - Move to end of file 

  3. Page_up - scroll up 1 screen 

  4. Page_down - scroll down 1 screen 

  5. F7 - scroll up 1/2 screen 

  6. F8 - scroll down 1/2 screen 

  7. F19 (Shift+F7) - scroll left 1/2 screen 

  8. F20 (Shift+F8) - scroll right 1/2 screen 

  9. The Horizontal and Vertical scroll bars. 

 The mouse button 1 when pressed will isolate the addressed string using ' ', 
 ',', '+' etc. as separators, and highlight it and all references in the window 
 or as the file is browsed. 

 In Locate mode if mouse button 1 is pressed twice (double clicked) then the 
 isolated string will become a search argument. If mouse button 2 is pressed 
 once (clicked) then the next occurrence of the search argument will be 
 located. If mouse button 2 is double clicked then the search will start at the 
 top of the file. 

 In Expand mode if mouse button 1 is double clicked then the search string is 
 assumed to be a label or procedure name and a second window is opened with the 
 procedure code provided the label/routine name can be found see Expand. 

 Search commands may be issued from the command window see Command window, 
 which may be invoked by the F6 key or the system menu icon 

 When the main window is displayed keywords which are associated with the file 
 extension will be highlighted using the colours specified in the profile. 

 With Flow on for language files branch flow lines will be drawn from 
 'Branch/GOTO' instructions to labels in the same window. 

 If the profile specifies Read_file=Yes, the default, then the the file may be 
 browsed as soon as the window is opened, performance then improves once the 
 file is read in. If the profile specifies Read_file=No then only 120 records 
 from the file are read in to storage and scrolling takes place within this 
 buffer unless F4+Ctrl is pressed when the whole file is read in to memory 
 asynchronously. As the file is scrolled up/down extra pages are read in to the 
 buffer. The affect is that on scrolling upwards, after the window is 
 displayed, there may be a pause (hour glass symbol) while extra data is read 
 in. 

 Small parts (=<window size) of the file may be remembered and redisplayed by 
 using the Clipboard function. Drag the mouse with button 1 down over the lines 
 to be saved and press Ctrl+Insert to save the highlighted lines. To redisplay 
 the saved lines press Shift+Insert. The lines are displayed from the cursor 
 position onwards. The highlighted records may be printed on LPT1 by pressing 
 Insert+Alt. 


═══ 4.1. Function keys ═══


The following keys are effective for the programme:- Mouse button 1 will 
isolate and highlight the text. If button 1 is pressed twice then the 
highlighted string may then be used as a search argument by button 2. 
Mouse button 2 will scan from the current position to the end of file for the 
locate string, i.e. the string isolated by button 1 or by use of a locate 
command from the command window (F6). If the mouse button 2 is pressed twice 
then the scan will start from the top of the file. 

F1 is the help key see Help window. 

 F1+Alt will display/hide the current status of the programme.

F2 will change the font. The System Monospaced font is the default font, unless 
the Alpha font is installed. 
F3 will terminate programme 
F4 will allocate a new file see Allocate window 

 F4+Ctrl will read the currently assigned file in to memory.

F5 will repeat the previous command 
F6 will issue a command 
F7 scroll up 1/2 screen. 
F8 scroll down 1/2 screen. 
F9 switch on/off comment suppression. A sequence of blank or comment lines will 
     be compressed to a single line of  provided that the file is read in. The 
     comment lines must begin with characters specified in Comment_start and 
     terminate with the characters specified in Comment_end. 
 F10 not used. 
 F11 not used. 
 F12 will move the mouse button 1 focus line to the centre of screen. 

    F12+Ctrl will switch on/off the scale line in the centre of the window.

 F13 (shift+F1) will display the programme structure. 
 F14 (shift+F2) will change the text colours. 
 F17 (shift+F5) will locate the next Marker. 
 F19 (Shift+F7) will scroll left 1/2 line. 
 F20 (shift+F8) will scroll right 1/2 line. 
 F24 (shift+F12) will reset the horizontal scroll, clear line markers etc. 
 Page_Up will scroll up one page. 
 Page_Down will scroll down one page. 
 Home key will move to top of file. cruise xb1 End  key will move to end of 
 file. 
 Insert+Ctrl will place mouse Button 1 drag area in Clipboard. 
 Insert+Shift will copy Clipboard text to mouse Button 1 position - cursor. 
 Insert+Alt will write the highlighted records to LPT1. 
 Ctrl+Delete will remove the highlighted records, mouse button 1 drag area, 
 from the window display. 
 Shift+Delete will restore the deleted records to the window display. 
  and  keys will move the cursor. 
 The scroll arrows, slider etc. and Page up or Page down keys may be used for 
 browsing. 
 Enter key will terminate an input string or refresh the screen. 


═══ 4.2. Help window ═══

This window may be invoked by the F1 key or the Help button on the command 
window. The window may be scrolled by :- 

  1. Page_up - scroll up 1 screen 

  2. Page_down - scroll down 1 screen 

  3. Home - scroll to the top of the Help data 

  4. End - scroll to the end of the Help data 

  5. F7 - scroll up 1/2 screen 

  6. F8 - scroll down 1/2 screen 

  7. The Page_Up key word at the bottom of the window will scroll up 1 screen 
     if selected by mouse button 1. 

  8. The Page_Down key word at the bottom of the window will scroll down 1 
     screen if selected by mouse button 1. 

  9. Access to the OS/2 help file ALPHA.HLP is provided by selecting the ? from 
     the system menu. 

 The Help window may be cancelled by F3, the Cancel button or by Enter. 


═══ 4.3. Allocate window ═══

The File Allocate window will be created by the F4 key or from the Allocate 
menu item of the command window. The file may be selected from the List box or 
typed in to the Entry box. The drive may be changed by selecting [a:] from the 
List box or typing the drive letter followed by a ':' e.g. 'a:' in the Entry 
box. The Path may be changed by selecting a directory name from the List box or 
by typing the path name in the Entry box e.g. 'C:\WORK'. The COMBO box will 
hold the last three allocate texts which have been entered. 

A host file may be received and allocated by entering 

>H:fn ft fm PC_file_name

this string is passed to Transfer_pgm (ALMCOPY) {without the '>' and with '/Q' 
appended} which must be installed on the PS/2. If Transfer_pgm fails the return 
code is displayed in red and the Entry text is left to be edited. If the 
requested file can not be allocated then the allocate window together with an 
error message will be displayed. 

A host command may be executed by entering '<host command'; this string is 
passed to Command_pgm (OS2CMD) {without the '<'} which must be installed on the 
PS/2. 

If the DosExecPgm call fails for either Transfer_pgm or Command_pgm then the 
error code is displayed in black. 

Note:  If the Allocate window can not be contained in the main window then it 
       will be made sysmodal; i.e. it must be closed before other windows can 
       be used. The programme has been tested on an 8513 screen and the default 
       Window and Default_chr values may not be suitable for 8515 & 8514 
       screens. For 8515 type screens more suitable values for the Window & 
       Default_chr keywords in the profile might be Window=(0,60,800,600) and 
       Default_chr=(14,20), for example. 


═══ 4.4. Command window ═══

This window may be invoked by the F6 key or the system menu icon The following 
commands may be issued :- 

  1. +n - scroll down n lines 

  2. -n - scroll up n lines 

  3. <n - scroll left n characters 

  4. >n - scroll right n characters 

  5. :n - go to record n 

  6. / - Search for string, not case dependent, from the current position in 
     the file 

  7. " - Search for string, as typed, from the current position in the file 

  8. ' - Search for string, as typed, from the current position in the file but 
     only in column 1 

  9. (s-e)>file_name - will copy records from the current file starting at s 
     and ending with e to the file file_name; file_name may be 'LPT2' etc., an 
     existing file or a new file. If the end record number is '*' then the file 
     is copied to end-of-file. 

 10. (s-e)- - will remove the records from the window. 

 11.  &  will cycle through the last 6 commands. 

 12. The Delete|Backspace key will delete a character from the input text. 
 If the first character is invalid then the line will be filled red until it is 
 deleted. F3 or ENTER will close the window and enter the command. The cancel 
 button will remove the window; only this child window will receive input until 
 it is terminated. 

 The Help button will start the Help summary widow or access the OS/2 help file 
 ALPHA.HLP. 

 The Flow button will switch on/off the drawing of flow lines. These lines are 
 drawn for language files from 'Branch/GOTO' instructions to labels within the 
 window. 

 The Expand/Locate button will switch on/off the label expansion. The isolated 
 label is expanded by locating the routine and opening a second window 
 containing the code. The mouse button 1 must be pressed twice (double clicked) 
 to cause the label to be located. A depth of 8 expand windows is allowed, and 
 each window may be scrolled using the scroll bar, Page_Up, Page_Down, etc. The 
 file must be read in to storage to use this facility. The Expand window may be 
 closed by F3 or the CALL menu item when the main window will remain at the 
 CALL. If the Routine menu is clicked then the main window will scroll to the 
 expand text, i.e. the called code line may be passed back to the higher level 
 window. The Locate menu or F6 will perform a case sensitive forward search 
 from the current line+1. F5 will repeat the previous locate. If Button 2 is 
 double clicked after moving to the expanded label then the window will be 
 moved back to the previous line, i.e. return to point of call. The label 
 searched for is succeeded by ":" for PLS and preceded by "FUNCTION" or 
 "PROCEDURE" in PASCAL. The label searched for is preceded by "char", "extern", 
 "far", "int", "long", "pascal", "pointer", "short",  "static" or "void" if the 
 language type is C The label searched for is preceded by "FUNCTION" or 
 "SUBROUTINE" if the language is FORTRAN. 

 The operators for langauages other than the C-language may be specified by the 
 Language_operator  keyword in the profile. 

 The Mark button will switch on/off the drawing of user flow lines defined by 
 the mouse button 1, or the setting of a marker. Up to 16 user lines or markers 
 may be associated with the file. If mouse button 1 is double clicked then a 
 marker will be associated with the line. If mouse button 1 is pressed once 
 then it will delimit the ends of a flow line. The markers or flow lines remain 
 associated with the record until F24 (Shift+F12) is pressed. The markers 
 enable places within the file to be remembered and recalled by (Shift+F5). 

 The Options menu may be selected to change the state of the following options 

  1. Transient Options - reset when a new file is allocated. 

     a. Comment Suppression - replace a block of comment lines by one 
        highlighted line of . 

     b. Statement # - will display the current line number in the TITLE bar. 

     c. Scale - place a scale line in the middle of the window. 

     d. Status - indicate in the top left of the window the current status of 
        file reading etc. 

  2. Permanent Options - remain set when a new file is allocated. 

     a. Quiet - suppress the beep which indicates that the file is read in to 
        storage. 

     b. Read_file_when_allocated - when the file has been allocated read it in 
        to storage by attaching a subtask. The file may be browsed whilst this 
        is in progress but the reading of the file in to storage will be 
        slower. 

     c. Record_structure - for language files this will cause the calling 
        structure to be recorded when the file has been read in. 

     d. Tab - recognize tab characters, X'09', and skip to n*8. 

     e. Proportional - use the font spacing for writing the characters rather 
        than the character size; this will allow proportional fonts to be used 
        however these are not suitable for displaying code. 

     f. Keyword - allow or suppress the keyword highlighting. 
 The Allocate menu will create the Allocate window, see Allocate window. 

 The Structure menu may be used to display the call structure for 370, 386 
 assembler, PASCAL, PL/AS, C and FORTRAN programmes provided that the 
 Record_structure option is effective when the file is read in. For 370 
 assembler the structure is based on BAL, BAS, DFHSTACK, for 386 assembler 
 CALL, PROC instructions, for PASCAL PROCEDURE, FUNCTION , keywords, for C 
 char, extern, far, int, long, pascal, pointer, short, static or void keywords, 
 for PL/AS PROC, CALL, keywords, for FORTRAN FUNCTION, SUBROUTINE, CALL, 
 keywords {Labels >=27 characters are ignored}. If an entry is selected from 
 the Programme Structure List Box then the main window is scrolled to that 
 line. The Print button may be used to print the contents of the List box on 
 LPT1. 

 The Font menu may be used to dynamically change the font and character size; 
 the change is not saved in the profile, see FONTs. 

 The Colour menu may be used to dynamically change the text colours. The 
 language keyword colours must be specified in the profile. 


═══ 4.5. FONTs ═══

You can specify the initial/default font in the profile by using the Font 
keyword in the profile, or you can change the font dynamically by invoking the 
Font window. 

You can use the System Monospaced, Helvetica, Roman and Courier fonts but the 
Courier font and the System Monospaced are the only monospaced fonts supplied 
with OS/2. A monospaced font with point sizes 8,9,10,11,16 & 20 is supplied 
with the ALPHA PACKAGE, which may also be used. See Installation for the 
installation of the Alpha Fonts. The fonts are then requested by specifying 
Font="Alpha",(10) etc. in the profile. The font type or face_name and size may 
be selected by the Font and Character_size keywords in the profile. If a 
profile is not supplied then the "Alpha",(10) {(16) for 8515/8516 screens} font 
will be used if it is installed and a character_size of (8,14) else the "System 
Monospaced",(10) font will be used and a character_size of (8,16). Outline 
fonts are not selectable. 

If the point size is not specified then the font is selected by using the 
Character_size. Point sizes (1/72") are :- Courier (8,10,12), Roman 
(8,10,12,14,18,24), Helvetica (8,10,12,14,18,24), System (8,10,12, {8x8, 8x16, 
9x20}), "Alpha" (8{8x12}, 9{9x10}, 10{8x14}, 11{11x12}, 16{12x16}, 20{12x20}). 
If the point size is specified but an image font does not exist for this 
nominal point size then the outline font, if available, will be used and scaled 
by the Character_size. The font may be requested by face_name, e.g. 
Font="Alpha",(8). 


═══ 4.6. Profile ═══

A profile may be specified defining the following keyword values :- 


{Colours may take the values :- BLUE, DARKCYAN, BLACK, DARKBLUE, DARKPINK, 
DARKGRAY, DARKRED, DARKGREEN, BROWN, CYAN, RED, GREEN ,PINK, YELLOW, PALEGRAY, 
DEFAULT, WHITE} 


Text_colour specifies the colour of the window text. 
Highlight_colour is used for the isolate function of mouse button 1. 
Locate_colour is used for the argument for the locate function 
Comment_colour The first comment_colour is used for comment line beginning :- 

/*, {, *, ;, C

and for the 'scale' background. The second comment_colour is  used for the 
compressed comment line and for the Clipboard highlight. 
Branch_colour is used for 370, 386 branch instructions. 
Expand_colour is used for the text in the label expansion window 
Back_ground is use to specify the main window background colour. 
File_type specifies the File types to be recognized. The string must be =<64 
characters and terminated by a comma. The first 6 types are used for :- 

  1 370 assembler
  2 386 assembler
  3 PASCAL, (Ada)
  4 PL/S, PL/AS, PL/I  etc., (REXX)
  5 C
  6 FORTRAN
 For REXX files use :- "A37,ASM,PAS,CMD,C,FOR," and replace the PLS entries
 For Ada  files use :- "A37,ASM,ADA,PLS,C,FOR," and replace the PAS entries

Comment_start specifies the first two characters of the start of a comment. The 
string must be =<12 characters.  The 6 pairs are used for :- 

  1 370 assembler
  2 386 assembler
  3 PASCAL, for Ada specify Comment_start="* ; --/*/*C "
  4 PL/S, PL/AS etc.
  5 C
  6 FORTRAN

Comment_end specifies the last two characters of the end of a comment. The 
string must be =<12 characters.  The 6 pairs are as in Comment_start. 
Precedent_C specifies the C language procedure keywords. The string must be 
<=64 characters and terminated by a comma. 
Precedent_C="char,extern,far,int,long,pascal,pointer,short,static,void," 
Language_colour  defines the highlight colours for key words. Up to 128 entries 
may be defined as follows :- 

 file_type,key_word,colour,scan_length
and are terminated by .END, invalid entries are ignored. The key words must be 
=<12 characters. 
Language_operator defines the operator keywords for each language. The second 
value indicates how to process the keyword, viz. '<' or '>' indicate the scan 
direction from the keyword to locate the label 'P' or 'C' indicates that the 
keyword specifies an entry point or call, ':' indicates that the label will be 
followed by a colon, '2' indicates that the second label following a , is to be 
used. Up to 32 entries may be defined as follows :- 
file_type,<|>C|P[:][2],keyword and are terminated by '.END', invalid entries 
are ignored. The keywords must be <=12 characters. {The C-language procedure 
values are supplied on the Precedent_C keyword.} 
Font  may take the values :- 
Courier|System|Helvetica|Roman|Alpha<,Bold|Italic><,(Point_size)> or a face 
name may be specified e.g. Font="Alpha",(10) 
Character_size specifies the (width,height) of the characters The character 
width is used to select the size of the font if the  point size is not 
specified on the "Font" keyword. 
Read_file takes the value Yes|No and specifies whether the file is to be read 
in after allocation. 
Flow takes the value On|Off and specifies whether to draw flow lines from 
branch statements to labels. 
Expand takes the value On|Off and specifies that Expand mode will be effective 
once the file is read in. 
Marker takes the value On|Off  and specifies whether mouse button 1 will define 
marker values. 
Language takes the values :- 

 *<,Language> - determine the language from the file suffix.
If a Language is all so  given then this will be the default if the file type 
can not be found in "File_type", e.g. Language=*,PAS.  For PL/I use 
Language=PLS etc. 

 A37 - 370 assemble
 ASM - 386 macro assemble
 PAS - Pascal
 PLS - PL/S or PL/AS etc.
 C  - C language
 FOR - FORTRAN

Default_chr specifies the default character width and height used for scaling 
the Allocate and Command dialogue boxes. The default value is (10,16) {(14,20) 
for 8515/8516 screens}. 
Window specifies the initial window position. If no profile is specified then 
Window=(0,4h,63.5w,26h) {(0,120,1020,650) - for 8515/8516 screens} is assumed 
where w and h are the Default_chr  width & height. 
Quiet will suppress the beep on completion of file read. 
Record_structure will record the CALL structure for 370 & 386 assembler, 
PASCAL, PL/AS, C and FORTRAN programmes, as the file is read in to memory. 
Tab will use X'09' as the tab character to move to column n*8 when file is 
read. 
Proportional will use the Font character spacing rather than the Character 
width to place the characters. 
Keyword will highlight the specified keywords. 
Statement_number sets the display of the statement number On|Off 
Command_pgm specifies the programme name invoked by <. 
Transfer_pgm specifies the programme name invoked by >. Alpha has within it 
(hard coded) routines which understand certain language features e.g. 370 
Assembler labels start in start in column 1, procedures are invoked by BAL, BAS 
etc. and PASCAL procedures are preceded by FUNCTION or PROCEDURE etc.. There 
are 6 languages understood by Alpha, viz. :- 


 1 370 Assembler
 2 386 Assembler
 3 PASCAL (Ada)
 4 PL/AS (PL/I, REXX)
 5 C
 6 FORTRAN

Because Ada is similar to PASCAL and PL/I & REXX are similar to PL/AS, in 
respect to procedure calls etc., you can also analyse these languages by 
pretending they are type 3 & 4 respectively. 


However, you can interpret any language/file type (use the highlighting 
facility) by suppling extra definitions in a profile which is specified as a 
parameter to Alpha e.g. 


 START ALPHA /p profile_name

A sample profile (ALPHA.PRF) is provided in the package, which includes 
comments explaining the use of the keywords. This may be edited to change/add a 
file extension, highlighting and programme structure by modifying the following 
keywords :- 


 File_type - list of file extensions up to 64 characters
 Comment_start - list of comment start character pairs
              (blank is ignored) up to 12 characters
 Comment_end - list of comment end character pairs
              (blank is ignored) up to 12 characters
 Language_colour - list of keyword definitions
          file_type,keyword,colour,maximum scan length
 Language_operator - list of operator definitions
          file_type,attributes,keyword

e.g. to add language XYZ with  a routine call 'ICALL routine_name' with a 
structure similar to PLS. 


File_type="A37,ASM,PAS,XYZ,C,FOR," 
Language_colour 
XYZ,ICALL,GREEN,72 
XYZ,Next_key ,RED,72 

Language_operator 
XYZ,>C,ICALL 

Only the first 6 language types will allow the Expand, Flow and Structure 
operations to be effective. This implies that you could not use all the 
features of Alpha for a new language which did not have the call/label syntax 
of one of the existing languages. 


The Alpha programme scans the keyword table in the order specified in the 
profile to the comment start in the record for a maximum of 16 found entries. A 
keyword_found array is created and the text is written by running down the 
array from the last to the first so if the entries in the profile were in the 
order :- 


PLS, END LOOP,GREEN,72 
PLS, END,DARKCYAN,72 


Then the 'END LOOP' would overwrite the 'END'; spaces are significant. The 
following is the sample profile which may be edited to change the startup 
values :- ALPHA.PRF 


═══ <hidden>  ═══

Specify Language=PLS in the profile for PL/S, PL/AS etc. or use a file type of 
".PLS". Because PL/I is similar to PL/AS you can use this file type for PL/I 
files. For REXX files, extension ".CMD", replace PLS by CMD in the File_type 
and replace the PLS entries in the Language_colour by the CMD entries. {Only 
"CALL" or "call" subroutine calls will be recognized.} For Ada files, extension 
".ADA", replace PAS by ADA in the File_type and replace the PAS entries by the 
ADA entries in the profile. Also specify Comment_start="* ; --/*/*C " for the 
Ada comment start characters. 


═══ <hidden>  ═══

Up to 128 language keywords may be specified with their corresponding colour 
and the length of the record to be scanned. Only the first 16 key words on the 
line will be highlighted and the search order is the order specified in the 
profile. The keyword must be =<12 characters. The File_type keyword in the 
profile may be used to introduce extra file types but the first 6 types are 
assumed to refer to :- 370 assembler, 386 assembler, PASCAL, PL/AS, C and 
FORTRAN in that order. 


═══ <hidden>  ═══

Only the first 256 characters of a record are read. Once the file is read in 
there is an internal switch over. If a locate etc. was in progress at the time 
of the switch over the window may not display the line found; it may be 
necessary to repeat the command e.g. F5. 


═══ <hidden>  ═══

This function may be selected from the Command window which may be brought up 
from the system menu icon 


═══ <hidden>  ═══

The statement number is displayed in the TITLE bar. R indicates that the file 
is being read in to memory, S indicates that the programme structure is being 
recorded. 


═══ <hidden>  ═══

A separate thread is attached to read in the file whilst the file may continue 
to be browsed within the 120 record buffer. The scrolling of the file will be 
much faster but there may be some degradation of performance while the file is 
read in to store. A maximum of 21,844 records can be read in if there is enough 
memory available. When the file is read in there is a beep of 1760HZ and then 
one of 880HZ to indicate that recording of the programme structure is complete, 
provided that "Quiet=No" is specified in the profile. 


═══ <hidden>  ═══

This window may also be created from the system menu icon A child window is 
created in to which may be typed the command. 


═══ <hidden>  ═══

The line on which mouse button 1 was last pressed. 


═══ <hidden>  ═══

If the mouse button 1 is kept depressed then the lines or characters will 
scroll at 1 per second until the button is released. If the file is not read in 
then the file size is estimated by adding 1000 every time the internal array is 
filled. In this case the slider may be move to the end of the vertical scroll 
bar before end_of_file is reached and then move up. 


═══ <hidden>  ═══

The file ALPHA.HLP must be installed in the help path. 


═══ <hidden>  ═══

The C language keywords may be specified by the Precedent_C keyword in the 
profile, and the operators for the other languages by the Language_operator 
keyword.