Category : Communication (modem) tools and utilities
Archive   : COP09B.ZIP
Filename : POP.DOC

 
Output of file : POP.DOC contained in archive : COP09B.ZIP









POP MENU SYSTEM
====================
(v 2.5 01-Jun-1991)
by
Maurizio Ammannato
(c) Copyright 1991 Maurizio's House
(GEnie mail M.AMMANNATO)

This POP.DOC file is in format (press RETURN key now).






HappyWare concept.
==================
My personal concept of HAPPYWARE is to deliver a fully working package at $0
licence fee to enjoy together of this fantastic opportunity to share ideas
and knowledge over physical, cultural, race and religious boundaries.


Use it as you want, but don't make any kind of profit on my work which you've
received free of charge. Commercial licence is available and related money
will be devolved to a local school of Valmadrera for young people with
handicap.




My preferred sentence
=====================
"Tribe's boss must be elected based on leadership owned and not claimed, on
his many seasons commitment to serve others and not to be served, to work for
tribe and not for himself, to be in peace with men, Nature and Manitou".
(From Apaches "Main Rules")










Maurizio Ammannato
Via Preguda N.60
22049 Valmadrera (CO)
I T A L Y
---------------------
(tel. 39-341-581081)





WHAT POP DOES
=============
POP is a program manager. It can executes .EXE, .COM programs and .BAT files,
leaving or remaining resident (TSR).


If you're developing an application consisting in executable and independent
modules (as I usually do), you find POP useful in managing your modules in an
integrated environment (that means putting together your modules but also
spreadsheet., data base, utilities, DOS commands, etc.).


If you need instead a DOS program manager, you can execute via POP whatever
DOS command or DOS application you want, in windowing and friendly fashion.




POP FEATURES
============

- POP can handle up to 1440 commands: 16 x 90 (menus x programs = 1440)
in ONE screen.

- POP executes BAT files too (BAT file however doesn't have to call
another BAT).

- POP can use the total amount of available RAM or can remain resident
(faster execution) during the shell. An 'a' on 24th line says that
current program needs the total (ALL) amount of main memory.

- Optionally can open a window with more details (up to screen width)
explaining current option. An 'h' on 24th line remark this possibility.

- Each of 1440 commands can be executed via a password validation.
A 'p' on 24th line advises you of password validation.

- Each menu can execute up to 90 executable commands.

- You can pass parameters to the program (i.e. c:\diw.exe *.exe) and
execute multiple programs via '|' character (c:\dir.exe *.dat|c:\dir.exe
*.exe). POP allows piping (i.e. c:\dir.exe>pippo *.EXE|print.com)

- Input variable parameter. Giving %1 instead of the fixed parameter you
advise POP to ask for an input before executing program or a BAT
(i.e. c:\dir.exe %1)

- Program navigation also allowed via hot key (case sensitive) at your
choice





QUICK INSTRUCTIONS
==================



Prepare with your text editor the POP.DAT file (in the .ZIP file you find an
example of the POP.DAT file).


Before starting with explanations you have to understand the main POP
structure.


*OPTION-STAR
............
............
*OPTION-END

*MESSAGE-START
.............
.............
*MESSAGE-END

MATRIX MAXIMUM VALUES (level 0) 1 row
MENU #1 (level 1) 1 row
Prog1 (level 2) 2 rows
Prog2
Prog3
.....
MENU #2 (level 1) 1 row
Prog1 (level 2) 2 rows
Prog2
Prog3
.....



As you see there are three levels of commands, Matrix Level, Menu Level and
finally Program Level.



MATRIX VALUES
-------------
To let POP to save precious K bytes of main memory, you have to declare at
this ZERO level the maximum matrix values. First of them is exactly the
number of menus (thus the number of FIRST level). In following Simple
Structure Example such number is 4.


Second value represents the MAXIMUM program number declared in one of the
menu level (FIRST). For example if you want to have three menus, first with
10 programs, second with 4 and the third with 7 programs, the maximum
programs number to write is then 10. In following Simple Structure Example
instead that value is 5.





Simple Structure Example
------------------------

