═══ 1. Introducciв ═══

Aquest programa mostra per pantalla diferents informacions sobre els recursos 
del sistema, i les actualiza una vegada per segon, si es que el processador tВ 
temps per a fer-ho. Les informacions mostrades sвn: 

Data/Hora - La data i hora actual, en el format normal de cada paбs, depenent 
de com estigui configurada la lбnia 'COUNTRY=' al fitxer CONFIG.SYS 

Temps transcorregut - El temps que ha passat des de la darrera ocasiв en que 
s'ha arrencat l'ordinador. 

Messages Waiting - The number of messages waiting to be downloaded. 

Physical Memory Free - La quantitat de memХria lliure del sistema, d'acord amb 
allХ que la funciв DosMemAvail indica. 

Nota:   This function is part of the old 16-bit system, and only reports 
physical memory below 16Mb, and was also altered just before OS/2 2.0 was 
released to never report less than 512K. 

Nota:   If you have the IBM system analysis program Theseus/2 installed on your 
system, this number will be completely accurate, though it will only update 
itself once every ten seconds at most. 

Virtual Memory Free - The amount of virtual memory available, according to the 
DosQuerySysInfo function. This is the amount of free physical memory, plus the 
amount of free space within the current swapping file, plus the amount of space 
by which the swapping file could yet grow, less the amount of free space 
reserved on the swapping drive. 

Tamany del fitxer d'intercanvi - El tamany que ocupa al disc el fitxer de 
memХria virtual d'intercanvi (swap), SWAPPER.DAT. Per localitzar aquest fitxer, 
busqueu al fitxer CONFIG.SYS la lбnia que comenЗa amb SWAPPATH, on trobareu 
indicat el nom complet (inclХs el directori) del fitxer d'intercanvi, aixб com 
l'espai que cal reservar a la unitat on es troba situat aquest fitxer. 

Espai disponible pel fitxer d'intercanvi - La quantitat total d'espai a la 
unitat de disc on es troba el fitxer d'intercanvi, menys la quantitat d'espai 
que cal reservar. Aquest valor Вs el tamany mЕxim que pot utilitzar el fitxer 
d'intercanvi. 

Unused Swap Space - The amount of free space within the currently allocated 
system swap file.  When this drops to zero, the system swap file must be 
increased in size, normally by one megabyte at a time. 

Nota:   If you have the IBM system analysis program Theseus/2 installed on your 
system, this number will be completely accurate, though it will only update 
itself once every ten seconds at most. 

Tamany del fitxer d'spool - La quantitat total de disc consumida pels fitxers 
enviats a l'spooler d'impressora. 

Percentatge d'гs de la CPU - El percentatge aproximat d'гs del processador. El 
valor que es mostra Вs el percentatge corresponent al promig d'utilitzaciв del 
darrer segon. 

Nota:   Under versions of OS/2 before release 4.0, aquesta funciв i el PULSE 
que s'inclou amb l'OS/2 2.0, no sвn gaire compatibles. Why? 

Nota:   Under versions of OS/2 before release 4.0, if you have the driver 
HRTIMER.SYS installed, this number will be more accurate. Why? 

Average Load (%) - The approximate percentage of the CPU's available power that 
has been used in the recent past.  The number of seconds to be averaged may be 
configured by the user (see the Configuration dialog). 

Battery - The current battery capacity remaining, or its status (Charging, AC) 
is displayed. 

Nгmero de tasques actives - El nгmero d'entrades a lliista de finestres, que Вs 
la llista de veieu quan premeu CTRL-ESC. 

Nota:   No totes les tasques del sistema sвn mostrades a la Llista de 
Finestres, donat que algunes tasques no sвn visibles. 

Process Count - The number of processes currently loaded on the system. 

Thread Count - The number of threads currently running on the system.  There is 
at least one thread for each process. 

Espai lliure total - La suma de l'espai lliure a totes les unitats locales de 
disc no removibles. 

Espai lliure a la unitat X - La quanitat total d'espai lliure a la unitat de 
disc X. 

Aquesta ajuda Вs sensible al contexte, com ja se n'haureu adonat. L'accВs a les 
segБents funcions es fa a travВs del menг de sistema de la finestra: 

      Restaurar els valors per defecte 
      Amagar els controls 
      Configuraciв... 
      Reset Load Meter 
      Reset Average Load 
      Reset Drives 
      Launch E-Mail Reader 
      Copy 
      Informaciв del programa 
      Close 

 A mВs d'aquestes funcions descrites, el programa accepta ordres dels 
 controladors de fonts i de la paleta de colors de l'OS/2 2.0, and is a DDE 
 server for all the currently displayed items. The DDE application name is 
 MEMSIZE, and the item names are the same as the default display item names 
 (like Physical Memory Free). 


═══ 2. Restaurar els valors per defecte (Opciв del menг) ═══

Seleccionant aquesta opciв del menг, es restaura el tipus de lletra i els 
atributs de color als seus valors per defecte. 


═══ 3. Amagar els controls (Opciв del menг) ═══

Aquesta opciв del menг, quan estЕ seleccionada, fa que els controls de la 
finestra del programa (el menг de sistema, la barra del tбtol i el botв de 
minimitzaciв) s'amagin. Рs possible variar el valor d'aquesta funciв si premeu 
dues vegades el botв del mouse dintre de la finestra. 

La tecla acceleradora assignada a aquesta funciв Вs ALT+H. 


═══ 4. Configurar (Opciв del menг) ═══

Quan seleccioneu aquesta opciв del menг es visualitzarа la pantalla de 
configuraciв del programa. For more information, see Configure (Dialog). 

Nota:   La tecla acceleradora assignada a aquesta funciв Вs Alt+C. 


═══ 4.1. Configure (Dialog) ═══

This notebook dialog allows you to change all the configurable aspects of this 
program's operations.  The configuration options are grouped by category on the 
following pages: 

      Elements 
      Options (Page 1) 
      Options (Page 2) 
      Colors 
      Anchor 
      Date Format 
      E-Mail (Page 1) 
      E-Mail (Page 2) 

 All changes take effect immediately. 


═══ 4.1.1. Elements (Configuration Page) ═══

This page displays a list of displayable items. Podeu seleccionar qualsevol, o 
tots, els elements que voleu que s'incloguin a la finestra del programa. NomВs 
heu de marcar els elements desitjats fent un click al seu damunt per marcar-lo, 
o bВ desactivar-los amb un segon click. Tots els elements marcats sвn els que 
es visualitzaran. To change an item's default label, or to adjust its warning 
and/or error thresholds, either double-click mouse button one on the item list 
entry, or single-click mouse button two on the entry.  In either case, the Item 
Attribute dialog will be displayed. 


═══ 4.1.2. Options (Page 1) (Configuration Page) ═══

This page shows a number of program options that may be activated or 
deactivated. 

Amagar els controls Quan el programa no estЕ en forma d'icona, el podeu veure 
amb o sense els elements normals de les finestres: barra de tбtol, menг de 
sistema i els botons de maximitzar i minimitzar. If you chose to hide these 
controls, the window may still be positioned by dragging its center area. 

Restar en primer pla Aquest botв activa la funciв que fa restar la finestra del 
programa sempre en primer pla. Quan aquesta funciв estЕ seleccionada, la 
finestra del programa estarЕ sempre al primer pla de visualitzaciв, de forma 
que sigui sempre visible. 

Animaciв Aquest botв activa les funciв d'animaciв a l'obrir i tancar la 
finestra. Quan estЕ activa, la finestra del programa s'obrirЕ de la mateixa 
forma que ho fan les carpetes: amb so i moviment. De la mateixa forma que amb 
les carpetes, no hi haurЕ cap animaciв si ha estat deshabilitada a nivell de 
sistema. 

Dialog Border This button determines whether the main program window will have 
a simple line border, or a more elaborate dialog border.  The line border 
requires less space on the screen, but the dialog border can look better, 
especially on OS/2 Warp 4.0 or later, which gives this border style a 
three-dimensional appearance. 