4,5 MATRIX VALUE = 4 menus with a max of 5 programs
(in this case 2nd menu establishes the max prog values)
3,Menu #1 first menu with 3 programs
.......
.......
.......
5,Menu #2 second menu with 5 programs
.......
.......
.......
.......
.......
1,Menu #3 third menu with 1 program
.......
2,Menu #4 4th menu with 2 programs
.......
.......






MENU LEVEL
----------
After matrix values you have to open a MENU section (FIRST level). Give in a
single row following parameters separated by a comma.

1) total number of section programs (comma)
2) short description (i.e. 'UTILITY' for 1st screen line) (comma)
3) its long comment (up to 80 characters) for 25th screen line

For example :

10,UTILITY,DOS utility menu
| | |
| | |------------ 3) long comment
| |------------------------2) short comment
|-----------------------------1) total programs number




PROGRAM LEVEL
-------------
Now for each of programs you have to give following two lines :

1st line => 1) Command-to-execute for menu window (comma)
(a '@' indicates the left character to be considered
the hot key; no @ means first character=hot key)
2) Its long comment for 23rd line (comma)
3) Optional password

For example :

COP,Linking host computer with COP program,secret
| | |
| | |------ 3) password
| |------------------------------------2) command comment
|--------------------------------------------------1) command


2nd line => FULL path ending with the FULL program name (include its
extension like .COM or .EXE or .BAT) or POP command
(@COMMAND, @QUIT or @NUL).

For example :


C:\COP\cop.exe MKIII






PROGRAM LEVEL EXCEPTIONS
------------------------
- If you put a "-" in the first line (graphic character) you don't need
to give the second line (that allows you a better editing of menu).

- If you give a POP '@' command, you don't need to give extension.

In both cases you have to count such editing command as a command. For
example for the following menu section :


5,EDITORS,Execute one of your preferred editors
PE2,Professional Editor,
C:\EDITORS\pe2.exe %1
-
QEDIT,Quick Editor,
C:\EDITORS\qedit.exe %1
-
@COMMAND