Table Format This button, when checked, causes the window to arrange itself in 
table format, with the display items arranged in rows and columns. It will 
optimize itself to use as little vertical space as possible. When this button 
is not checked, the window will arrange itself with a single column of all the 
displayed items. 

Hourly Chime This button activates an hourly chime feature.  When active, the 
program will beep twice at the top of every hour. 

Show Disk Drives When this button is checked, disk drive free space is 
monitored, subject to the restrictions placed on this monitoring by other 
options. This control mainly exists as a way to disable disk monitoring. 

Show Remote Drives When this button is checked, remote (network) drives that 
are currently attached to the system are monitored in the same was as local 
nonremovable drives are, except that they are not included in the Total Free 
Disk Space item. 

Mostrar el nom del sistema de fitxers Si aquest botв estЕ marcat s'indicarЕ, a 
mВs d'indicar l'espai lliure a la unitat el nom del sistema de fitxers que 
utilitza la mateixa. L'гs d'aquesta opciв comporta un tamany de finestra mВs 
ampla. 

Show Disk Labels This button causes the individual drive free space entries to 
show their disk labels.  Use of this option results in a wider monitor window. 

Show Seconds This button causes the clock and elapsed time displays to include 
the seconds of the minute. 

Use Theseus/2 This button causes the program to make use of IBM's utility 
program Theseus/2, if it is present, for such things where it provides more 
accurate information than can be found otherwise.  Due to the large overhead of 
using it, however, Theseus/2 never polled more than once every ten seconds. 
Currently, this feature provides better measurement of free physical memory and 
unused swap space. 

Center Clock This button causes the clock display to be centered within its 
allocated cell, rather than left-justified. 


═══ 4.1.3. Options (Page 2) (Configuration Page) ═══

This page shows additional program options that are more complex than simply 
on/off. 

Show 'K'ilobytes This group of radiobuttons allows you to select whether large 
sizes are displayed in kilobyte notation always, never, or only when their 
values exceed 512K. The default is to show all sizes over 512K in this way. 
The 'K=1024' button, if checked, causes the numbers to be displayed in true K 
(1024).  If not checked, the numbers are displayed in decimal K (1000). 
The 'M'egabytes button, if checked, will cause the numbers to be displayed in 
megabytes once their values exceed eight megabytes. 

Prioritat de monitoritzaciв Aquesta opciв us permetrЕ establir el valor de 
prioritat del thread de monitoritzaciв, dins la categoria de temps-crбtic. 
Podeu variar la prioritat entre 0 i 31. La prioritat 31 Вs el valor mВs elevat 
al sistema per sota de les interrupcions fбsiques. La prioritat 0 Вs el valor 
mВs baix dins la categoria de temps-crбtic. Normalment, aquest valor ha d'estar 
configurat al mЕxim per a obtenir un valor mВs acurat. No obstant aixХ, alguns 
usuaris han informat que, ocasionalment, perden algunes dades a les 
comunicaciones que es fan mentres el programa estЕ en funcionament. Рs per 
aquesta raв que la prioritat Вs ara configurable. 

Interval de temps Aquesta opciв us permetrЕ establir l'interval d'actualitzaciв 
de la finestra. Pot variar entre 1.0 segon i 30.0 segons, en increments d'una 
dКcima de segon. El nгmero que es mostra estЕ en dКcimes de segon. 

Averaging Interval This control allows you to set the interval over which 
averages are computed.  It can be varied from 10 seconds to 3600 seconds (one 
hour). 


═══ 4.1.4. Colors (Configuration Page) ═══

This page shows the three sets of colors associated with the Normal, Warning 
and Error levels of those display items which support them.  You can set these 
colors by dragging colors over from one of the system color palettes. 

Nota:   Under OS/2 Warp 3.0 or beyond, if you click on the color samples with 
either mouse button, the system's Solid Color Palette window will be displayed 
for your convenience.  The Mixed Color Palette can also be used, but must be 
requested from the System Setup folder. 


═══ 4.1.5. Anchor (Configuration Page) ═══

This page contains a control with which you can set the corner of the monitor 
window which remains fixed in position when the window size changes.  The 
monitor window can change in size when items are added or removed from the 
active list, and when the display font is changed from the Font Palette. 


═══ 4.1.6. Date Format (Configuration Page) ═══

This page allows you to specify the format with which the date & time item will 
be displayed.  Any text you would like may be entered, and special function 
codes can be included.  The entire list of valid function codes is provided in 
a list at the bottom of the page, and by double-clicking on any item in that 
list the item is immediately inserted into the current format text.  A sample 
result text, with the function codes expanded, is given right below the format 
text entry field. 


═══ 4.1.7. E-Mail (Configuration Page) ═══

This page allows you to specify the parameters by which the Message Count item 
obtains its information.  You must specify a POP3 server name, the user name 
and the password for the user.  You can optionally specify a POP3 port number 
if your server uses a different one from the customary. You can also force the 
usage of a specific IP address. 

The option to use APOP allows you to use an enhanced password validation 
protocol which reduces the exposure your ID and password get on the open 
network. 

Next Page... 


═══ 4.1.8. E-Mail (Configuration Page) ═══

This page allows you to specify the parameters by which the Message Count item 
reacts to its information. 

The Polling Interval field allows you to set the number of seconds to delay 
between each check of the post-office for new mail. 

The E-Mail Reader field is for specifying the command line to be used to launch 
your preferred mailer program. 

The Alert When Mail Arrives checkbox determines whether or not the program 
sounds an audible alert when new mail arrives. 

The Mail Alert Sound field is for specifying a .WAV file to be played upon the 
arrival of new mail.  If no WAV file is specified, and sound is requested, then 
an ascending sequence of tones will be generated from the speaker. 


═══ 4.1.9. Item Attributes (Dialog) ═══

This dialog box displays the current and default labels for a display item, 
along with the current Warning and Error levels, if that feature is enabled for 
the current item.  To change the label, simply type the new label over the 
current one.  To change the error or warning levels, either enter a new level 
in the entryfield, or move the slider associated with the level. 

To restore all values to their defaults, click on the Default button. 


═══ 5. Reset Load Meter (Menu Option) ═══

This menu option allows the user to reset the CPU Load meter, recalibrating it, 
causing it to forget previous CPU activity in its calculations. 

Nota:   This menu option is not available when on Warp 4.0 or better, nor on 
certain higher fixpack levels of Warp 3.0, as the newer load measuring 
technique makes this command irrelevant. 


═══ 6. Reset Average Load (Menu Option) ═══

This menu option allows the user to reset the Average Load meter, causing it to 
forget previous CPU activity in its calculations. 

The short-cut key for this command is Alt+R. 


═══ 7. Reset Drives (Menu Option) ═══

This menu option allows the user to reset any drive errors that might be 
present.  This will happen automatically over time, but the command allows the 
user to reset the errors without delay. 


═══ 8. Launch E-Mail Reader (Menu Option) ═══

This option will launch the e-mail reader configured by the user. See E-Mail 
for more information. 


═══ 9. Copy (Menu Option) ═══

This menu option copies the current window display to the system clipboard in 
two formats: Text and Bitmap.  The text version shows all the currently 
displayed items in a form suitable for pasting into a text editor.  The bitmap 
version shows an exact copy of the current window, and can be used by graphic 
editors and viewers. 

The short-cut key for this command is Ctrl+Ins. 


═══ 10. Informaciв del programa (Opciв del menг) ═══

Aquesta opciв ofereix, quan es selecciona, informaciв sobre el programa. For 
more information, see About (Dialog). 


═══ 10.1. Informaciв del programa (Capsa de diЕleg) ═══

Aquesta capsa de diЕleg mostra el nom del programa, la icona i informaciв sobre 
els drets de cХpia i l'autor.  Per sortir d'aquesta capsa de diЕleg, podeu 
prВmer qualsevol d'aquestes tecles: ENTER, la barra d'espais o bВ ESCAPE. TambВ 
es possible sortir seleccionat el butв OK del mouse. 


═══ 11. Close (Menu Option) ═══

This menu option, when selected, will cause the program to terminate. 