you have to declare 5 (2 editing lines, plus 2 real commands, plus a "@POP
command".




Help File
---------
If POP finds in current directory an help file with ".PHP" extension
in correspondence of highlighted program (i.e. LOTUS.PHP for LOTUS command)
pressing plus (+) key POP displays on screen some additional comments (found
in .PHP file). If that file doesn't exist, POP shows to you what she
appropriate filename should be (so you can see what filename you have to
prepare). For example if the highlighted command is "B*Talk 5.1", POP looks
for "BTALK51.PHP" (POP removes from command string all not allowed DOS
characters and adds .PHP extension).



RAM resident or not.
-------------------
When you give the full pathname of the program, POP executes it remaining RAM
resident (POP takes from 100k up to 140k bytes depending on program number in
POP.DAT file). On the 24th line you see the main memory available for your
programs (420k = 420 kbytes free). If your program needs instead more memory,
put an at the very beginning of program line so that POP will leave RAM
and comes back later.


C:\COMMUNICATION\procomm.exe (POP resident)
C:\COMMUNICATION\procomm.exe (POP leaves RAM; all memory free)


The only visible difference is that in the second case POP is slightly slower
in chaining external program and coming back.





EXAMPLE
=======


'------------ POP.DAT ------: 4 main menus
4,8
'-- 1st for DOS ------------------------------------------------
5,D O S,Utility del DOS
DIR,Disk Directory (give string to search; i.e. *.COM *.EXE),
c:\diw.exe %1
COPY,Files to copy (give name to copy & device;i.e. *.DAT D:),
c:\wopy.exe %1
TYPE,File to display (give the name of printable file),
c:\typew.exe %1
PURGE,Remove selected files from disk (ask for confirmation),
c:\purw.exe %1
FORMAT,Like FORMAT DOS command (only for A: or B: devices),
c:\formaw.exe
'-- 2nd for application, still without password ----------------
8,UTI,Disk Utilities
LOOK,LOOK Utility (by GE Information Services),
c:\uti\look.bat
TSS,Statistics on your Personal,
c:\uti\tss22.exe
SPEED,Compute your PC Speed,
c:\uti\speed.bat
DISK,Compute your disks free sizes,
c:\uti\disk.bat
COMPRESS,Squeeze disk space,
c:\uti\compress.exe
NDD,Norton Disk Doctor,
c:\uti\ndd.exe
SZ,Squeeze disk space,
c:\uti\sz.exe
GRABBAG,Some utilities,
c:\uti\gb.exe
'-- 3rd displaying 'hard pictures' via password------------------
5,GIFteca,Immagini dal GEnie
Aloha03@,From Hawaii,maumau
d:\vgapic\picem.exe>nul hawaii03.pic|c:\mode.com co80
Aloha04@,From Hawaii,maumau
d:\vgapic\picem.exe>nul hawaii04.pic|c:\mode.com co80
Ca@ble4,See and decide,maumau
d:\vgapic\picem.exe>nul cable4.pic|c:\mode.com co80
Don@na,A woman,maumau
d:\vgapic\picem.exe>nul donna.pic|c:\mode.com co80
Gal@nu231,No distraction !,maumau
d:\vgapic\picem.exe>nul galnu231.pic|c:\mode.com co80
'-- 4th to finish -----------------------------------------------
2,Quit,Per uscire
Oops ! Mistake!,Don't do it any more !
@NULL
Quits from POP,and goes in holydays,
@QUIT





OPTIONS
=======
Like any good product, POP has its OPTION section to allow you to use your
favorite color/layout/menuname combination.

If you want to use above option you MUST start and finish the option section
with following commands :

*OPTION-START
.........
.........
*OPTION-END

Foreground color numbers can range from 1 to 31: Background from 1 to 7.
The following is the complete list of options you can set :


'-----DataFile--POP.DAT------------ Optional OPTION section
*OPTION-START
MENU_TITLE=Pop Menu System
POP_ID=01 (using more POP systems, change ID)
TIME=5 (save screen after 5 minutes)
RAM=D: (RAMDISK on D:;"NO" for no ramdisk)
SOUND=YES (window sound yes/no)
F_MAIN=14 (foreground main window color)
B_MAIN=1 (background main window color)
F_WIND=0 (window)
B_WIND=7
F_TOP=0 (top line)
B_TOP=7
F_MENU=0 (menu)
B_MENU=3
F_PROG=0 (program)
B_PROG=2
F_CHR=4 (hot key)
B_CHR=7
F_24=14 (24th line)
B_24=5
*OPTION-END


Above option example are the default values which POP program takes in total
or partial absence of your options.





MESSAGES
========
After Option section you MUST have the MESSAGE section to customize messages
and comments in your own or preferred language.

The following is an example of standard POP messages.

*MESSAGE-START
" a Prog uses all avlble RAM ÄÄ Navigate Main Menu"
" h Prog Help (press '+' key)   Navigate Progs Menu"
" p Prog with password PgUp Navigate Progs Menu"
"ecb@ Exe,Com,Bat o Command PgDn Navigate Progs Menu"
"Cap Caps Lock ON F1 This Help"
"ESC ESCape ÄÙ Execute Marked Prog"
"Any key to continue"
"Wrong Matrix Definition in"
"Wrong Option. Check"
"No device name!"
"No '\' symbol found!"
"No COM,EXE or BAT extension"
"Input"
"not found."
"[ Press any key to continue ]"
"Required"
"ESC to Quit"
"No Help File: "
*MESSAGE-END


You can change whatever you want at the only condition to don't change string
comment length.





MAIN MENU LAYOUT
================

1st line : main menus list (highlighted color for current menu)
25th line : corresponding long current menu comment (LEVEL 1)

23rd line : long current program comment (LEVEL 2)

24th line : . date
. F1 help
. RAM device if exists
. current program on total available (2/40 = 2nd of 40)
. title
. h/a/p/e/c/b/@ as per help screen
. total RAM availability (k bytes)
. Cap or no Cap (useful for the hot keys case sensitive)
. time
. remaining secs before going to sleep

between 2nd and 23rd the up to 18 lines menu's window.



NAVIGATING MENUs
================
Once in the main, you can navigate in the following ways :


- left/right keyboard arrows: navigate menus (1st screen line) (LEVEL 1)

- down/up arrows : navigate through current menu step by step (LEV 2)

- hot key (different color) : jump directly to command (LEV 2)

- PgDn and PgUp : jump to Home/End of menu's window (LEV 2)

- F1 for help screen.

- Once on highlighted command, the IMMISSION (or RETURN or ENTER) key allow
you to execute the chosen procedure.

- ESC to quit.

- Any other key, displays the CopyRight/Help screen.





EXECUTING PROGRAMS
==================


A) You can execute directly a program without any command line value; i.e.

C:\EDITORS\pe2.exe

let you enter in PE2 with no file on screen.


B) You can execute directly a program with a command line value; i.e. :

C:\EDITORS\pe2.exe pippo.txt

let you execute PE2 which loads pippo.txt file.


C) And finally you can tell POP to ask for a command line value; i.e. :

C:\EDITORS\pe2.exe %1

and POP before executing pe2.exe, open an input window asking for that value
and pass it to called program.


That is valid for .EXE, .COM and .BAT programs, file.




PREPARING HELP FILE
===================


One of the most powerful capability of POP is to let you prepare an
exhaustive POP Help Window for each of 1440 program.


If you have following second LEVEL lines :


My Dbase,Executing my personal data base,
C:\DB\pcf.exe

you have to prepare with your editor an ASCII file called MYDBASE.PHP (thus
looking at "My Dbase" string, remove blanks and other not allowed DOS
characters and add .PHP extension) and leave it on POP directory.


Once executed POP and highlighted above command, POP automatically looks for
that .PHP file and if found, print a "h" character on 24th line for help and
if the user press the + key, your help comment are displayed on a pop up
window in the middle of main screen.




History
-------
2.4 . You can execute .BAT file with one parameter (i.e. if you
have EXAMPLE.BAT which needs %1 parameter, you can now
execute .BAT adding such value in POP.DAT command line :
"C:\POP\EXAMPLE.BAT plusminus")
. Added MESSAGE-OPTION section to allow different tongue
. Changed help files from .HLP to .PHP
. With '+' key now you can see or help file messages or the
name of help file POP is looking for (to facilitate you
how to call the help filename)

2.2 . POP_ID. Using more than one POP menu in same PC, you must
use different POP_ID (i.e. 01 for first,02 for second,etc.)

2.1 . Sound option
. Faster windowing

2.0 . Current commercial version.

1.0 . Alfa/Beta test version.






Notes for Help Master (type "HM POP.DOC" at DOS level)
======================================================
{HM}
Help Master is a program which allows to use the same documentation
file for both printing and display function. Using HM program
you can read the same file in fashion, that means
navigation and window facility.

An highlighted word represents a . Using left and right
you can move between key-words.

There are two different types of key-word; the first one opens an
explanation window, the second one jumps to a specific document point.

Pressing the key you can open an explanation window on that
words (first type) or jump to a specific point (2nd type).


. Press F1 for Help

. Press ESCape key to come back basic text
-@-
{ASCII}
When you have an ASCII file on your PC, that means you can PRINT it,
you can TYPE it, you can EDIT it.

- PRINT filename
- TYPE filename
- EDLIN filename
-@-
{Hyper Text}
That is a new technique to improve a text comprehension speed. Each
Hyper Text word can be a key-word which opens a new text folder, in
this new folder you can find new key-words which open new folders etc.

So that you can read text at the layer of your knowledge layer.
-@-
{Hypertext}
See .
-@-
{key-word}
A key-word is a special word you want to detail more. Depending on the
key-word type, you may enter in a window with more details or jump to a
specific point of the document you are reading
-@-
{arrows}
See
-@-
{arrow}
Looking at your keyboard, on numeric small keyboard, there are some
small arrows. For this program you can use Left and Right Arrow to move
right and down or left and up.
-@-





{RETURN}
Often you can find this key as IMMISSION key or a CARRIAGE RETURN key
or ENTER key.
-@-
{ALL}
To leave free all available main memory
-@-


  3 Responses to “Category : Communication (modem) tools and utilities
Archive   : COP09B.ZIP
Filename : POP.DOC

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: http://www.os2museum.com/wp/mtswslnk/