═══ 12. Ajuda de les tecles ═══

Les segБents tecles de funciв s'han definit per aquest programa: 

      F1 - Ajuda 
      F3 - Finalitzar 
      Alt+C - Configurar 
      Alt+H - Amagar els controls 
      Alt+R - Reset Average Load 
      Ctrl+Ins - Copy 


═══ 13. Indicar el directori del fitxer .INI (Capsa de diЕleg) ═══

Aquesta capsa de diЕleg es mostra quan el programa no pot trobar el seu fitxer 
.INI, i pregunta quin Вs el nom d'aquest fitxer i a quin directori es troba. 

NomВs s'accepten noms vЕlids de directoris ja existents. Una vegada que hagiu 
escrit el nom, prement la tecla INTRO (RETURN) o bВ fent un click al botв "OK" 
fa que el programa continuЛ la seva seqБКncia d'inicialitzaciв. 

Si, per contra, voleu tallar la inicialitzaciв del programa, premeu la tecla 
ESC o bВ feu un click al botв d'anul·laciв. 


═══ 14. HRTIMER - High Resolution Timer driver ═══

The high resolution timer device driver, HRTIMER.SYS, enables a program to 
access a normally unused timer chip found on IBM PCs.  It has a resolution as 
high as 840 nanoseconds, 64K times better than the normal timer resolution of 
55 milliseconds. 

The only places I know of right now that has this program available are 
CompuServe, where the program can be found in the Device Driver Development 
library of the OS/2 Developer's Forum I (OS2DF1), under the name TIMER.ZIP, and 
on the anonymous ftp sites ftp.cdrom.com and hobbes.nmsu.edu. The file can be 
found in the directory /pub/os2/dev16, as hrtimer.zip. 

The source code for this device driver was obtained from the Fall 1991 issue of 
IBM Personal Systems Developer magazine.  It is freeware, but the original 
copyright belongs to IBM. 


═══ 15. What is the conflict with PULSE? ═══

This program, as well as PULSE, CPULOAD, CPUMETER and similar programs, all 
attempt to measure how busy the computer is by trying to see how much work they 
can accomplish at the lowest possible priority.  Presumably, if one of these 
programs can do anything at that priority, it must be using idle time.  If 
there is no idle time, the computer is 100% busy.  The more this program can do 
at system idle priority, the less busy the computer is assumed to be. 

The problem with running more than one of these programs at the same time is 
that they begin to compete for that idle time.  If you ran two copies of the 
same program, and nothing else, they should both show about 50% CPU load.  If 
you run two disimilar programs, like this one and PULSE, they would both be 
affected, but usually to differing degrees. 


═══ 16. How does HRTIMER.SYS help? ═══

With HRTIMER.SYS installed, system overhead is included in the CPU Load. 

The CPU Load is determined by comparing how much work could be done at idle 
priority with the most the program has been able to do up to the present 
moment.  Without more information, normal system background activity would 
appear as zero load.  If HRTIMER.SYS is installed on your system, then this 
program executes a calibration loop at startup, in which it determines just how 
much work can be accomplished at the highest possible priority.  This amount is 
then used for comparison. 


═══ 17. What is Theseus/2? ═══

Theseus/2 is a system memory analysis tool developed by IBM as part of a 
product they once sold, called System Performance Monitor/2. Eventually, they 
stopped selling the tool, and somebody in IBM packaged Theseus/2 for freeware 
distribution early in 1997.  It can be found at: 

      ftp://hobbes.nmsu.edu/pub/os2/util/system/t2spm.zip 

 A newer version (Theseus/3) can be found at: 

      ftp://ftp.boulder.ibm.com/ps/products/os2/fixes/v4warp/theseus3/thes3000.exe 

 Theseus/2 has two things my program will probably never have: a deep internal 
 knowledge of the structure of the OS/2 kernel, and a special device driver 
 which allows it to inspect the kernel directly. These advantages have a price, 
 however: the program takes a relatively long time to performs its analysis. 
 For that reason, MemSize does not use it more than once every ten seconds, so 
 as to not overburden the system.