Home of the original IBM PC emulator for browsers.
[PCjs Machine "ibm5150"]
Waiting for machine "ibm5150" to load....
Who needs to get organized? Not everyone, certainly. But if you do feel
the need, QSYS DOS MENU may be just what you're looking for. The program
is an operating environment of its own, a menu system, an appointment
calendar, and a message system. One of the major features of the program
is its password capability for up to 24 users.
QSYS DOS MENU is an excellent choice whaere a business may include non-
computer-literate (NCL) employees, because the system does much of the
more complicated operations by means of its won DOS system.
System Requirements: Color graphics, two disk drives, (hard disk
recommended)
How to Start: Consult the .DOC and README files on Disk 278 for
directions and documentation. To run QSYS.EXE, just type its name,
i.e., QSYS and press <ENTER>.
Suggested Registration: QSYS $50.00 for full documentation and update
File Descriptions:
The First Disk Contains:
QSYS EXE Main QSYS program
QINST EXE Part of QSYS
AUTOEXEC BAT Installation startup procedure batch file
QLDR COM Part of QSYS
QINT EXE Part of QSYS
QCNFG EXE Part of QSYS
QMSG EXE Message handler
MEMBRAIN SYS RAMdisk initial bootup file
CONFIG SYS Initial bootup file MEMBRAIN EXE RAMdisk
MEMBRAIN EXE Disk examination utility
The Second Disk Contains:
MAKEDOC TXT Instructions for printing documentation
MAKEDOC BAT Batch file to print documentation
READ ME! Read this first ________
Q_* DOC Documentation files (17 files)
The QSYS documentation is provided in several files. This may seem
a bit strange at first, but really, there's a very good reason. Most
printers available for personal computers are not designed to withstand
continuous duty. I found this to be true with my own printer. It seems
that the heat associated with extremely lengthy print jobs has a very
adverse effect on printheads. For this reason, I thought it appropriate
to provide the documentation file in the form of several smaller files.
There is also a provision for combining the files into one large file,
or to print all of the smaller files at once, for those of you who feel
that your printer is up the task. If in doubt, assume that your printer
is only as good as mine was.
Regardless of which of the following methods you decide to use for
printing the documentation, a few things are assumed. Each page of the
documentation is 66 lines long. This means that on standard 8.5" x 11"
forms, at 6 lines/inch, each page will finish at top-of-form, it it
started at top-of-form. The documentation files all have an extension
of '.DOC ', and are on the QSYS DOCUMENTATION diskette in the order in
which they should be printed and assembled.
- Light-Duty Printers:
Use the 'COPY ' command to print each '.DOC ' file. For example,
the command 'COPY Q_TITLE.DOC LPT1: ', would print the first file to a
printer connected to the first parallel port.
The 'PRINT ' command could also be used, but since the spooler
outputs a top-of-form at the end of each file, a blank page would be
ejected after each file that was printed.
- Continuous-Duty Printers
A batch file named 'MAKEDOC.BAT ' is provided for combining the
documentation files, or for printing all of the files at once. This
batch file uses two parameters. The first parameter tells MAKEDOC where
the QSYS documentation files can be found, and the second parameter
tells MAKEDOC where to output them. Enter the command in the following
format.
d:MAKEDOC parm1 parm2
d: - The drive in which QSYS DOCUMENTATION is inserted, if not the
default drive.
parm1 - The drive in which QSYS DOCUMENTATION is inserted. Must be
specified if not the default drive, or if parm2 is specified.
parm2 - The output device or file specification to which the combined
QSYS documentation files will be copied. Any valid device
name, such as 'LPT1: ' or 'COM1: ' may be specified. May also
be a file specification, including drive, path, and filename.
This parameter defaults to 'd:QSYS.DOC ' if omitted.
For example, 'B:MAKEDOC B: LPT1: ' invokes MAKEDOC from drive B:, and
copies all of the QSYS documentation files from drive B: to the device
connected to the first parallel port. The command 'MAKEDOC ' without
any parameters assumes that QSYS DOCUMENTATION is in the default drive,
and copies all of the documentation files to a file named 'QSYS.DOC '
on the QSYS DOCUMENTATION diskette. The latter example would be most
useful for printing the documentation file using the 'PRINT ' command.
APPENDIX A
MEMBRAIN DOCUMENTATION
- Description
MEMBRAIN.EXE creates a file named 'MEMBRAIN.SYS ', a DOS device
driver for an emulated disk drive configured to your specifications.
MEMBRAIN is installed through the DOS device driver interface using
a 'DEVICE= ' statement in 'CONFIG.SYS '. DOS will assign to the drive
the next available drive letter. For example, if your system has disk
drives A: and B:, MEMBRAIN will be drive C:. On a PC-XT with drives A:
and C:, MEMBRAIN will be drive D:.
- System Requirements
An IBM PC or XT with at least 128K of memory and DOS 2.X
- Installation
1) Enter on the DOS or QSYS command line:
MEMBRAIN disk size,sector size,cluster size,directory entries,path
disk size - The requested size of the emulated drive in Kbytes.
An error is returned if the resulting configuration would
leave less than 64K of free memory. If this parameter is
omitted, the default disk size is 160K.
sector size - The size of each logical sector in bytes. Sector
size should be a multiple of 128 and will be rounded up to
the next 128 byte multiple. For example, if the parameter
is entered as 150, then the actual sector size will be 256
bytes. The default is 512 bytes per sector.
cluster size - The number of sectors per cluster. An error will
be returned if the number of bytes per cluster exceeds 2048.
Refer to 'Configuration Tips ' for more information. The
default is 1 sector per cluster.
directory entries - The maximum number of filenames that the disk
directory can hold. This parameter will be adjusted upward as
necessary to a multiple of sector size. The default is 64.
path - The drive and directory path in which MEMBRAIN.SYS is to be
created. This parameter is entered in the form 'd:\path '. If
drive is omitted, then the default drive will be used. If the
path is omitted, then the current directory will be used.
NOTES:
- MEMBRAIN.EXE passes a return code upon termination that can be
tested in a batch file with the 'IF ERRORLEVEL ' batch file
command. A non-zero return code indicates that an error occurred.
APP - A1
APPENDIX A
MEMBRAIN DOCUMENTATION
2) To create a CONFIG.SYS file:
Enter on the DOS command line:
COPY CON: CONFIG.SYS 'Copies keyboard input to CONFIG.SYS
DEVICE=MEMBRAIN.SYS ' this goes into the file
Press F6 and then <ENTER> ' this writes the file to disk
NOTES:
- CONFIG.SYS must be on the drive used to boot DOS.
- If you already use CONFIG.SYS, then edit it to include the
statement 'DEVICE=MEMBRAIN.SYS '.
- Multiple 'DEVICE= ' statements can be used in CONFIG.SYS to load
more than 1 MEMBRAIN device driver. This is less efficient than
using a single, larger device driver, and is not supported by
the QSYS INSTALLATION AID.
3) Re-boot DOS either by powering the system off and then back on, or
with the key sequence 'Ctrl-Alt-Del '. The MEMBRAIN.SYS device
driver is automatically loaded and initialized by DOS.
- Configuration Tips
MEMBRAIN.EXE displays a summary of disk space utilization as it
creates MEMBRAIN.SYS. The following example illustrates how to use
the data provided.
MEMBRAIN 20,128,1,8,C:\ 'Command used to invoke MEMBRAIN.EXE
<<<< M e m B r a i n >>>> 'Title
(C) 1984 Dennis Lee
20K MemBrain Created 'disk size \ These are the
\ values created,
128 bytes per sector 'sector size \ and may differ
1 sectors per cluster 'cluster size / from requested
8 directory entries 'directory entries/ values.
1 reserved sector 'boot record \
2 FAT sectors 'file allocation table > overhead
2 directory sectors 'directory /
155 data sectors 'usable file space
--------------------------
160 total sectors '160 sectors X 128 bytes/sect = 20K
This summary can be used to analyze the overhead of the configuration.
Since a change in the configuration has no effect until the next time
DOS boots, MEMBRAIN.EXE may be executed several times to analyze the
effects of different parameters. The following notes are general tips.
APP - A2
APPENDIX A
MEMBRAIN DOCUMENTATION
1) Sector and Cluster Sizes
Each cluster requires 1.5 bytes of space for the file allocation
table, and the total is rounded up to next multiple of the sector size.
The general rule for adjusting sector size and cluster size is to use
small sector and cluster sizes for smaller drives, or when small files
will be stored, since less space will be wasted when part of a cluster
is left unused between files. Larger sector and/or cluster sizes may
provide more usable disk space per Kbyte of disk size, and a slight
performance gain with larger drives, or when a few large files are to
to be stored, since less space will be used for FAT sectors, wasted
space between files is less of a consideration, and DOS will spend less
time finding a given amount of data.
2) Directory Entries
Each directory entry requires 32 bytes of space, and the total is
rounded up to the next multiple of sector size. For example, with 128
byte sectors, you get 4 directory entries per sector. Any request for
directory entries would be rounded up to a multiple of 4. The only key
to allocating directory entries is to allocate slightly more than you
think you'll need, because it's frustrating to have free disk space and
no available directory entries, but not too many, since extra entries
are wasted space. MEMBRAIN uses one directory entry for a volume label.
- Operational Characteristics
MEMBRAIN looks to DOS like a non-IBM fixed disk. This device type
is used because it provides an operational interface to DOS consistent
with it's performance characteristics. The following list outlines it's
important operational characteristics.
1) Since MEMBRAIN is a non-IBM device, the 'FORMAT ' command will
not work with it. It doesn't need to be formatted!
2) Since MEMBRAIN can be any non-standard size, and is considered
fixed media, 'DISKCOPY ' will not work with it.
APP - A3
APPENDIX B
QLDR DOCUMENTATION
- Description
QLDR.COM is a program used by QSYS to enhance it's ability to load
programs, batch files and DOS commands through a DOS batch file. It
handles the tasks of checking for the required files, prompting for
required media, handling errors associated with missing directories and
files, and even for the execution of batch files and BASIC programs. It
also provides services for interrupting the execution of a batch file,
the ability to move forward and backward between tasks in a batch file,
and the ability to temporarily load the DOS command processor at any
point within the batch file, execute any program, batch file, or DOS
command, and return to the interrupted batch file at the point at which
execution was suspended.
QLDR can be used in any batch file that is executed in the QSYS
environment. It receives it's input from command line parameters, and
passes it's output to the calling batch file through the DOS 2.X return
code mechanism. This output can be determined by the calling batch file
through use of 'IF ERRORLEVEL ' statements.
- Input Parameters
QLDR is loaded and passed parameters through use of the following
command line. Each parameter passed to QLDR is discussed in detail.
QLDR Program type,Drive,Vol-id,Path,Filename.ext,Parameters
- Program Type
The program type describes to QLDR the type of file which
will be loaded. It is a single character, a number between 0 and
5. The action that QLDR takes depends upon this parameter. The
table below describes what each program type means, and the action
which QLDR takes for each program type.
BLANK - Instructs QLDR to interrupt batch file execution and
display the option menu. All other parameters are
discarded if present. Once a menu option is selected,
QLDR terminates and passes a return code equal to the
menu option selected, unless the selection was 4. In
this case, the command processor is loaded and QLDR
passes control to it. After the command processor is
terminated with the 'EXIT ' command, QLDR re-displays
the option menu.
0 - Instructs QLDR to test for a user interrupt (Escape),
and interrupt execution and display the option menu
only if an interrupt is requested. If an interrupt is
detected, the action taken by QLDR is the same as if
the program type parameter was blank.
1 - The 'Filename.ext ' parameter is an internal DOS
command. QLDR action is the same as for type 0.
APP - B1
APPENDIX B
QLDR DOCUMENTATION
2 - The 'Filename.ext ' parameter is a .COM or .EXE file.
QLDR tests for media in the specified drive with the
specified volume label, changes to the indicated
directory, checks for the existence of the specified
file, tests for a user interrupt, and terminates
passing a return code.
3 - The 'Filename.ext ' parameter is a batch file. QLDR
tests for media in the specified drive with the
specified volume label, changes to the indicated
directory, checks for the existence of the specified
file, loads COMMAND.COM from the drive and directory
from which DOS was booted, and passes the batch file
name and parameters to it for execution. After the
command processor executes the batch file, it passes
control back to QLDR which then terminates and passes
a return code back to the calling batch file.
4 - The 'Filename.ext ' parameter is a BASIC program. The
actions taken by QLDR are the same as those for type
3 programs, except that BASIC.COM is loaded instead
of COMMAND.COM.
5 - The 'Filename.ext ' parameter is an advanced BASIC
program. The actions taken by QLDR are the same as
those for type 4 programs, except that BASICA.COM is
loaded instead of BASIC.COM.
- Drive
The drive parameter is passed in the form of a drive letter
followed by a colon. For example 'A: '. This is the drive on which
QLDR can find the requested file. If this parameter is omitted,
then QLDR will assume the drive from which DOS was booted.
- Vol-id
This is the volume label of the media that is expected to be
in the specified drive. If this parameter is omitted, then QLDR
will not check for a volume label.
- Path
This is the directory path, specified from the root directory
to the file, in which the specified file can be found. If this
parameter is omitted, then QLDR will assume the root directory.
- Filename.ext
This is the filename and extension of the file to loaded. It
may contain global filename characters. This parameter cannot be
omitted if the program type is greater than 1.
APP - B2
APPENDIX B
QLDR DOCUMENTATION
- Parameters
This is the parameter string to be passed to the program to
be loaded. This parameter may be omitted if no parameters are to
be passed.
- Output Return Code
If all necessary resources are available, and the program type is
not blank, QLDR will terminate passing a return code of 0. If resources
are unavailable, or the Escape key has been pressed requesting a user
interrupt, the following menu will be displayed, and QLDR will halt
awaiting operator intervention.
1) Re-run Previous Task
2) Cancel Current Task
3) Cancel the Batch File
4) DOS Command Processor
Press <ENTER> to Continue or Select Option: _
Option 4 will only be displayed if the current user is a primary user.
Once an option, other than option 4, which loads the command processor,
has been selected, QLDR will terminate passing a return code equal to
the number of the menu selection. The following example batch file
entries illustrate how the return codes are used to control batch file
execution.
' assume previous tasks exist
:JOB02 ' batch file label
CD C:\ ' change to QLDR directory
C:QLDR 1,,,,DIR, B: ' load QLDR and pass parameters
IF ERRORLEVEL 3 GOTO END ' if selection 3 then end batch file
IF ERRORLEVEL 2 GOTO JOB3 ' if selection 2 then next task
IF ERRORLEVEL 1 GOTO JOB1 ' if selection 1 then previous task
DIR B: ' if <ENTER> then proceed
:JOB03 ' batch file label
ECHO Loading QSYS ' say what we're loading
CD C:\ ' change to QLDR directory
C:QLDR 2,C:,,\,QSYS.EXE ' load QLDR and pass parameters
IF ERRORLEVEL 3 GOTO END ' if selection 3 then end batch file
IF ERRORLEVEL 2 GOTO JOB4 ' if selection 2 then next task
IF ERRORLEVEL 1 GOTO JOB2 ' if selection 1 then previous task
C:QSYS.EXE ' if <ENTER> then proceed
:JOB04 ' batch file label
' assume more tasks follow
:END ' end of batch file
APP - B3
APPENDIX C
THE BASE MENU
The base QSYS menu can be thought of as a reference point from
which all other QSYS menus are created and accessed. The installation
procedure creates a default base menu and names it 'SYSTEM MENU '.
This menu is created in the same directory as QSYS. It is not only
possible to rename the base menu, but also to relocate it, as long as
any changes are made prior to creation of new QSYS menus. Once new
menus have been created, it is not advisable to rename or relocate the
base menu or any other parent menu.
In order to change the base menu, changes will have to be made to
the AUTOEXEC.BAT file that the installation procedure created. In this
file, there will be an entry similar to the example below. This entry
is used to load QINT.EXE. The parameters passed to QINT set the base
menu location when QSYS is booted.
QINT SYSTEM MENU,SYS1,A:\SYSTEM.MNU,9
| | | |
| | | Security Level
| | Menu File Specification
| Volume label
Menu name
As you can see, the parameters passed to QINT are in the same format
as a menu descriptor! Get the picture?
As mentioned previously, the base menu can be thought of as a
reference point from which all other menus are accessed. It is also
possible to tell QSYS that a menu, other than the real base menu, is
the base menu. Confusing? Well, don't try this until you're no longer
confused. What all this really means, is that to QSYS, the base menu
is only a menu that is used for a default. It doesn't really have to
be the very first menu, it can be any menu. It should be a menu with
a security level of 9, so that every user has a menu to look at when
first signed-on, but it can be in the middle or at the end of the menu
structure, as well as at the beginning.
I purposely didn't go into much detail on this subject. It is an
area that most installations will never play with, and indeed no-one
should ever have to change. I mention it because the mechanism exists,
and someone, somewhere will find a need to use it. If this is the case,
then they'd better know what they're doing. It is quite possible to
really screw things up if you don't! Study the MENU SYSTEM section of
this documentation until you really feel that you know how it works
before taking chances with the menu system that you've spent hours,
days, or however long setting up.
APP - C1
CLOCK/CALENDAR
The CLOCK/CALENDAR screen is the default screen of QSYS, and will
be displayed anytime that a user is not signed-on to the system. This
screen will be the first QSYS screen displayed after the startup proc-
edure executes. It can be reached from the MENU SYSTEM by pressing F10,
or from any other QSYS screen by pressing Ctrl-Break. Following is a
a summary of the functions available from the CLOCK/CALENDAR.
- Calendar Browsing
The range of DOS' calendar is 1/1/1980 to 12/31/2099. In the
interest of consistency, this is also the range of the calendar
used in QSYS.
F1 - Moves the Calendar back one month.
F2 - Moves the Calendar forward one month.
F3 - Moves the calendar back continuously one month at a
time until another function key is pressed.
F4 - Moves the calendar forward continuously one month at a
time until another function key is pressed.
F5 - Prompts for you to enter the month and year to be
displayed.
F6 - Returns the calendar to the current month and year.
F10 - Terminates F3,F4,F5, and F7 functions
- Display the MSGQ
F7 - A summary of Messages for the current system date will
be displayed. If no Messages are in the MSGQ, then an
informational system message will be displayed.
- MSGQ Alarm Control
F17 - Toggle action key that switches the current state of
the MSGQ Alarm. A 'note ' symbol is displayed on line
25 of the screen when the alarm is activated. When
activated, the MSGQ Alarm will sound two loud, high-
pitched tones once per minute when a message is due.
This control is reset to the default state as set by
the 'CLOCK/CALENDAR Configuration ' whenever the
CLOCK/CALENDAR screen is exited.
- Sign-on
Entering your password allows access to the QSYS menu system.
If you are the last user that was signed-on to the system, then
QSYS will return you to the same place in the menu structure as
you were when you signed-off. Otherwise, QSYS will return to the
base QSYS menu.
CLK - 1
QSYS CONFIGURATION
- Description
In order to simplify the installation procedure, default options
are taken for as many of the QSYS configuration parameters as possible.
The installation aid configures only those parameters necessary for the
system hardware on which QSYS is installed. QCNFG.EXE allows real-time
configuration of the system parameters that make QSYS fit the operating
environment in which it is to be used. Facilities are provided for user
control, and screen, keyboard, and clock configuration. All changes to
the configuration made in QCNFG are effective immediately, and effect
all applicable QSYS program modules. Any alterations to configuration
parameters are written to QSYS.SYS when QCNFG terminates. If QSYS.SYS
is not available at that time, QCNFG will prompt for the proper media.
It is possible to abort all changes by terminating QCNFG using the
Ctrl-Break sequence.
The QSYS security system restricts access to some QCNFG functions
altogether, and merely controls the way which other functions perform.
The following sub-sections detail the operation of each function.
- QCNFG.EXE Loading Options
QCNFG incorporates it's own function menu, allowing access to all
configuration functions from within the program. It is also possible to
access each function directly by passing the menu option number to
QCNFG using a command line parameter. For example, 'USER CONTROL ' is
option 1 on the Configuration Menu. The User Control function can be
directly accessed, bypassing the Configuration Menu by appending a '1 '
to the command line used to load QCNFG.EXE. This is illustrated in the
default base QSYS menu created by the installation procedure. Refer to
QSYS COMMAND LINE and MENU EDITOR in the MENU SYSTEM section for more
information on QSYS command and filespec format.
- Configuration Menu
The Configuration Menu currently contains the following options.
1) USER CONTROL MENU
2) KEYBOARD/DISPLAY CONFIG.
3) CLOCK/CALENDAR CONFIG.
Each function is accessed by entering the number of the menu option.
F10 terminates the configuration program and writes any changes to the
configuration file.
CNFG - 1
QSYS CONFIGURATION
- USER CONTROL MENU
This selection provides access to all system user options. The
functions provided vary with the user's security level. Following is
an explanation of each function.
1) ADD NEW USERS
All users may sponsor new users to the system. The system
will prompt for the new users name and password. A default
security clearance of 9 will be assigned. The sponsoring user
will remain signed on.
2) DELETE USERS
Selection of this option will cause the cursor to move to
left of the current users name. A prompt will instruct the user
to enter a ` D ' to delete the user. The up and down arrows are
active to primary users, allowing repositioning of the cursor to
the left of another user's name. Any other keys will cancel this
option. Only a primary user (security level 0), may delete another
user. Any user may delete himself, unless that user is the only
primary user on the system. In the event that a user deletes
himself from the system, an immediate sign-off will occur, and
any messages on file for the deleted user will automatically be
purged from the message file during the next file reorganization
procedure.
3) CHANGE USER NAME
A user may change the name which the QSYS system uses for
identification. Care should be taken in doing so, since concurrent
changes are not automatically made in the message file. If it is
necessary to change the name of a user, known to have messages on
file, it is advised that the user FIRST add himself as a new user,
and reassign his messages to the new user. Failure to do so could
cause the user's messages to become inaccessible. All references
in the message file to users not currently in the QSYS user list
are deleted during file reorganization.
4) CHANGE PASSWORD
A user may change his password at any time. In the interest
of security, the password entry will not display. New passwords
are effective immediately. The password must consist of 5 data
keys. No function or cursor control keys are allowed. The default
shift state is CAPS LOCK, but may be overridden. Shift of the
characters in a password entry is significant. For example, a
password of 'IBMPC ' is considered to be different from 'ibmpc '.
CNFG - 2
QSYS CONFIGURATION
5) CHANGE SECURITY CLEARANCE
Selection of this option will move the cursor to the current
user's security clearance field. The up and down arrows are active
to primary users (security level 0), allowing repositioning of the
cursor to another user's security field for alteration. A user may
not use this option to upgrade his own clearance. In addition, the
only primary user's clearance may not be altered. The system must
retain at least one primary user at all times.
- Function Keys
F9 Menu
Pressing F9 on the command line re-displays the Configuration
Menu. The operation of F9 differs from that of F10 only if the a
function was originally accessed directly, without the aid of the
Configuration Menu.
F10 End
The F10 key terminates the current function. If the original
access to the configuration program was through the Configuration
Menu, then the menu is re-displayed. Otherwise, any changes are
written to the configuration file, and QCNFG is terminated.
CNFG - 3
QSYS CONFIGURATION
- KEYBOARD/DISPLAY CONFIGURATION
This selection, available only to primary users, allows alteration
of the parameters that control the display colors, cursor size, and
keyboard timer. Changes made here affect only the QSYS programs. The
DOS screen and all other programs loaded from the JOBQ are unaffected.
1) DISPLAY PARAMETERS
The display parameters allow the QSYS display colors to be
altered to suite the taste and monitor type of the user. During
installation, the display was configured for a black background
and border, with a white foreground and bright white highlights.
The attributes conform to the colors as described in the BASIC
reference manual under the 'COLOR ' statement. Since all changes
are effective as they are entered, it is possible, under some
circumstances, that data will not display as it is keyed. After
all display parameter fields have been entered, the screen will
be adjusted to the new values. This makes it possible to test
different combinations of colors before making permanent changes.
It is generally a good idea to make the foreground, highlight,
and background attributes differ, since non-display of data is
possible by setting the foreground and background to the same
attribute.
- Foreground Attribute
A value between 0 and 31. This is the attribute used to
display data on the QSYS screens.
- Highlight Attribute
A value between 0 and 31. This attribute is used to highlight
input fields and certain other areas of the QSYS screens. Certain
QSYS functions, such as the MSGQ screen, require that this color
differ from the foreground attribute in order to provide maximum
function.
- Background Attribute
A value between 0 and 15. Even though only values of 0 to 7
will actually display as the background color, values of 8 to 15
will cause changes in other areas of the screen.
- Border Attribute
A value between 0 and 15. Setting of this parameter will
cause the overscan area of the screen to change color.
CNFG - 4
QSYS CONFIGURATION
2) KEYBOARD PARAMETERS
- Numeric Lock
This parameter allows setting the default state of the
numeric keypad shift. In the 'ON ' state, the numeric values of
each key are used. The cursor controls may be activated by hold-
ing down either shift key while the desired numeric keypad key is
pressed. In the 'OFF ' state, the cursor controls are active, and
the numeric keys can be activated by pressing pressing either
shift key. In either state, the default may be overridden for the
duration of the current field by pressing 'Num Lock '.
- Cursor Size
A value between 0 and 7. This is actually the value used to
set the top scan line of the cursor. A value of 0 produces a full
height cursor, where a value of 7 produces the smallest possible
cursor. For example, DOS uses a value of 6.
- Keyboard Timer
A value between 0 and 59 minutes. The default setting of 0
disables the keyboard timer. Setting the value above 0 enables the
keyboard timer. When enabled, inactivity at the keyboard for the
specified number of minutes causes the current user to be signed-
off, the current function to be terminated, and CLOCK/CALENDAR is
displayed. The keyboard timer is only active in the QSYS system
programs, and will not terminate other programs loaded through the
JOBQ.
- Function Keys
F9 Menu
Pressing F9 on the command line re-displays the Configuration
Menu. The operation of F9 differs from that of F10 only if the a
function was originally accessed directly, without the aid of the
Configuration Menu.
F10 End
The F10 key terminates the current function. If the original
access to the configuration program was through the Configuration
Menu, then the menu is re-displayed. Otherwise, any changes are
written to the configuration file, and QCNFG is terminated.
CNFG - 5
QSYS CONFIGURATION
- CLOCK/CALENDAR CONFIGURATION
This selection, available only to primary users, is used to
configure the CLOCK/CALENDAR screen.
1) SET TIME
Used to set the system time. The time is always entered in 24
hour format, even though the clock may be configured to display 12
hour format. The time will always be displayed using the format
'HH:MM:SS ', but may be entered using any standard DOS format.
2) SET DATE
Used to set the system date. The date will always display in
in the format ' MM-DD-YYYY ', but may be entered in any standard
DOS format. If the system date is changed, a MSGQ update will be
performed at the next sign-off.
3) DISPLAY OPTIONS
- Foreground Character
The ASCII value of the character used to form the characters
of the system clock. May be a value between 0 and 255. The default
is 4. The BASIC reference manual contains a complete list of the
ASCII character set.
- Foreground Attribute
The color of the system clock characters. May be a value
between 0 and 31. The default is 15.
- Background Character
The ASCII value of the character used to make up the back-
ground of the CLOCK/CALENDAR screen. May be a value between 0 and
255. The default is 0.
- Background Attribute
The color of the background characters. May be a value
between 0 and 31. The default is 0.
CNFG - 6
QSYS CONFIGURATION
4) FORMAT OPTIONS
- Time Format
The values 12 or 24 are valid. The default is 12. In the 12
hour format the time will be displayed as 00:00 to 12:00. In the
24 hour format the time will be displayed as 00:00 to 24:00.
- Clock Format
Allows the user to configure the system clock to display the
time as 'HH:MM:SS ', which is the default, or as 'HH:MM '.
5) SOUND OPTIONS
- Hourly Chimes
A response of 'Y ' activates the chimes, and a response of
'N ' deactivates them. When activated, and the CLOCK/CALENDAR
screen is displayed, the chimes will sound on the hour.
- Hourly Tones
A response of 'Y ' activates the tones, and a response of
'N ' deactivates them. When activated, and the CLOCK/CALENDAR
screen is displayed, the tones will indicate the hour currently
displayed immediately following the Hourly Chimes, if also active.
- MSGQ Alarm
A response of 'Y ' sets the default state of the MSGQ alarm
to on. Two loud, high pitched tones will sound each minute while
the CLOCK/CALENDAR is displayed and messages are due. A response
of 'N ' sets the default state of the MSGQ alarm to off. Either
state may be overridden at the CLOCK/CALENDAR screen with the F17
function key.
- Function Keys
F9 Menu
Pressing F9 on the command line re-displays the Configuration
Menu. The operation of F9 differs from that of F10 only if the a
function was originally accessed directly, without the aid of the
Configuration Menu.
F10 End
The F10 key terminates the current function. If the original
access to the configuration program was through the Configuration
Menu, then the menu is re-displayed. Otherwise, any changes are
written to the configuration file, and QCNFG is terminated.
CNFG - 7
TABLE OF CONTENTS
PREFACE
QSYS Description..........................................PREF - 1
System Requirements.......................................PREF - 1
Voluntary Support.........................................PREF - 2
Limited License...........................................PREF - 2
List of QSYS Files........................................PREF - 3
GENERAL INFORMATION
Security System...........................................GEN - 1
Screen Format.............................................GEN - 2
QSYS Editor...............................................GEN - 3
QSYS INSTALLATION
Before Installation.......................................INST - 1
Backing up your system..................................INST - 1
Backing up QSYS.........................................INST - 2
Installation..............................................INST - 3
User Configuration Files................................INST - 3
QSYS Installation Aid...................................INST - 5
After Installation........................................INST - 11
Required Operating Files................................INST - 11
Default SYSTEM MENU.....................................INST - 11
MEMBRAIN Configuration..................................INST - 11
SYSTEM STARTUP
Startup Sequence..........................................STRT - 1
CLOCK/CALENDAR
Description and Functions.................................CLK - 1
MENU SYSTEM
Description...............................................MENU - 1
Task Selection............................................MENU - 2
Menu Selection............................................MENU - 2
Available Functions.......................................MENU - 3
QSYS Command Line.........................................MENU - 4
Executing .COM, .EXE, or .BAT files.....................MENU - 4
Executing BASIC Programs................................MENU - 5
Menu Editor...............................................MENU - 6
Task or Menu Descriptors................................MENU - 6
General Information.....................................MENU - 7
Adding Descriptors......................................MENU - 8
Editing Existing Descriptors............................MENU - 8
Deleting Descriptors....................................MENU - 8
Selecting a Menu........................................MENU - 8
Creating a New Menu.....................................MENU - 9
Deleting a Menu.........................................MENU - 9
Relocating a Menu.......................................MENU - 9
JOBQ
Description...............................................JOBQ - 1
Special JOBQ Commands.....................................JOBQ - 1
DOS Batch File Commands and Labels in the JOBQ............JOBQ - 1
Use of QLDR in User Batch Files...........................JOBQ - 1
JOBQ Functions............................................JOBQ - 2
Pre-Release JOBQ Functions..............................JOBQ - 2
JOBQ Execution Services.................................JOBQ - 3
JOBQ Execution Control..................................JOBQ - 3
MSGQ
Description and Functions.................................MSGQ - 1
CONT - 1
TABLE OF CONTENTS
MESSAGE SYSTEM
Description...............................................MSG - 1
Loading Options...........................................MSG - 1
Common Editing Features...................................MSG - 1
Message Data Fields.......................................MSG - 2
Messages Menu.............................................MSG - 3
Help Facility.............................................MSG - 3
DISPLAY Message Function..................................MSG - 4
PREVIEW Message Function..................................MSG - 5
ENTER NEW Message Function................................MSG - 6
SEARCH/EDIT Message Function..............................MSG - 7
SET TIME & DATE Function..................................MSG - 8
FILE REORGANIZATION Procedure.............................MSG - 8
QSYS CONFIGURATION
Description...............................................CNFG - 1
Loading Options...........................................CNFG - 1
Configuration Menu........................................CNFG - 1
User Control Menu.......................................CNFG - 2
Add New Users.........................................CNFG - 2
Delete Users..........................................CNFG - 2
Change User Name......................................CNFG - 2
Change Password.......................................CNFG - 2
Change Security Clearance.............................CNFG - 3
Function Keys.........................................CNFG - 3
Keyboard/Display Configuration..........................CNFG - 4
Display Parameters....................................CNFG - 4
Keyboard Parameters...................................CNFG - 5
Function Keys.........................................CNFG - 5
Clock Configuration.....................................CNFG - 6
Set Time..............................................CNFG - 6
Set Date..............................................CNFG - 6
Display Options.......................................CNFG - 6
Format Options........................................CNFG - 7
Sound Options.........................................CNFG - 7
Function Keys.........................................CNFG - 7
SYSTEM MESSAGES
Description...............................................ERR - 1
Informational Messages....................................ERR - 2
Procedural Error Messages.................................ERR - 3
System Error Messages.....................................ERR - 8
APPENDIXES
A - MEMBRAIN Documentation................................APP - A1
Description.............................................APP - A1
System Requirements.....................................APP - A1
Installation............................................APP - A1
Configuration Tips......................................APP - A2
Operational Characteristics.............................APP - A3
B - QLDR Documentation....................................APP - B1
Description.............................................APP - B1
Input Parameters........................................APP - B1
Output Return Code......................................APP - B3
C - QSYS Base Menu........................................APP - C1
GLOSSARY....................................................GLOS - 1
CONT - 2
SYSTEM MESSAGES
All QSYS system programs incorporate a comprehensive set of error
trapping and recovery routines. The System Messages returned by these
routines can be classified into three distinct groups. The group
classification of a particular message can be distinguished by the
accompanying tone(s) and the duration of display.
INFORMATIONAL MESSAGES
System Messages of this group are not posted as the result
of an error condition, but simply to convey the status of the
current function. They are characterized by the accompanying short
duration tone of medium pitch, unless the message is meant as a
warning, in which case the duration will be longer and the pitch
higher to draw your attention to the message line. This type of
message will be displayed for approximately 3 seconds. Recovery
action is not necessary.
PROCEDURAL ERRORS
System Messages of this group are posted as the result of an
incorrect operator action, such as an invalid data field entry.
They are characterized by a long duration, low-pitched tone and
are displayed for approximately 6 seconds. Recovery is usually
automatic.
SYSTEM ERRORS
System Messages of this group are posted as the result of a
critical error condition, such as a hardware or program failure.
They are characterized by the typical DOS ' beep ', sometimes
accompanied by a long low-pitched tone. These errors require an
operator response, and the available recovery options are listed
on the prompt line.
If the active screen at the time a message is posted happens to be
the DOS screen, then the message will display on the next available
line and processing will continue immediately. On any other screen, the
message will display on line 25 for the specified time and only then
will processing continue. In this case, the display of a message may be
terminated by pressing the <ENTER> key, unless the message includes
options for recovery.
ERR - 1
INFORMATIONAL MESSAGES
' task ' Placed in JOBQ
The task initiated from a menu or the command line has been
successfully added the JOBQ.
' task ' Placed in JOBQ * JOBQ Now Full
The last task initiated caused the JOBQ to reach it's
operational limit. Any attempt to initiate further tasks will
result in a JOBQ overrun.
JOBQ Empty
The JOBQ is empty. This message will be posted if an attempt
is made to display an empty JOBQ, a task is deleted from the JOBQ
leaving it empty, or if an attempt is made to release an empty
JOBQ for execution.
MSGQ Update Required * JOBQ Active
The system date has changed and QSYS is attempting to execute
the Message File Reorganization procedure, but the system has been
signed-off with tasks present in the JOBQ. The JOBQ tasks must be
deleted or released for execution before QSYS will automatically
initiate the file reorganization.
Message Added to MSGQ * MSGQ Now Full
The last message added to the MSGQ caused it to reach it's
operational limit. Any action which causes QMSG to attempt to add
another message to the queue will result in a MSGQ overrun.
MSGQ Empty
The MSGQ is empty. This message is posted if an attempt is
made to display an empty MSGQ, initiate the DISPLAY or PREVIEW
functions of QMSG when no messages are due for the active user,
or to signal the end of the DISPLAY or PREVIEW functions after
the last message due or pending has been displayed.
No Messages in File for 'user name '
An attempt was made to initiate the SEARCH/EDIT function of
QMSG, and no messages to which the active user is allowed access
exist.
Message File Empty
The message file is empty. This message is posted when any
attempt is made to initiate the SEARCH/EDIT function of QMSG and
the file contains no messages.
ERR - 2
PROCEDURAL ERRORS
SYS001 - PARAMETER OUT OF SPECIFIED RANGE
The data entered is outside the range of valid parameters
specified for this field.
Recovery: Enter a value inside the specified range.
SYS002 - INVALID RESPONSE
A response of other than the indicated valid choices for
the current field been entered.
Recovery: Retry the entry using a valid response.
SYS003 - INVALID TIME
The time entered is in an invalid format, or is outside the
range of the DOS 24 hour clock. This message might also be posted
in QMSG if the time entered on a message input screen is prior to
the current system time.
Recovery: Consult your DOS reference manual for information
concerning the format and range of valid time entries. Also,
if entering a time into a message, use the HELP function to
obtain the current system time. Retry the entry.
SYS004 - INVALID DATE
The date entered is in an invalid format, or is outside the
range of the DOS Calendar. This message might also be posted in
QMSG if the date is prior to the current system date.
Recovery: Consult your DOS reference manual for information
concerning the format and range of valid date entries. Also,
if entering a date into a message, use the HELP function to
obtain the current system date.
SYS010 - INCORRECT PASSWORD * ACCESS DENIED
The password entered does not match the password of any user
in the QSYS user list.
Recovery: Re-enter the correct password. If you are sure that the
password has been entered correctly, then press <Caps Lock>
and retry the entry. Consult a primary user if still
unsuccessful.
SYS011 - ACCESS DENIED TO THIS FUNCTION
Your Security Level is insufficient to access this function.
Recovery: Consult a Primary User to secure the necessary Security
Level for this function.
ERR - 3
PROCEDURAL ERRORS
SYS012 - USER UNKNOWN TO SYSTEM
An attempt was made to send a message to a user that is not
currently in the QSYS user list.
Recovery: Use the HELP function to check the list of QSYS users
and correct the entry.
SYS015 - INVALID NAME * BLANK OR DUPLICATE
An attempt has been made to log another user into the system
using a name that is already in use. QSYS requires that all user
names be unique.
Recovery: Retry the entry using a name different from those
already in use.
SYS016 - INVALID PASSWORD * MUST BE 5 DATA KEYS
An invalid key was pressed in a user password field while
attempting to log a new user into the system. QSYS will not allow
the use of cursor control, programmed function, or special purpose
keys when entering a password.
Recovery: Retry the entry using another password.
SYS017 - NO USER ENTRIES AVAILABLE
An attempt was made to log a new user into the system, but
QSYS already supports the maximum number of users.
Recovery: Consult a Primary User. A user must be deleted before
a new user can be logged in.
SYS018 - CANNOT ALTER PRIMARY USER
An attempt was made to delete or downgrade the security level
of the only primary user logged into the system. QSYS must retain
at least one primary user at all times.
Recovery: Assign a second primary user before attempting to alter
the first.
SYS020 - JOBQ OVERRUN * JOB CANCELLED
An attempt was made to initiate a task when the JOBQ was
already at it's operational limit. The new task was cancelled.
Recovery: Delete a JOBQ entry or release the JOBQ for execution
before attempting to initiate additional tasks.
ERR - 4
PROCEDURAL ERRORS
SYS030 - MSGQ OVERRUN * ENTRY LOST
QMSG attempted to add a message to the MSGQ, but it was
already at it's operational limit. This error can occur while
entering new messages for the current system date, editing
existing messages to include the current system date, or if more
than 50 messages are in the message file for the current system
date during the file reorganization procedure.
Recovery: If entering or editing messages, the message file will
be updated, but the MSGQ will not. If this error occurred
during file reorganization, allow the procedure to complete.
After displaying any messages that may be due, the message
file reorganization procedure can be executed a second time
to pick up any lost messages.
SYS031 - INVALID UPDATE FREQUENCY
An update frequency was entered that does not comply with
the format detailed for this field, or use of the specified update
frequency will result in a date which is outside the range of the
DOS calendar.
Recovery: Refer to 'Message Data Fields ' in the MESSAGES section
for the proper format of this field. Make sure that the year
of the date resulting from use of this frequency is less than
2100. Retry the entry.
SYS040 - CANNOT DELETE ACTIVE MENU
An attempt was made to delete a menu that contained active
task or menu descriptors.
Recovery: All descriptors must first be deleted from the menu
before QSYS will allow the menu to be deleted. Refer to
'Deleting Descriptors ' and 'Deleting a Menu ' in the MENU
SYSTEM section for more information.
SYS050 - INVALID VOLUME LABEL
The data entered is not valid for a DOS Volume Label.
Recovery: Consult your DOS reference manual under the 'VOL '
command for information concerning volume labels and then retry
the entry.
ERR - 5
PROCEDURAL ERRORS
SYS051 - INVALID DRIVE SPECIFICATION
The drive specified in a path or filespec is not known by
QSYS to exist, or the specified drive is an emulated drive and
only hardware drives may be specified for the current function.
Recovery: Correct the path or filespec entry to reflect a drive
specification that is valid for the current field.
SYS052 - INVALID DIRECTORY PATH
The directory path specified in a path or filespec entry is
not a valid DOS directory path. It contains illegal path names
or is more than 63 characters in length.
Recovery: Consult your DOS reference manual for information
concerning 'Tree Structured Directories '. Also note that in
QSYS, all directory paths must include the entire path from the
root directory to the file. Correct the entry.
SYS053 - INVALID FILENAME
The 'filename.ext ' specified is not a valid DOS filename.
Recovery: Consult your DOS reference manual for information
concerning 'Files and Filenames ' and retry the entry.
SYS054 - INVALID COMMAND
An internal DOS or JOBQ command, specified in a filespec
entry, is preceded by a drive and/or path specification.
Recovery: If the filespec is meant to be an internal DOS command,
then re-enter it without the drive and path specifications.
If the filespec entry reflects a filename that is the same as
one of the internal DOS commands, then QSYS will not support
this file.
SYS055 - INVALID PARAMETERS
An invalid parameter was passed to a program or command from
the DOS or QSYS command line. All parameters passed are discarded.
Recovery: If this error occurred in QLDR, the <ENTER> option is
unavailable, and the associated task, if any, is discarded
from the JOBQ. If the task must be executed, then select
option 4, DOS Command Processor, to execute the task.
ERR - 6
PROCEDURAL ERRORS
SYS058 - PATH 'directory path ' NOT FOUND
The indicated directory path was not found while searching
for a file.
Recovery: If this error occurred while attempting to change the
active menu, then the change is aborted and the parent menu
is reloaded. If a volume label is specified for the menu
descriptor, then the integrity of this generation of menus
is questionable.
If this error occurred while attempting to create a
new menu, then the create is aborted. QSYS will only create
menus in existing directories. The sub-directory will have to
be created using the DOS 'MD ' command from the command line,
or the menu descriptor will have to be changed to reflect an
existing directory.
SYS059 - FILE 'filename ' NOT FOUND
The indicated file does not exist in the directory that was
searched.
Recovery: If this error occurred while attempting to change the
active menu, then the change is aborted and the parent menu
is reloaded. If a volume label is specified for the menu
descriptor, then the integrity of this generation of menus
is questionable.
This error is normal while attempting to create a new
menu. No action need be taken.
SYS060 - INSUFFICIENT DISK SPACE
This error can occur while attempting to create a menu, or
during the message file reorganization procedure. It indicates
that the creation of a file cannot be performed because the media
to be used doesn't have enough free space.
Recovery: If this error occurs while attempting to create a menu,
then either the menu descriptor will have to be changed to
reflect a drive with sufficient free space, or space on the
indicated drive will have to be cleared before the menu can
be created.
If this error occurs during the file reorganization
procedure, it indicates that space, equal to the size of the
message file, could not be found on any of the installed
drives. The procedure will be aborted. Supply enough free
space for the procedure to be run on any drive, and retry
the procedure.
ERR - 7
SYSTEM ERRORS
ASM001 - ENVIRONMENT STRING ' string ' NOT FOUND
The indicated environment string was not found in the system
environment space. The program is terminated. This error can be
caused by improper installation of QSYS, an untrapped error in the
IPL sequence, modification of the AUTOEXEC.BAT, or modification of
the QSYS system environment strings.
Recovery: Re-IPL the system and retry the failing operation. If
the error persists it may be necessary to reinstall QSYS. If
a program error is suspected, please contact the author with
complete information about the error.
ASM002 - ERROR ## IN DIR FUNC ##
The directory operation identified by 'FUNC ## ' has failed
due the indicated error. The program is terminated. The causes of
this error can be the same as for ASM001. The following list of
errors can be used to help determine the cause of the error.
02 - file not found 26 - seek error
03 - path not found 27 - unknown media type
08 - insufficient memory 28 - sector not found
10 - invalid environment 29 - printer out of paper
15 - invalid drive 30 - write fault
20 - write protected 31 - read fault
22 - drive not ready 32 - general hardware failure
24 - data CRC error
The function being performed at the time of the error can be
referenced in the following table.
57 - Make Directory
58 - Remove Directory
59 - Change Directory
47 - Get Current Directory
Recovery: If the indicated error condition points to a hardware
failure, then correct the cause and retry the failing
operation. Otherwise, the recovery action is the same as
for ASM001.
ASM003 - ERROR ## IN FIND PROC
An error occurred while attempting to search a directory. The
program is terminated. The causes of this error are the same as
ASM001. Use the error descriptions listed under ASM002 to aid in
determining the cause of the error.
Recovery: Same as for ASM002.
ERR - 8
SYSTEM ERRORS
BAS001 - ERROR ### IN LINE #####
The indicated error has occurred. This is a 'catch all ' for
unexpected type errors. The program is halted awaiting an operator
response.
Recovery: Consult your BASIC reference manual under ' Error
Codes ' for a description of the error condition. If a
hardware error is indicated, then correct the cause and
select the 'Retry ' option from the choices given on the
screen. If the error condition persists, then it may be
necessary to take the 'Abort ' option and follow the
recovery procedure for ASM001. The 'Ignore ' option is
seldom desirable, and should only be taken if you KNOW
WHAT YOU'RE DOING!
INS001 - HARDWARE CONFIGURATION ERROR
The installation configuration program has determined that
the installed system equipment does not meet the requirements
necessary for the installation of QSYS. This error can also be
caused by incorrect setting of the system hardware switches, or
by the absence of both MEMBRAIN and a fixed disk.
Recovery: Refer to 'System Requirements ' in the PREFACE of this
document for information on the minimum configuration which
QSYS will support. If your equipment configuration meets this
criteria, it is possible that the memory size switches are
set incorrectly. If the cause is the absence of MEMBRAIN.SYS
from the installation diskette, then use MEMBRAIN.EXE and the
information supplied in APPENDIX A to recreate this device
with the parameters '20,128,1,16 ', and then restart the
installation from step 1.
INS002 - TOO MANY CONFIG.SYS ENTRIES
The Installation Configuration program found more than 20
entries in either the 'UCONFIG.SYS ' or 'CONFIG.SYS ' file. The
only option available is to abort the program.
Recovery: If a 'UCONFIG.SYS ' file is being used, then recreate
it with 20 or fewer entries. If no 'UCONFIG.SYS ' file is
being used, then the configuration program will correct the
error in the 'CONFIG.SYS ' file during termination. Restart
the installation from step 1.
ERR - 9
SYSTEM ERRORS
INS003 - #####K INSUFFICIENT MEMORY
The Installation Configuration program has determined that,
due to the QSYS file locations, or to the cumulative sizes of the
emulated drives on the system, the indicated amount of memory
must be recovered in order to execute QSYS.
Recovery: If the size of MEMBRAIN can be reduced by eliminating
the number of emulated QSYS files, then take the 'Retry '
option. Otherwise, the installation will have to be aborted.
If emulated drives, other than MEMBRAIN, are being used, it
may be possible to install QSYS without them.
INS004 - TOO MANY SUB-DIRECTORIES SPECIFIED
The QSYS file locations, as you have specified them in the
installation configuration program, contain more than the maximum
20 sub-directory names that the program can handle.
Recovery: Take the 'Retry ' option and respecify the QSYS file
locations using fewer sub-directories.
INS005 - #####K INSUFFICIENT FREE SPACE ON DRIVE d:
The specified drive does not contain enough free space for
all of the QSYS files that are to be located there, as specified
in the installation configuration program. This error can also
occur if the specified drive has been chosen as the drive for
creating the QSYS working diskettes and it's size is insufficient
to hold all of the files to be located on one of the other drives.
Recovery: Take the 'Retry ' option and re-specify the QSYS file
locations, requesting that fewer files be located on the
drive suspected of causing the error. The amount of free
space which must be recovered is indicated in the message.
ERR - 10
SYSTEM ERRORS
IPL001 - RESOURCES UNAVAILABLE
The required QSYS files are not present in the drives or
directories in which they where originally installed by the QSYS
INSTALLATION AID.
Recovery: If the QSYS files are located on removable media, then
you will be prompted in insert the correct diskette and press
<ENTER>. Execution of the AUTOEXEC.BAT will resume.
If the QSYS files are located on fixed media, then this
error is considered to be unrecoverable, and execution of the
AUTOEXEC.BAT is terminated. In this case, the QSYS files have
been moved from the locations assigned during installation,
and the QSYS system has been rendered unusable. The files
must be copied back to the correct drive and directories, or
QSYS must be re-installed.
IPL002 - QINT FAILURE
A failure occurred during the initialization of QINT. Either
no base menu specification was passed from the command line in the
AUTOEXEC.BAT file, or the specification was invalid.
Recovery: AUTOEXEC.BAT execution is aborted and control is passed
to the DOS command processor. The base menu specification
must be corrected, or QSYS must be re-installed.
IPL003 - QINT FAILURE
A failure occurred during the initialization of QINT. The
system environment space contained no 'QSPEC= ' parameter, or the
parameter was invalid. This parameter is used to locate QSYS.SYS.
Recovery: AUTOEXEC.BAT execution is aborted and control is passed
to the DOS command processor. The 'SET QSPEC= ' statement in
the AUTOEXEC.BAT file must be corrected, or QSYS must be
re-installed.
IPL004 - QINT FAILURE
An error occurred during the initialization of QINT while
attempting to open, read, or close QSYS.SYS. The most probable
cause is that QSYS.SYS was not found.
Recovery: AUTOEXEC.BAT execution is aborted and control is passed
to the DOS command processor. QSYS.SYS must be copied back to
the directory path indicated by 'QSPEC= ' in the environment,
or QSYS must be re-installed.
ERR - 11
SYSTEM ERRORS
IPL005 - QINT FAILURE
During initialization, QINT has determined that it has been
previously installed, or that another resident program conflicts
with it's operation. The most probable cause of this error is that
another program was executed before the QSYS startup procedure.
Recovery: AUTOEXEC.BAT execution is aborted and control is passed
to the DOS command processor. If AUTOEXEC.BAT execution was
not initiated from a DOS boot, then simply re-IPL the system.
Otherwise, QSYS may have been installed incorrectly, or one
of the device drivers specified in CONFIG.SYS conflicts with
the operation of QSYS.
ERR - 12
GENERAL INFORMATION
This section will describe functions common to all of the QSYS
system programs, including the INSTALLATION AID. This section should
be read by all users. It may provide a more clear understanding of
the installation and operation of the system in conjunction with the
more specific sections detailing each function. If a term is used in
this documentation with which you are unfamiliar, you may find it in
the GLOSSARY.
SECURITY SYSTEM
The QSYS security system provides a means of controlling access
to the various functions provided by the QSYS system. It is configured
through the use of security levels assigned to each user, task, and
menu.
Security levels might be thought of as the amount of restriction
which QSYS will provide for a given function. For example, a security
level of 9, assigned to a user, provides the most restriction, and a
security level of 0 provides no restrictions. A user with a security
level of 0 is known as a primary user. Primary users have access to
all functions of the system without restriction. Some QSYS functions,
for example, the QSYS Command Line and most system configuration func-
tions, are only accessible to primary users. There is no limitation,
other than the maximum of 24 QSYS users, on the number of users which
can be assigned primary user status.
Each user selects a private password for access to the system.
Passwords are never displayed, even while they are being entered. They
may be changed at any time, but only by the owning user. Each user is
assigned a security level by a primary user. No user has the ability to
upgrade his or her own security level.
Task and menu security levels are similar to user security levels.
A task with a security level of 0 is only accessible to primary users,
and a task with a security level of 9 is accessible to all users. In
general, a task or menu may only be accessed by users with a security
level equal to, or below the task or menu security level.
The message system treats all users equally. No user, including a
primary user, can access the private messages of another user, or the
private messages between users.
Details pertaining to the function of the security system, as
it applies to each area of QSYS operation, will be discussed in the
appropriate sections of this document.
GEN - 1
GENERAL INFORMATION
SCREEN FORMAT
======================================
= TITLE = <-- Line 1
=------------------------------------= <-- Line 2
= = <--
= Data Area = Lines 3-22
= = <--
=------------------------------------= <-- Line 23
= PROMPT LINE = <-- Line 24
= STATUS/MESSAGE LINE = <-- Line 25
======================================
All QSYS programs share a common display interface. Above is an
abbreviated diagram outlining the significant areas of the display
screen as used by QSYS.
The TITLE line is used to identify the current screen name. It
may be the name of a menu or the name of the function currently being
performed. The screens to some similar functions may be identical
except for the TITLE.
The DATA AREA of the screen is, as you might expect, used for
displaying the details of the function being performed. For example,
in the Menu System, this area would be used to display the current
menu. Similarly, in the Message System, this is where the text of the
message is entered and displayed. Lines 2 and 23 are usually used as
separators between the the separate sections of the screen.
The PROMPT line is used to display a prompt indicating the action
that currently needs to be taken by the user. The prompt may contain
information pertaining to the allowable entries in the current field,
or it may be used for inputting data or commands. Some error messages
will display the available recovery options on this line.
The STATUS/MESSAGE line serves a dual purpose. Normally, this line
indicates which functions are currently available, and the keys which
are used to activate them. QSYS may also use this line to display a
message to the user. The message may be of an informational nature, or
it may be the result of an error. Refer to the SYSTEM MESSAGES section
of this document for more information on messages.
GEN - 2
GENERAL INFORMATION
QSYS EDITOR
QSYS utilizes a keyboard input routine capable of functions
including the input of only certain classes of keys, controlling the
keyboard shift, formatting the input data, controlling the display
attribute of the input field, and measuring the time span between
keystrokes. It can manage field sizes of 0 characters a full page of
text, and offers the user control similar to that of the editor used
in the BASIC interpreter. This section will describe the use of, and
the keys supported by the QSYS editor.
- Cursor Control Keys
Left Arrow - Moves the cursor one character to the left if not
already at the beginning of the field.
Ctrl-Left - Moves the cursor to the beginning of the previous
word in a field, unless already at the first word,
in which case the cursor is moved to the beginning
of the current word.
Right Arrow - Moves the cursor one character to the right if not
already to the right of the rightmost character in
a field.
Ctrl-Right - Moves the cursor to the beginning of the next word
in a field, unless already at the last word, in
which case the cursor is moved to the end of the
field.
Up Arrow - Moves the cursor to the start of the previous field
if one is present.
Down Arrow - Moves the cursor to the start of the next field if
one is present.
Tab Left - Moves the cursor to the beginning of the field,
unless already at the beginning, in which case it
moves the cursor to the beginning of the previous
field if one is present.
Tab Right - Moves the cursor to the right of the last
significant character of a field, unless already
there, in which case it moves it to the beginning of
the next field if one is present.
Home - Moves the cursor to the beginning of the first
field of a data entry screen.
End - Signals the end of editing on a data entry screen.
GEN - 3
GENERAL INFORMATION
- Editing Keys
Backspace - Erases the character to the left of the cursor,
moves the cursor, the character at the current
cursor position, and all characters to the right
of the cursor position left one character.
Esc - Erases the field and positions the cursor at the
beginning of the field.
Ctrl-End - Erases the character at the cursor position and all
characters to the right of the cursor position
without changing the cursor position.
Ins - Toggle action key. Turns Insert mode on with the
first depression and off with the next. The cursor
size will change to indicate Insert mode. Insert
mode causes all characters entered to be inserted at
the current cursor position.
Del - Deletes the character at the current cursor position
and moves all characters to the right of the cursor
position one character left.
Enter - Terminates editing of the field. The field will be
assumed to contain the value seen on the screen
including any trailing spaces up to the cursor
position.
+ - The long grey ` + ' key on the numeric keypad acts
as a combination of Ctrl-End and Enter. Pressing
this key erases the character at the current cursor
position and all characters to the right of the
cursor and terminates editing of the field.
- Function Keys
The programmed function keys will be referenced as F1 thru F40
where F1 thru F10 are as designated on the keyboard. The Shift keys add
a value of 10, the Ctrl key adds a value of 20, and the Alt key adds a
value of 30 to the values marked on the keys. In most cases, the active
function keys will be displayed at the bottom of the screen.
- Special Purpose Keys
The Ctrl-Break sequence serves a special purpose in all of the
QSYS system programs. This key can be used in any input field, at any
time to sign-off the current user. However, caution should be exercised
in it's usage, since it's effect is immediate, and no system action is
taken to complete the current task. This key usually has the effect of
aborting the current function.
GEN - 4
GLOSSARY
BASE MENU
The first or default menu used by QSYS. This is the menu to which
all users initially sign-on after system startup.
CHILDREN
Menus which are accessed from other menus. Refer to the example
given in the 'MENU SYSTEM ' section.
GENERATION
A group of menus which includes the PARENT menu and it's CHILDREN.
Refer to the example given in the 'MENU SYSTEM ' section.
IPL
Initial Program Load, sometimes referred to as boot-up. Starting
the system from a power-off condition or a system reset such as the
Ctrl/Alt/Del sequence.
JOBQ
A batch file of user tasks to be performed in sequence. May
consist of programs, DOS commands or other batch files.
MSGQ
An area in storage containing pointers to pending messages for
the current system date.
PARENT
A menu which contains references to other menus. Refer to the
example given in the 'MENU SYSTEM ' section.
PRIMARY USER
A user with a security level of 0.
WINCHESTER DRIVE
A fixed disk. A storage device from which the media cannot be
removed.
GLOS - 1
QSYS INSTALLATION
The QSYS INSTALLATION AID was designed to minimize the task of
installing QSYS. For more standard equipment configurations, all that
may be necessary to install QSYS is for the installer to know his or
her name, and be able to make up a 5 letter password. Default options
will be provided, based upon information gathered by the configuration
program, for every other required field, and can be accepted by simply
pressing the <ENTER> key. The installation procedure will prompt for
any operator action necessary.
The less standard your equipment configuration, the more complex
the task of installation will become. The QSYS INSTALLATION AID has
facilities for handling very complex installations, but greater demands
are made on the knowledge of the installer when the complexity of the
installation increases.
Read the entire QSYS INSTALLATION section before attempting the
first installation. This will help you to understand the capabilities
of the installation procedure. It may also be helpful to run through
the installation once or twice before planning the final configuration.
It is possible to preview the installation without building any files
if the installation is aborted, by pressing Ctrl-Break, before termin-
ating step 2j. The installation procedure can be executed as often as
desired.
On a diskette system, the same diskettes may be used to install
QSYS many times. They will be reformatted during each installation.
Installation of QSYS on a PC-XT, or any system using a Winchester
disk involves a little more risk. It is imperative that your disk is
backed-up before attempting installation. If a trial installation is
made, installing the QSYS files in a new sub-directory will be helpful
if deletion of the QSYS files becomes necessary. It is not necessary
to create the sub-directory prior to installation. The installation
procedure will create sub-directories as needed. Be aware that all of
the startup files, AUTOEXEC.BAT, CONFIG.SYS, ANSI.SYS, MEMBRAIN.SYS,
and MODE.COM, plus any user defined files, will be located in the root
directory.
If an error occurs during the installation procedure, an error
message will be displayed indicating the type of error that occurred.
Refer to the SYSTEM MESSAGES section for a detailed explanation of the
cause of the error, and possible recovery actions.
BEFORE INSTALLATION
- Backup Your System
If you are installing QSYS on a Winchester drive, it is YOUR
responsibility to backup your present files. Also, make sure that the
root directory and any already existing directories into which QSYS
files will be copied, contain no files with filenames that match the
filenames of any of the QSYS files. Refer to the list of QSYS files
in the PREFACE of this document.
INST - 1
QSYS INSTALLATION
- Backup QSYS
Use the following procedure to make a working copy of the QSYS
INSTALLATION and QSYS DOCUMENTATION diskettes. These copies will not
only provide a measure of insurance against loss, but are necessary
to provide a copy of DOS and the DOS utility files that are required
by the installation procedure.
1) FORMAT a Blank Diskette
Use the 'FORMAT ' command and include the '/S ' parameter
so that DOS will be copied to the formatted diskette.
2) COPY the QSYS Files
Use the 'COPY ' command with the global filename of '*.* '
to copy all of the QSYS files from the QSYS installation diskette
to the diskette formatted in step 1.
** Do NOT use 'DISKCOPY ' **
3) COPY DOS Files
Copy the 'FORMAT.COM ', 'MODE.COM ', and 'ANSI.SYS ' files
to the diskette formatted in step 1.
4) Backup QSYS DOCUMENTATION
Use 'COPY *.* ' or 'DISKCOPY ' to make a backup copy of the
QSYS DOCUMENTATION diskette.
Store the original copies of the QSYS INSTALLATION and QSYS
DOCUMENTATION diskettes in a safe place. All future references will
be to the working copies made in the previous steps.
INST - 2
QSYS INSTALLATION
INSTALLATION
1) USER CONFIGURATION FILES
The following preliminary steps in the installation process are
necessary to ensure that the QSYS configuration program is able to
correctly evaluate all system equipment to be used with QSYS. This
is especially important in the area of storage devices, such as
device drivers for other than IBM Winchester drives, emulated disks
other than MEMBRAIN, which is included with QSYS, and other devices
that require a 'DEVICE= ' entry in 'CONFIG.SYS ', or a setup program
to be run as part of the system startup procedure. Any devices that
are not defined when the installation program evaluates the system
equipment may not be usable with QSYS. Steps 1a, 1b, and 1c provide
an interface for user defined CONFIG.SYS and AUTOEXEC.BAT entries.
1a) CONFIG.SYS Entries
The QSYS INSTALLATION diskette created in the previous steps
contains a default 'CONFIG.SYS ' file containing the following
entries:
BUFFERS=5
DEVICE=ANSI.SYS
DEVICE=MEMBRAIN.SYS
This file will be used by DOS for configuration information during
the installation procedure, and will then be copied to the QSYS
media for use by DOS when QSYS is IPL'ed. Most installations will
not require additional DOS configuration and may skip this step.
However, if you desire to alter this minimum configuration, the
necessary entries should be copied to a file on the installation
diskette called 'UCONFIG.SYS '. The 'CONFIG.SYS ' file should not
be altered. The following example illustrates how to create this
file.
COPY CON: UCONFIG.SYS 'Type this DOS command
BUFFERS=10 'Enter the necessary entries
'' ' ''
^Z 'Press F6 and <ENTER>
INST - 3
QSYS INSTALLATION
1b) USEREXEC.BAT File
The 'USEREXEC.BAT ' file is a mechanism for introducing user
defined programs into the installation IPL sequence. This file
will be called from the installation 'AUTOEXEC.BAT ', if it exists.
The file specifications and parameters for programs required to
install drivers for storage devices, such as emulated disks, that
will be used in conjunction with QSYS, must be specified in this
file on the installation diskette. The following example shows the
steps necessary to create this file.
COPY CON: USEREXEC.BAT 'Type this DOS command
EXAMPLE.COM 'Enter the necessary entries
'' ' ''
^Z 'Press F6 and <ENTER>
1c) AUTOEXEC.BAT Entries
The QSYS configuration program will create an 'AUTOEXEC.BAT '
file that DOS will execute every time QSYS is booted. Any files
specified in steps 1a and 1b should be copied to the installation
diskette.
In addition, the configuration program will prompt for the
file specifications of programs or batch files that are to be
included in the QSYS startup procedure. The configuration program
will test for the existence of all files specified, and will not
accept internal DOS commands. If this type of entry is desired in
the IPL sequence, a batch file must be created on the installation
diskette in this step, containing these entries. It is not good
practice to specify other than internal DOS commands in a user
batch file, since doing so will hinder the ability of the config-
uration program to correctly evaluate the required free space on
the IPL drive.
In short, any files that will be used in the installation
of QSYS, or in the QSYS startup procedure, must be present on the
installation diskette.
NOTE: It is not possible to define the correct procedure for installing
every possible non-standard device available for the IBM-PC. The above
interfaces are provided to handle most situations, but in some cases,
the installation procedure will have to be modified in order to ensure
that certain devices are usable with QSYS. The key is to be sure that
any device that is to be used with QSYS is installed at the time that
the QSYS INSTALLATION AID performs it's equipment determination.
INST - 4
QSYS INSTALLATION
2) QSYS INSTALLATION AID
The following installation procedure will create all of the system
files that QSYS will require. The configuration program will prompt for
the necessary information. Default data for most fields is available by
leaving the field blank and pressing the <ENTER> key. Any fields that
are not required will automatically be skipped. The up-arrow can be
used to back up to a previous field and change an entry. In extreme
cases, the Ctrl-Break sequence can be used to abort the installation.
If the installation is aborted it must be restarted from step 1.
2a) Re-IPL the System
Insert the backup copy of QSYS created in the previous steps
into drive A. Insert media into all remaining drives if necessary.
Any dual-sided diskette drives should contain diskettes formatted
as 2D diskettes so that the configuration program can correctly
determine the type of drive installed.
Press ' Ctrl,Alt,Del ' or power the system off and then back
on. The installation 'AUTOEXEC.BAT 'will begin execution.
If you created a 'UCONFIG.SYS ' file in the previous steps,
and this is the first time at this step, then proceed to step 2b.
Otherwise, if you created a 'USEREXEC.BAT ' file in the previous
steps, it will be executed now.
2b) System Configuration Check
The configuration program will first check the installed
hardware on your system. This equipment determination assumes
that all hardware configuration switches in your system are set
correctly. If the required hardware, as described in the PREFACE
of this document, is found, then the QSYS logo will appear.
Otherwise, an error message will be posted and the installation
procedure will abort.
2c) Create 'CONFIG.SYS ' File
If you created a 'UCONFIG.SYS ' file in step 1a, then it's
contents and the default 'CONFIG.SYS ' entries will be combined,
the 'UCONFIG.SYS ' file will be deleted, and the configuration
program will auto-IPL the system, restarting the installation with
step 2a. Otherwise, this step is omitted.
INST - 5
QSYS INSTALLATION
2d) Resource Determination
The installation diskette will be checked for the presence
of the files necessary for the installation of QSYS. If any are
missing, an error message will be posted naming the missing file
and the installation will be aborted. If the file named in the
error message was 'CONFIG.SYS ', then the default file will be
recreated during termination of the configuration program and the
installation may be restarted at step 1. Otherwise, the missing
file must be copied to the installation diskette before restarting
the procedure.
2e) Drive Configuration
The configuration program will attempt to determine the type
and size of all installed drives. If an error is encountered due
to a drive not ready condition, the configuration program will
prompt for you to install media in the drive and press <ENTER>.
If the mother board configuration switches in your system indicate
more drives than are actually installed, this prompt may request
media for the non-existent drives. If this occurs, pressing F10
will bypass the test for the erroneous drive. F10 should not be
used to bypass tests for installed drives, since doing so will
render the drive unusable with QSYS.
After the determination is made, a summary of the system
hardware configuration is displayed, with a prompt asking if the
configuration is correct. The determination procedure cannot
distinguish between emulated and hardware drives, except in the
case of MEMBRAIN. If all of the drives installed on your system
have been determined correctly, then press <ENTER> and proceed to
the next step.
If any of your double-sided diskette drives contained single-
sided media, you can change to double-sided media now and press
the up-arrow, causing the drive determination to be repeated.
Entering an 'N ' and pressing <ENTER> will display an arrow
pointing to the configuration entry for the first drive which is
a possible emulated drive with a prompt asking if that particular
drive is an emulated drive. Entering a 'Y ' and pressing <ENTER>
will change the configuration entry to indicate that this drive is
emulated. Pressing <ENTER> alone will repeat the above prompt for
the next possible emulated drive until all possible drives have
been confirmed. The up-arrow may be used to repeat the prompt for
a previous drive. After the prompt is repeated for all possible
drives, you will again be asked if the configuration is correct.
INST - 6
QSYS INSTALLATION
2f) Monitor Type
Attempting to display color on a monochrome display attached
to the Color/Graphics Display Adapter will, in some cases, degrade
resolution, resulting in unreadable characters being displayed.
This parameter will allow QSYS to disable color burst if necessary
in order to provide the highest quality display.
If you have a color monitor connected to your Color/Graphics
Display Adapter, then enter a '1 ' and press <ENTER>. Otherwise,
just press <ENTER> to accept the default of 0.
2g) Primary User
- Primary User Name:
Enter the name that the system will use to distinguish you
from other users. This entry can be up to 10 characters in length.
- Password:
Enter a password to be used for access to the system. It must
be 5 data keys. No control keys or programmed function keys are
allowed. The characters will not be displayed as they are entered.
2h) File Locations
The following prompts will ask you to identify where the
installation procedure should locate the necessary QSYS system
files. Leaving a field blank will result in the configuration
program determining a default, based upon information gathered
in the equipment determination. Any files that are located on
MEMBRAIN will automatically increase the size of MEMBRAIN to
accommodate the added file, and consequently decrease the amount
of available memory for program execution. If the resulting
memory size is insufficient to execute QSYS, then an error will
be posted and you will be given the opportunity to re-specify
the file locations. Similarly, if the total size of the files
located on a particular drive exceeds the space available on
that drive, then an error will be posted and a retry of the file
location specifications will be available.
- QSYS Path:
This field identifies the drive and directory path used to
locate QSYS.EXE, QSYS.SYS, SYSTEM.MNU, and the default locations
for JOBQ.BAT and QLDR.COM. All path parameters are entered in the
format 'd:\directory\directory... '. For example, if QSYS is to
be installed on drive A, in a directory called 'QSYS ' then you
would enter 'A:\QSYS '. If you want it to be installed in the root
directory, then you would enter only 'A:\ '. QSYS must be located
on the drive from which DOS will be booted. Only entries which
specify the drive from which the installation aid was booted, or
a fixed disk, are considered valid.
INST - 7
QSYS INSTALLATION
- QSYS Vol-id:
The Volume Label of the diskette on which the files specified
under QSYS Path will be installed. It can be up to 11 characters
in length. If the QSYS path indicates a fixed disk, this field is
bypassed. A default is given if the field is left blank.
- QSYS Emulated Path:
Entering a path name in this field will cause the path to be
created, if necessary, and QSYS.EXE to be copied to the indicated
emulated drive during 'AUTOEXEC.BAT ' execution. This allows QSYS
to be reloaded very quickly when necessary, but costs memory.
- JOBQ Path:
The drive and directory path used to locate JOBQ.BAT and it's
associated QLDR.COM file. This path must equate to either a fixed
disk or an emulated drive. The default is the root directory of
MEMBRAIN.
- QCNFG Path:
The drive and directory path used to locate the QCNFG.EXE.
The specified drive must equate to a hardware drive. The default
is QSYS' path.
- QCNFG Volid:
The Volume Label of the diskette on which QCNFG.EXE is to be
installed. It can be up to 11 characters in length. If QCNFG path
indicates a fixed disk, then this field is bypassed. A default is
given if necessary.
- QCNFG Emulated Path:
Entering a path name in this field will cause the path to be
created, if necessary, and QCNFG.EXE to be copied to the indicated
emulated drive during 'AUTOEXEC.BAT ' execution. This allows QCNFG
to be reloaded very quickly when necessary, but costs memory.
- QMSG Path:
The drive and directory path used to locate the QMSG.EXE,
QINT.EXE, and MSGS.DAT. The specified drive must equate to a
hardware drive. The default is QSYS' path.
- QMSG Volid:
The Volume Label of the diskette on which QMSG.EXE is to be
installed. It can be up to 11 characters in length. If QMSG path
indicates a fixed disk, then this field is bypassed. A default is
provided if necessary.
INST - 8
QSYS INSTALLATION
- QMSG Emulated Path:
Entering a path name in this field will cause the path to be
created, if necessary, and QMSG.EXE to be copied to the indicated
emulated drive during 'AUTOEXEC.BAT ' execution. This allows QMSG
to be reloaded very quickly when necessary, but costs memory.
2j) User AUTOEXEC.BAT Files
This section allows you to insert a message to be echoed to
the display during 'AUTOEXEC.BAT ' execution on the first line
of each entry, followed by the file specification and parameters
necessary for DOS to execute the programs that were copied to the
installation diskette in step 1c on the next line. Files named in
'USEREXEC.BAT ' in step 1b must be respecified in this step.
The following example installs an in memory spooler during
'AUTOEXEC.BAT ' execution.
==========================================================
= QSYS INSTALLATION AID =
= ====================================================== =
= 1) Loading Print Spooler =
= SPOOLER.EXE parm1,parm2,etc =
= 2) _ =
= =
= 3) =
= ====================================================== =
= Enter User Autoexec Loading Message =
= QSYS 3.00 (C) Copyright 1984 Dennis Lee =
======================================================== =
- User Autoexec Loading Message
This field allows you to enter a remark that will be echoed
to the screen prior to execution of the associated file specified
on the following line. It may be up to 70 characters in length, or
may be omitted.
- User Autoexec File Specification
This field allows the specification of files to be executed
during the QSYS startup procedure. The entire filename and exten-
sion of the file must be specified, followed by any parameters to
be passed to the file. The drive and path for each file is assumed
to be the IPL drive's root directory, and must not be entered.
It is recommended that batch files specified in this field
only contain internal DOS commands. The configuration program will
not correctly evaluate the free space required on the QSYS disks
for files named in a batch file, nor will these files be copied to
the QSYS disks.
INST - 9
QSYS INSTALLATION
BASIC programs specified in this field must be specified in
the format 'BASIC(A).COM filename.ext '. With this type of file,
the configuration program will allocate file space on the QSYS
diskettes only for BASIC(A), not for the file specified in the
parameter of the command, and the file will not be copied to the
QSYS diskettes.
Either entry may be omitted, but if both are left blank, it
is assumed that entry of user autoexec items is complete. Up to
20 messages and/or associated files may be entered, 10 on the
first page, and 10 more on the second. The up-arrow may be used
to back-up to a previous entry or even to the previous screen.
After entry is completed, the installation diskette will be
searched for each specified file. If any of the specified files
are not found, an error message is displayed momentarily, and you
will be asked to correct the missing file specification.
2k) Build QSYS Files
Unless errors are found due to insufficient memory or file-
space, the rest of the installation procedure should run to
completion without intervention, except for prompts to insert
diskettes as needed. The prompts will vary from one installation
to the next, due to differences in system configuration and file
locations. Follow the prompts on the display as the installation
procedure creates the necessary files and installs QSYS on the
proper media.
2l) Installation Housekeeping
After installation of the QSYS files, the installation
procedure will clean up the installation diskette, removing any
temporary files created in the process. Only the QSYS files and
and the DOS files installed in during the BEFORE INSTALLATION
steps should remain.
2m) Re-IPL the System
The last step of the installation procedure instructs you
to press 'Ctrl,Alt,Del ' or power off and then back on. Refer to
the SYSTEM STARTUP section for detailed information on the startup
procedure. Read the AFTER INSTALLATION section.
INST - 10
QSYS INSTALLATION
AFTER INSTALLATION
- Required Operating Files
QSYS will expect that 'COMMAND.COM ' and any versions of BASIC
that will be required to load your programs are present in the root
directory of the drive from which the system is booted. On diskette
systems, these may reside on any available diskette. QSYS will prompt
for these files as they are required in the loading process.
- Default SYSTEM MENU
As a result of the installation procedure, the base menu of the
system was created. This menu was named 'SYSTEM MENU ' and was located
on the same drive and in the same directory as QSYS.EXE. The base menu
initially contains references to the Message System and to the QSYS
Configuration program modules. Although none of the QSYS system files
should be relocated without the aid of the installation procedure, the
menu references may be relocated as desired. Refer to APPENDIX C for
technical information concerning the base QSYS menu.
- MEMBRAIN Configuration
The installation procedure will adjust MEMBRAIN to the minimum
size necessary for operation of the QSYS system in the configuration
that you have specified. It will be configured with 128 bytes/sector,
1 sector/cluster, and the minimum number of directory entries. Refer
to APPENDIX A for detailed instructions on configuring MEMBRAIN to
your specifications. It is not recommended that MEMBRAIN's size be
adjusted downward even though free space may appear to exist. Upward
adjustment will be limited by the amount of available memory in your
system. QSYS may not execute dependably in less than approximately
130K. 'CHKDSK ' can be used to aid in determining the amount of free
memory that may be allocated to MEMBRAIN.
INST - 11
JOBQ
- JOBQ Description
The JOBQ is a dynamic batch file from which all other programs,
batch files, and commands are located and executed. QSYS executes all
tasks through this facility. The JOBQ can operate in one of two modes,
as controlled from the menu system, using the F18 function key. In
immediate or 'Execute ' mode, any task selected from a menu, or entered
on the QSYS command line, is executed immediately. In batch or 'Queue '
mode, up to 20 tasks selected for execution, are stacked, allowing a
batch of tasks to be executed sequentially with little or no operator
intervention. In either mode, the JOBQ will automatically reload QSYS
after the last task in the queue has terminated.
After the JOBQ is released for execution, a QSYS module called
QLDR.COM provides resource availability services, such as prompting
for media changes as required, supplies the loading services required
for executing batch files and BASIC programs, as well as providing
error recovery routines. QLDR also allows extensive user control over
JOBQ execution, including the ability to re-execute previous tasks,
cancel tasks in the JOBQ awaiting execution, cancel the JOBQ and return
to QSYS, or call the DOS command processor to execute any other task
while the JOBQ is temporarily suspended.
- Special JOBQ Commands
- EXIT
The EXIT command terminates QSYS and passes control to the
DOS command line. QSYS can be restarted by invoking the JOBQ. QSYS
should never be invoked directly, since doing so will disable all
JOBQ execution functions.
- QLDR jt,d:,volid,path,filename.ext,parms
The QLDR command causes QLDR.COM to be invoked from the JOBQ
directly. Refer to 'JOBQ Execution Services ' and APPENDIX B for
detailed information concerning QLDR.
- Use of DOS Batch File Commands and Labels in the JOBQ
Since JOBQ.BAT is a DOS batch file, it is also possible to inter-
mix DOS batch file commands and labels with other tasks, providing
even greater user control. QSYS reserves two labels for it's own use
in the JOBQ. The first consists of the word 'JOB ' plus a number from
00 to 20. The second is the label ':END '. Refer to your DOS manual for
detailed information on the use of DOS batch file commands and labels.
- Use of QLDR.COM in User Batch Files
Refer to APPENDIX B for technical information concerning the use
of QLDR.COM in your own batch files.
JOBQ - 1
JOBQ
- Pre-Release JOBQ Functions
The following functions are available only when the JOBQ is in
'Queue ' mode. These functions are made available to the user through
the JOBQ screen. The JOBQ screen is accessed by pressing F8 at any QSYS
menu. From this screen, tasks in the JOBQ can be viewed, deleted, or
their sequence of execution changed before the JOBQ is released.
Following is a list of the functions available.
- PgUp or PgDn
If more entries are in the JOBQ than can be displayed on one
screen, the PgUp and PgDn keys will allow you to move forward and
backward from page to page as necessary. In the event that JOBQ
entries are deleted to the point that all entries can be displayed
on one screen, the PgUp and PgDn keys will be deactivated.
- F5 Change Sequence
Press F5, enter the current sequence number of the JOBQ
entry to be moved, a dash (-), and then the sequence number you
want it moved to. The JOBQ entry will be removed from it's current
position and inserted immediately before the the designated target
entry. The screen will be updated and the cursor will return to
the command line awaiting the next command.
Any error in the sequence number entries, including an empty
JOBQ entry specified as either source or target will produce an
error message momentarily and then the sequence number entries
may be retried.
- F6 Delete
After pressing F6, QSYS will prompt for the sequence number
of the JOBQ entry you would like to delete. After you enter the
sequence number, QSYS will echo the number you have entered and
ask you to confirm the entry. If the number is correct enter a
'Y ' and press <ENTER>. The entry will be deleted, the screen
updated, and the cursor will return to the command line awaiting
the next command. If the number is not correct, any entry besides
'Y ' will cancel the delete command.
If an invalid sequence number is entered, an error message
will be displayed momentarily and then the sequence number entry
may be retried.
- F38 Release JOBQ
Passes control to DOS for execution of the JOBQ.
- F10 End
Returns you to the menu system.
JOBQ - 2
JOBQ
- JOBQ Execution Services
A QSYS module named QLDR.COM provides services for checking the
existence of all files that are placed in the JOBQ before allowing DOS
to attempt execution. This allows QSYS to prompt for proper media when
possible, and to alert the operator of missing resources and provide
error recovery for those conditions that would otherwise cause JOBQ
task execution to be aborted without user control. If an error occurs,
a message indicating the operator action that needs to be taken, or
indicating the condition that caused the halt is posted, followed by
the following menu.
1) Re-run Previous Task
2) Cancel Current Task
3) Cancel the Batch File
4) DOS Command Processor
Press <ENTER> to Continue or Select Option: _
Note that option 4 is only available to primary users. Options are
selected from the menu by entering the number of the desired option.
The <ENTER> key is not required for options 1-4. All other keys are
ignored. The following chart explains each available option.
<ENTER> - Continues execution of the JOBQ, after the error condition
which caused the halt is corrected.
1 - Re-executes the previous task in the JOBQ.
2 - Cancels the current task, and continues execution of the
JOBQ with the next task in the queue.
3 - Cancels the entire JOBQ and returns to the QSYS menu system.
4 - Temporarily suspends JOBQ execution, and loads the DOS
Command Processor. While in the DOS command processor, any
program, batch file, or DOS command can be executed. Entering
the 'EXIT ' command will exit DOS, re-display the option menu,
and allow further option selection, including continuation of
the JOBQ at the point at which it was interrupted.
- JOBQ Execution Control
All options available due to an error condition, as explained
under 'JOBQ Execution Services ', are also available through a user
JOBQ interrupt mechanism provided in QLDR. Pressing the Esc key as a
task is terminating, will activate the user interrupt. QLDR will post
a message, indicating that the halt is a result of a user request,
followed by the option menu. All options listed on the menu are avail-
able. It is possible to move forward or backward several tasks within
the JOBQ by selecting the appropriate option and immediately pressing
the Esc key again to re-display the option menu. Each time QLDR halts
it will display the current task to be performed, allowing the user to
track the current position within the JOBQ.
JOBQ - 3
MENU SYSTEM
- DESCRIPTION
The QSYS menu system is the interface between the system users
and DOS. It provides a means of cataloging any task that DOS 2.X is
capable of executing. A task can be a program, batch file, or DOS
command. The menu system allows any task to be executed immediately,
or placed in the JOBQ for execution as a batch, by simply selecting
an option from any of an unlimited number of user defined menus. The
menu system is tree-structured in design, similar to the DOS tree-
structured directory system. This design allows totally free-form
creation of menus to suite almost any need. The following example
menu system illustrates the tree-structured concept.
.....................
: SYSTEM MENU :
:-------------------:
: Parent of :
: MENU 1,2 & 3 :
:...................:
__________________________|__________________________
..........|.......... ..........|.......... ..........|..........
: MENU 1 : : MENU 2 : : MENU 3 :
:-------------------: :-------------------: :-------------------:
: Child of SYSTEM : : Child of SYSTEM : : Child of SYSTEM :
: Parent of MENU 1A : : Parent of 2A & 2B : : Parent of MENU 3A :
:...................: :...................: :...................:
..........|.......... | ..........|..........
: MENU 1A : | : MENU 3A :
:-------------------: | :-------------------:
: Child of MENU 1 : | : Child of MENU 3 :
: : | : :
:...................: | :...................:
________________|________________
..........|.......... ..........|..........
: MENU 2A : : MENU 2B :
:-------------------: :-------------------:
: Child of MENU 2 : : Child of MENU 2 :
: : : :
:...................: :...................:
The above example illustrates only a small part of one possible
structure. The basic concept of the QSYS menu system is the relation-
ship between 'parent ' menus and their 'children '. This relationship
forms a 'generation '. For example, in the illustration above, the
SYSTEM MENU is the 'parent ' of MENU 1, MENU 2, and MENU 3. Together
these menus form a 'generation '. Even though MENU 1,2, and 3 each have
'children ' of their own, the children are outside of SYSTEM MENU's
generation, and may not be directly affected by changes to SYSTEM MENU.
Similarly, MENU 2A and MENU 2B are children of MENU2, and together
these three menus form a separate generation. All of the generations
put together form a sort of menu tree. This relationship accounts for
the term 'tree-structured '.
MENU - 1
MENU SYSTEM
- TASK SELECTION
The primary function of the menu system is to provide the user
with a quick and easy method of loading and executing tasks. This
function is accomplished in one of two ways. Once a task has been
defined on a QSYS menu, using the MENU EDITOR, it can be selected for
execution by simply entering the number to the left of the task name.
In addition to this method, tasks may be executed directly from
the QSYS command line, which is available on every menu. Refer to the
detailed explanation of the QSYS Command Line in this section for more
information concerning the use of the command line.
All tasks selected, regardless of which method is used, are
executed through the JOBQ either in immediate mode or in batch mode.
With the JOBQ in 'Queue ' or batch mode, an informational message will
be momentarily displayed indicating the status of the task in the JOBQ.
In 'Execute ' or immediate mode, the task is placed in the JOBQ, and
QSYS immediately passes control back to DOS for execution of the JOBQ.
Refer to the JOBQ section for detailed information concerning the JOBQ
and task execution control.
- MENU SELECTION
The selection of menus is accomplished similarly to the selection
of tasks. A menu that has been pre-defined using the MENU EDITOR, can
be selected from it's parent menu by entering the number to the left
of the menu name, while viewing the parent menu. If a change of media
is required to access the selected menu, QSYS will prompt for it by
volume label. The name of the menu, as displayed on the parent menu,
will be used in the title line at the top of the selected menu.
A menu can also be accessed directly from the QSYS command line by
entering the drive, path, and filename of the menu. In this case, QSYS
cannot prompt for a change of diskettes, if one is required. Instead,
an error message indicating that the file was not found is issued, and
the request is ignored. If the requested menu is found, the filename
will be used in the title line followed by the word 'MENU '.
Regardless of how a menu was accessed, the F9 key will return you
to the parent menu, unless the current menu is the base menu. F19 will
return you to the base QSYS menu from any other menu.
MENU - 2
MENU SYSTEM
- AVAILABLE FUNCTIONS
The bottom line of every menu lists, in an abbreviated format,
most of the functions available from the menu system. Following is a
short explanation of each function, and a reference to the section
containing more detailed information on the use of that function.
KEY FUNCTION DESCRIPTION
--- --------------------
F7 If messages are available, pressing F7 will display a
summary of the MSGQ. Otherwise, an informational message
will be displayed to inform the user that the MSGQ is
empty. Refer to the MSGQ section for more information.
F8 If tasks have been placed in the JOBQ, then pressing
F8 will display the contents of the JOBQ and activate
the JOBQ functions. Otherwise, an informational message
is displayed to inform the user that the JOBQ is empty.
Refer to the JOBQ section for more information.
F9 Returns to the current menu's parent menu. If this menu
has no parent, then the request is ignored.
F10 Signs-off the current user and returns to the Clock-
Calendar.
F18 This is a toggle action key which toggles the current
mode of the JOBQ. The current mode is displayed on line
25 as either 'F18 Execute ', if the JOBQ is in immediate
mode, or 'F18 Queue ' if tasks selected for execution
are to be executed as a batch. Refer to the JOBQ section
for more information.
F19 Returns to the base QSYS menu, regardless of the current
position in the menu system.
F39 Invokes the MENU EDITOR, if the current user has primary
user security. This option is not displayed on line 25.
Refer to the MENU EDITOR section for more information.
F48 If tasks have been sent to the JOBQ, then pressing F48
will release the JOBQ for execution. Otherwise, an
informational message is momentarily displayed, and the
request is ignored. Refer to the JOBQ section for more
information.
MENU - 3
MENU SYSTEM
- QSYS COMMAND LINE
The QSYS command line is similar to the DOS command line. It
provides a means of executing tasks that are not defined in the menu
system. Any DOS command that can be executed from the DOS command line
can be entered on the QSYS command line. In addition, batch commands
and labels may be entered on the QSYS command line for use in the JOBQ.
Refer to the JOBQ section for information concerning the use of DOS
batch file commands and labels in the JOBQ.
Since any task or menu can be directly accessed from the command
line, it is necessary that the QSYS security system assume that all
tasks and menus accessed in this manner have a security level of 0.
This restricts the use of the QSYS command line to only primary users.
The format of commands entered on the QSYS command line is the
same as that of the DOS command line with a couple of exceptions. The
following example will illustrate these differences.
- Executing '.COM ', '.EXE ', or '.BAT ' Files
EXAMPLE:
Suppose that you wanted to execute a program named 'PROG1.EXE '
from drive A, in a sub-directory named 'SUBDIR1 '.
On the DOS command line you would insert the proper diskette, if
necessary, and enter the following commands.
CD A:\SUBDIR1 ' Change to the proper directory
PROG1 ' Execute the program
On the QSYS command line you would enter the following command.
A:\SUBDIR1\PROG1.EXE
QSYS will notify you if either the sub-directory or the requested
program is not found, and allow you to change media as necessary. QSYS
will then change to the indicated sub-directory, and load the requested
program. The significant difference is, that all requests for executing
programs, batch files, and external DOS commands, that are not resident
in the root directory of the default drive, are entered in the format
illustrated below.
d:\directory\filename.ext parameters
| | | |
| | | Parameters to be passed
| | Filename and extension
| Directory path
Drive
MENU - 4
MENU SYSTEM
NOTES:
1) QSYS will always assume the default drive, if one is not
specified, except when loading 'COMMAND.COM ', 'BASIC.COM ',
or 'BASICA.COM ', which are assumed to be on the drive from
which QSYS was booted, regardless of which drive is the
default.
2) QSYS will assume the root directory, if one is not specified,
regardless of which directory was last used. The directory path
may include multiple sub-directory names, but must always be
specified starting at the root directory.
3) QSYS will assume an extension of '.BAT ', if one is not
specified. Therefore, it is good practice to always specify a
filename extension.
4) Note 3 does not apply to external DOS commands. QSYS knows, and
will automatically add the proper extension, if necessary, to
all utilities supplied with DOS.
- Executing BASIC Programs
The format of commands necessary to load BASIC programs remains
identical to that of the DOS command line, since the above conventions
are also used by DOS. It is important to note however, that QSYS will
assume that BASIC or BASICA, whichever is specified in the command,
will always reside in the root directory of the drive from which DOS
was booted. The following example illustrates the format used for
executing BASIC programs.
EXAMPLE:
Suppose that you wanted to execute the BASIC program 'PROG2.BAS '
from drive B, in a sub-directory named 'SUBDIR2 ', that required BASICA
(advanced BASIC).
On either the QSYS or DOS command lines you would enter the
following command.
BASICA B:\SUBDIR2\PROG2
Again, QSYS will assume that 'BASICA.COM ' can be found in the
root directory of the drive from which DOS was booted, and no drive
or directory path should be specified.
NOTES:
1) QSYS will assume an extension of '.BAS ' for BASIC programs,
unless one is specified.
2) The '.COM ' extension for BASIC or BASICA need not be entered.
MENU - 5
MENU SYSTEM
- MENU EDITOR
The MENU EDITOR provides functions for adding and deleting tasks
from the currently displayed menu, as well as for creating new menus
and deleting existing menus from the menu system.
The MENU EDITOR is accessed by pressing F39 (Ctrl-F9) at any menu.
Only primary users are allowed access to the MENU EDITOR. This is
necessary to prevent unauthorized access to existing tasks or menus by
creating a duplicate entry with a lower security level.
Upon entering the MENU EDITOR, the title line will display the
current menu name, plus the word 'EDITOR ' to identify the function
currently being performed. You will be prompted to enter the selection
number of the menu item to be edited.
- Task or Menu Descriptors
Before discussing the functions available in the editor, it is
important that you understand what kind of information is associated
with a menu entry. The following paragraphs describe each of the four
fields that make up a task or menu descriptor.
MENU NAME:
This is the name of the task or menu as it is to appear on
the menu. It may be up to 30 characters long, and any displayable
characters may be used, including graphics characters. For tasks,
this name describes the task that is performed when this menu
entry is selected for execution. It has no meaning to QSYS. For
menus, this name is used by QSYS for the title line of the menu
when displayed.
FILESPEC:
This field describes to QSYS, the drive, directory path, and
filename of the task or menu file that this menu entry describes.
The format for this entry is the same as that of the QSYS command
line. A menu file entry is distinguished from a task entry by the
use of an extension of '.MNU ' on the filename. If this descriptor
describes another menu file, then a filespec indicating the use
of an emulated drive will result in an error. QSYS will not allow
it's menus to be located on emulated drives. Up to 127 characters
may be used to describe the filespec and associated parameters.
Refer to QSYS COMMAND LINE in this section for details about file
specifications.
MENU - 6
MENU SYSTEM
VOLUME ID:
If the drive specified in the filespec entry indicates
removable media, such as a diskette drive, then QSYS will prompt
for the volume label of the media on which this file can be
located. This allows QSYS to prompt for the proper media by name
if the file is not found, thus relieving the users from having to
remember the location of files cataloged in the QSYS menu system.
Entering the global search character '* ', will tell QSYS not to
test for the Volume ID of the media associated with this file,
allowing the same file to be accessed from different media. This
should only be used if necessary, since it disables QSYS' ability
to prompt for the required media by name.
Up to 11 characters may be used in the Volume ID. Any volume
label that is valid in DOS may be used in this field. QSYS will
not allow this field to be left blank if the specified drive uses
removable media.
SECURITY LEVEL:
This is the security level required by the active user to
access this menu entry. This field allows restricted access to
tasks or even entire menus to those users with a security level
equal to or below the security level specified.
Refer to SECURITY SYSTEM in the PREFACE for a description of
the QSYS security system.
- General Information
Once the MENU EDITOR has been entered using F39, QSYS will prompt
for the number of the menu entry to be edited. Pressing F10 in this
field will terminate the editor and return you to task selection mode
and the command line. Selecting a menu entry, while in editor mode,
begins editing of that entry, and the functions available are covered
in detail in the following sub-sections.
Whenever a task or menu descriptor is either added to a menu, or
or an existing descriptor is edited, QSYS will prompt for the fields
that make up the task or menu descriptor. The up-arrow may be used to
back up to a previously entered field, or out of the selected entry.
Simply pressing the <ENTER> key will proceed to the next field without
altering the contents of the current field. As in all QSYS data fields,
what you see on the screen is what you've got in the field, but no data
is actually changed in the menu file until the 'SECURITY LEVEL ' field
has been entered. This allows changes to an entry to be nullified by
backing out of the entry using the up-arrow.
MENU - 7
MENU SYSTEM
- Adding Descriptors
A task or menu descriptor is added to the currently displayed menu
by selecting a blank menu entry and entering the descriptor fields as
QSYS prompts for them. After the last field has been entered, QSYS will
update the menu file to include the added descriptor, and prompt for
the next menu entry to be edited.
Note that adding a descriptor for a new menu does not create the
menu. After the descriptor has been added, proceed to 'Creating a New
Menu ' for the steps necessary to create the menu file.
- Editing Existing Descriptors
A task or menu descriptor can be edited (changed) by selecting
it's menu entry number. QSYS will display the current contents of each
field and allow changes. After the last field has been updated, the
new descriptor will be written to the menu file.
Note that altering a descriptor will not change the location of
a task or menu file. The actual location of the file must be changed
using the DOS 'COPY ' and 'ERASE ' commands from the command line to
copy the file to it's new location, and to delete the old file. If
the descriptor is a menu descriptor, refer to 'Relocating a Menu '.
- Deleting Descriptors
A task or menu descriptor is deleted by selecting it's menu entry
number and blanking the 'MENU NAME ' field by pressing the '+ ' key on
the numeric keypad or by holding down the Ctrl key and pressing the End
key while the cursor is positioned at the beginning of the field. QSYS
will then ask for confirmation before deleting the entry. Entering a
'Y ' will delete the descriptor. Any other key will cause QSYS to re-
display the original contents of the field and abort the delete. Note
that filling the field with spaces does NOT blank the field.
Note also, that deleting a descriptor does not delete the task or
menu file. Refer to 'Deleting a Menu ' if deletion of a menu file is
desired. Tasks must be erased using the DOS 'ERASE ' command from the
command line.
- Changing the Current Menu
Since the editor assumes that selection of a menu entry is for the
purpose of editing the descriptor, a mechanism is provided for changing
the current menu without exiting the editor. This is accomplished by
first selecting the desired menu file's descriptor from the current
menu, inserting the media containing the menu file, if necessary, and
pressing the F9 Menu key. In the event that the requested menu file is
not found, the editor will ask if you want to create this menu. Type
'N ' to abort the create procedure and retry the operation using the
correct media.
MENU - 8
MENU SYSTEM
- Creating a New Menu
Creating a new menu requires that the descriptor has already been
added to the current menu using the procedure outlined under 'Adding
Descriptors '. After this procedure has been performed, select the
descriptor for editing, insert the media to contain the new menu file,
if necessary, and press the F9 Menu key. QSYS will check the directory
of the target drive for any files whose names match the requested menu
name. If a file is found, the create procedure is aborted, and QSYS
will attempt make this file the current menu file. If no matching files
are found, then QSYS will momentarily display a message indicating this
fact and ask you to confirm that the new menu file should be created.
Responding to the prompt with a 'Y ' will create the new menu file, and
the newly created file will become the current menu. Any other response
will cancel the create procedure and editing of the current menu will
resume.
- Deleting a Menu
The current menu may be deleted by pressing the F6 Delete key only
after all descriptors have been deleted using the procedure discussed
under 'Deleting Descriptors '. QSYS will ask for confirmation before
deleting the requested menu. Any response except 'Y ' will abort the
delete procedure. After deletion of a menu, the parent menu will become
the current menu.
The base menu cannot be deleted under any circumstances from
within QSYS. Refer to APPENDIX C for information concerning changing
the base menu.
- Relocating a Menu
QSYS Version 3.0X does not directly support the relocation of task
or menu files. Extreme caution should be exercised in the relocation of
menu files. Parent menus cannot be safely relocated, since pressing F9
at any of the children will result in QSYS attempting to back up to a
non-existent member of that generation of menus. Entire branches in the
menu system's tree-structure could be rendered unreliable.
It is possible to relocate a parent menu file by recreating it,
and all of it's children. It should only be necessary to recreate one
generation of menus in order to preserve the integrity of the menu
system.
MENU - 9
MESSAGES
- Description
The QSYS message system provides personal calendar functions for
each QSYS user, as well as facilities for message exchange between
users. All messages are confidential between the message sender and
the intended recipient of the message. No other user, including the
primary users, are allowed access to messages not intended for them.
Up to five 'targets ' may be specified per message. A 'target ' is a
group of fields specifying the recipient of the message, the date and
time that the message is due, and a frequency, used to automatically
update the target date and time, once the message has been displayed.
The five target specifications may, for example, be used to send the
same message to five different users simultaneously, or to the same
user at five different dates and times, if desired. Each message may
contain up to three lines of text. Information indicating the sender
of the message, and the date and time that the message was sent or
last updated is maintained by the system. QMSG.EXE provides routines
for entering and editing messages, displaying and previewing messages,
reorganizing the message file, and updating the MSGQ. Refer to the
MSGQ section for information pertaining to the contents of the MSGQ.
QSYS also incorporates an interrupt driven message alarm system,
to allow monitoring of the MSGQ concurrently with all other system
tasks. QSYS will sound a subtle, but distinctive tone once per minute
while messages are due. The alarm system is designed not to interrupt
the use of the speaker by other applications. QINT.EXE provides the
necessary routines for initialization of the MSGQ, and for all MSGQ
monitoring and alarm functions.
- QMSG.EXE Loading Options
QMSG incorporates it's own function menu, allowing access to all
message system functions from within the program. It is also possible
to access each function directly by passing the menu option number to
QMSG using a command line parameter. For example, 'DISPLAY MESSAGES '
is option 1 on the Message Menu. The message display function can be
directly accessed, bypassing the Message Menu, by appending a '1 ' to
the command line used to load QMSG.EXE. This is illustrated in the
default base QSYS menu created by the installation procedure. Refer to
QSYS COMMAND LINE and MENU EDITOR in the MENU SYSTEM section for more
information on QSYS command and filespec format.
- Common Editing Features
All cursor control and editing keys, described in QSYS EDITOR in
the GENERAL INFORMATION section, are active while entering or editing
a message. In particular, the <End> key can be used in any data field
to terminate the editing function and update the message file. All data
is checked for validity as it is entered. If invalid data is entered,
an error message will be momentarily displayed on line 25, and QMSG
will force re-entry of the field.
MSG - 1
MESSAGES
- Message Data Fields
Before discussing the functions available in the message system,
it is necessary to understand the fields that make-up a message record.
Following, is an explanation of the contents of each of these fields.
RECIPIENT
The name of the QSYS user for which this message is intended.
DATE
The date on which the recipient, named in the associated
target entry, is to be notified of the message. May be entered
in any valid DOS format, but must be equal to, or greater than,
the current system date.
TIME
The time of day, in 24 hour format, at which the recipient,
named in the associated target entry, is to be notified of the
message. May be entered in any valid DOS format. However, this
field, and the associated date, must not be prior to the current
system date and time.
FREQUENCY
The frequency at which the recipient, named in the associated
target entry, is to be notified of the message. The frequency is
entered as a number, up to three digits, followed by a time period
specifier. The following table shows the valid time periods.
MN - Minutes
HR - Hours
DY - Days
WK - Weeks
MO - Months
YR - Years
For example, '3DY ' would increment the target date which caused
the message to be due, by three days when the associated message
was displayed by the recipient using the DISPLAY function. An
entry of '10WK ' would automatically make the message come due
in another 10 weeks after being displayed. Time periods may not
be combined. A blank frequency field will cause the associated
target entry to be deleted when the message is displayed.
MESSAGE
The actual text of the message. Up to three lines of text
can be entered. The keyboard will automatically be shifted into
lower case for this field.
MSG - 2
MESSAGES
- MESSAGES MENU
The Messages Menu currently contains the following 5 options.
1) DISPLAY MESSAGES
Allows the active user to display only those messages
which are currently due.
2) PREVIEW MESSAGES
Allows the active user to display messages that are
pending for the current system date.
3) ENTER NEW MESSAGES
Allows the active user to enter new messages into the
message file.
4) SEARCH-EDIT MESSAGES
Allows the active user to search, delete or update
messages which he has sent or in which he is named as a
recipient.
9) FILE REORGANIZATION
Reorganizes the message file and updates the MSGQ.
QMSG.EXE may be terminated from the Messages Menu by pressing F10.
Ctrl-Break will terminate QMSG, sign-off the current user, and return
to the Clock/Calendar.
- HELP Facility
The F7 key can be used from any command line or data field in
the message system to display a help screen. This screen provides the
current time, in the 24 hour format required for messages, calendar
browsing functions, identical to those of the Clock/Calendar, to aid
in entering message target dates, and a list of the current QSYS user
names. Refer to the CLOCK/CALENDAR section for detailed information
concerning the use of calendar browsing functions.
F10 terminates the help screen, and returns you to the beginning
of the field in which help was requested.
MSG - 3
MESSAGES
- DISPLAY MESSAGES
Displays only those messages which are currently due for the
active user. Pending messages in the MSGQ are not accessible through
this function. If no messages are due for the current user, an infor-
mational system message is posted to the active screen.
- Available Functions
<ENTER> or Ctrl-<ENTER>
Updates the target entry which caused the message to be due,
according to the instructions contained in the 'FREQUENCY ' field.
If no update frequency is specified, the associated target entry
will be deleted. The next message in the MSGQ, due for the active
user, will then be displayed. If no more messages are available,
an informational message is displayed to notify the user, and the
DISPLAY function is terminated.
F5 - EDIT
Allows editing of only the target entry which caused the
message to be due. After the update frequency field has been
updated, or the <End> key is pressed, the EDIT function will
terminate, the message file will be updated, and processing
continues as described in the <ENTER> function.
F7 - HELP
Pressing F7, either on the command line or in a data field,
will invoke the HELP facility.
F9 - MENU
Terminates the DISPLAY function and returns to the Messages
Menu. This option differs from F10 only when the original access
to QMSG was not through the Messages Menu, in which case, F9 will
force a return to the menu so that another selection can be made.
F10 - END
Terminates the DISPLAY function. If QMSG was originally
accessed through the Messages Menu, then the menu will be re-
displayed, otherwise, QMSG is terminated.
MSG - 4
MESSAGES
- PREVIEW MESSAGES
Displays only those messages which are pending or due in the MSGQ
for the active user. If no messages are in the MSGQ for the current
user, an informational system message is posted to the active screen.
- Available Functions
<ENTER>
Proceeds to the next message pending in the MSGQ for the
active user, if one is available. No action is taken on the
currently displayed message.
Ctrl-<ENTER>
Functions as described under 'DISPLAY '. Temporarily switches
to DISPLAY mode for this message.
F5 - EDIT
Functions as described under ' DISPLAY '.
F7 - HELP
Functions as described under ' DISPLAY '.
F9 - MENU
Functions similarly to F10 except that return to the Messages
Menu is mandatory.
F10 - END
Terminates the PREVIEW function. If QMSG was originally
accessed through the Messages Menu, then the menu will be re-
displayed, otherwise, QMSG is terminated.
MSG - 5
MESSAGES
- ENTER NEW MESSAGES
Allows entering of new messages into the message file. If messages
are entered for the current system date, the MSGQ is also updated.
Refer to 'Common Editing Features ' and 'Message Data Fields ' in this
section for more information.
The command level functions described below are available in every
data field.
- Available Functions
F7 - HELP
Functions as described under ' DISPLAY '.
F9 - MENU
Functions similarly to F10 except that return to the Messages
Menu is mandatory.
F10 - END
Pressing F10 will abort the record currently being entered.
Information already entered in the current record will be lost.
If the original access to QMSG was through the Messages Menu, then
the menu will be re-displayed, otherwise, QMSG will be terminated.
MSG - 6
MESSAGES
- SEARCH/EDIT
Allows direct access to existing records in the message file by
record number, or sequential access to the file through the use of
browsing functions similar to those used in the Clock/Calendar. Users
are only allowed access to those records which they entered into the
message file, and those records in which they are named as a recipient.
Once the desired record is displayed, it may be edited, or the record
may be deleted. The MSGQ is automatically updated to reflect any
pertinent changes.
- Available Functions
F1 - RECORD ADVANCE
Advances to the next sequential record in the file to which
the active user is allowed access, unless already at the last
record.
F2 - RECORD BACKSPACE
Record backspaces to a previous record in the file to which
the active user is allowed access, unless already at the first
record.
F3 - SCAN FORWARD
Continuously record advances until another function key is
pressed, or until the end of file. Records to which the active
user is denied access are not displayed.
F4 - SCAN BACKWARD
Continuously record backspaces until another function key
is pressed, or until the beginning of file. Records to which the
active user is denied access are not displayed.
F5 - EDIT
Allows full screen editing of the message record currently
displayed. The updated record is written to the file after the
text of the message is entered or the <End> key is pressed. The
message time/date stamp and name of the sender are updated.
F6 - DELETE
Allows deletion of the currently displayed record from the
message file. The message text is blanked and the record will be
removed from the file during the next file reorganization.
MSG - 7
MESSAGES
- SEARCH/EDIT (continued)
F7 - HELP
Functions as described under ' DISPLAY '.
F9 - MENU
Functions similarly to F10 except that return to the Messages
Menu is mandatory.
F10 - END
Pressing F10 will abort the record being edited. Changes will
not be written to the file. If the SEARCH/EDIT function was orig-
inally accessed through the Messages Menu, then the menu will be
re-displayed. Otherwise, QMSG will be terminated.
- SET DATE & TIME
This screen only appears during the system startup procedure, and
then, only if the system date and time have not already been set by a
clock feature. All line editing functions are activated including the
up and down arrows. F7 HELP is active to assist in setting of the date.
F10 END is disabled.
- FILE REORGANIZATION
This procedure is executed automatically during system startup or
at the first sign-off following a change in the system date. You may,
on occasion, catch this procedure running at midnight when the system
date rolls over to a new day. Reorganization of the message file is
totally automatic and will require no operator intervention unless a
system error occurs. DO NOT INTERRUPT IT !!!
Reorganization of the message file requires free space, equal to
the size of the message file, to be available on any installed drive.
QMSG will evaluate the available space on each installed drive that is
in a ready state, and select the fastest possible device.
This procedure sorts the target entries within each record by date
and time, deleting those target entries containing a recipient name not
currently in the QSYS user list. Records with no active targets are
deleted from the message file. Pointers to those records with a target
date equal to, or before, the current system date are placed in the
MSGQ. If the target date is prior to the system date, then the time is
entered into the MSGQ as '00:00 '. This has the effect of making the
message due immediately. At termination, if this procedure was invoked
from the Messages Menu, then the menu will be re-displayed. Otherwise,
QMSG will be terminated.
MSG - 8
MSGQ
The MSGQ is a data area in storage initialized by QINT and main-
tained by QMSG. This data area contains information about messages
that will come due during the current system date. A summary of the
contents of the MSGQ can be viewed from either the CLOCK/CALENDAR
or from any menu in the QSYS menu system by pressing F7. You do not
have to be signed-on to view the MSGQ summary. This screen is meant
to be a quick reference window into the MSGQ. Message text cannot be
displayed from this screen.
The MSGQ is listed in chronological order, with those messages
that are currently due, displayed in the highlighted attribute, while
those messages still pending are displayed in the normal foreground
attribute. The summary lists the message recipient, the time, in 24
hour format, that the message is due, and the record number of the
message in the MSGS.DAT file. The message text cannot be displayed
from this screen. An active clock is also displayed on line 23 to aid
in the evaluation of the displayed information. This clock is always
displayed in 24 hour format, regardless of QSYS system clock config-
uration, in order to remain consistent with the message time format.
In the event that no messages are pending for the current date,
pressing F7 will trigger an informational message indicating that the
MSGQ is empty.
- Available Functions
PgUp or PgDn
If more messages are pending than can be displayed on one
screen, the PgUp and PgDn keys will be activated allowing you to
move forward and backward from one page to another as necessary.
F10 will return you to the screen from which you gained access to
the MSGQ screen.
MSGQ - 1
PREFACE
QSYS is a set of programs designed to help you integrate your
existing program library into a menu driven system supporting multiple
users who need not have a working knowledge of DOS.
QSYS was originally designed for my own use. I needed a means of
allowing every member of my family the use of a personal computer,
while providing some protection against accidental file modifications
or erasures. QSYS incorporates a security system that probably won't
be effective against an experienced programmer, but will certainly
provide some protection from the usually more dangerous inexperienced
user. If you have children, you'll soon learn it's value.
The other members of my family want to use the computer, but they
don't especially care to read the documentation. They don't know which
diskettes the programs are on, and even if they did, they don't have
the knowledge of DOS necessary to load them. I'm afraid that if they
had to learn DOS to use the computer, they wouldn't use the computer!
QSYS makes it possible for them to select the program they want to run
from a menu. If the program isn't on a diskette already mounted, QSYS
will prompt for it by name. When they finish, they simply terminate the
program and DOS will reload QSYS. If they forget to sign-off, QSYS will
do it for them.
QSYS also incorporates a concurrent message handling system. This
was written mostly for my benefit. I have a terrible memory, and the
message system allows me to keep appointments and pay my bills on time.
It will notify me even if I have the computer tied up doing something
else, as I often do.
SYSTEM REQUIREMENTS
- IBM PC or PC-XT
QSYS will probably also work on some IBM compatibles, but no
guarantee is made.
- DOS 2.X
QSYS will not work with the previous versions of DOS.
- 192K of Memory
- IBM Compatible Color/Graphics Monitor Adapter
QSYS operates in 80 column mode. You don't need a color
monitor, but will not work with the Monochrome Display Adapter.
- Two Double-sided, Double-density Diskette Drives
or
- A Winchester Disk and One Double-sided Diskette Drive
QSYS supports drives A-Q, but requires at least the minimum
configuration.
PREF - 1
PREFACE
HOW TO GET QSYS
QSYS is made available through Voluntary Support. This means that
I will volunteer to send it to you FREE for evaluation. If you use it,
you should volunteer to send me the suggested $50 contribution.
What this all comes right down to, is that nobody knows the value
of a particular program until they've had time to use it. Most software
is just too complex to evaluate in a store. Voluntary support gives you
the opportunity to evaluate programs on your own system, in conjunction
with software that you already use, and for as long as it takes to make
a good decision. If you use QSYS, then the $50 contribution is cheap!!!
However, if you don't use it, or can't use it, then don't pay for it!
1) Volunteer to send me the $50 contribution and I'll voluntarily
send you (2) diskettes of my very own full of QSYS. Also, I'll
respond to requests for assistance in the installation and use
of QSYS, and offer future releases for a minimal update fee.
2) Volunteer to send me $10 to cover the cost of the necessary
diskettes, mailer, and postage, and I'll volunteer to send you
QSYS to evaluate. If you use it, you can volunteer to send the
additional $40 at your convenience. If you don't like QSYS, at
least you got some diskettes. No support will be made available
without the suggested contribution.
3) Volunteer to send me (2) diskettes with pre-addressed, postage-
paid diskette mailer(s) of your very own, and I'll volunteer to
return them to you full of QSYS to evaluate absolutely FREE! As
with method #2, I won't volunteer my time to support QSYS for
anyone who hasn't volunteered the suggested contribution. Keep
in mind that I'll * GIVE * you a copy to evaluate, but I won't
* PAY * to send it to you. If you select this method to obtain
QSYS, please be sure to include TWO (2) diskettes, complete
with mailer(s) and sufficient return postage.
DENNIS LEE
906 GREENBRIAR LOOP
ROUND ROCK, TX 78664
CompuServe # 70376,452
LIMITED LICENSE
Feel free to distribute unaltered copies of the QSYS installation
and documentation diskettes to friends, enemies, or people you don't
even know, for the purpose of evaluation, as long as you do it FREE!
Anyone incurring an expense in the distribution of QSYS, is granted
permission to recover only the actual expense involved, and then only
when notice is provided that a contribution to the author is requested.
QSYS may not be sold by itself, or in conjunction with another product,
without written permission of the author.
GUARANTEE - NONE
PREF - 2
PREFACE
LIST OF QSYS FILES
The QSYS system consists of the following files:
* QSYS.EXE - main program module
* QCNFG.EXE - configuration utility
* QINT.EXE - concurrent message interrupt handler
* QMSG.EXE - message program module
* QLDR.COM - batch file loader utility
* MEMBRAIN.EXE - configures and creates MEMBRAIN.SYS
MEMBRAIN.SYS - emulated drive device driver
JOBQ.BAT - dynamic JOBQ batch file
QSYS.SYS - configuration information file
SYSTEM.MNU - base menu file
MSGS.DAT - message file
AUTOEXEC.BAT - system startup procedure batch file
CONFIG.SYS - DOS system configuration parameter file
The QSYS INSTALLATION AID consists of the following files:
* QINST.EXE - installation configuration program
* AUTOEXEC.BAT - installation startup procedure batch file
* CONFIG.SYS - default system configuration parameter file
* MEMBRAIN.SYS - default emulated drive device driver
The QSYS Documentation consists of the following files:
* MAKEDOC.TXT - how to print the documentation
* MAKEDOC.BAT - combines or prints the documentation files
* Q_TITLE.DOC - title page
* Q_CONT.DOC - table of contents
* Q_PREF.DOC - preface
* Q_GEN.DOC - general information
* Q_INST.DOC - installation instructions
* Q_START.DOC - startup procedure
* Q_CLOCK.DOC - clock/calendar
* Q_MENU.DOC - menu system
* Q_JOBQ.DOC - JOBQ
* Q_MSGQ.DOC - MSGQ
* Q_MSG.DOC - message system
* Q_CNFG.DOC - QSYS configuration
* Q_ERR.DOC - system messages
* Q_APPA.DOC - APPENDIX A
* Q_APPB.DOC - APPENDIX B
* Q_APPC.DOC - APPENDIX C
* Q_GLOS.DOC - glossary
Files marked with an asterisk (*) are included with the system,
and are necessary for installation. All other files will be created as
required.
PREF - 3
SYSTEM STARTUP
Provided that QSYS is installed on the drive from which DOS boots
at power-up, the following sequence of events will occur.
o DOS loads
+ Initializes file buffers as defined in 'CONFIG.SYS '
+ Loads and initializes 'ANSI.SYS '
+ Loads and initializes 'MEMBRAIN.SYS '
+ Loads and initializes user device drivers if installed
+ Begins execution of 'AUTOEXEC.BAT '
o 'AUTOEXEC.BAT ' executes
+ Sets Video mode
+ Tests for IPL Resources
- Posts error if resources are unavailable
- If resources are missing from removable
media then prompts for proper diskette,
waits for operator intervention, and
restarts 'AUTOEXEC.BAT '
- If resources are missing from fixed media,
or if the file is missing from the IPL drive,
then terminates 'AUTOEXEC.BAT '
+ Sets the system environment
- Defines QSYS file locations and volume labels
- Sets cursor to backspace character
+ Executes QINT.EXE
- Initializes MSGQ and QSYS data areas
- Initializes QSYS interrupts
+ Executes user defined startup programs
+ Copies QSYS files to emulated drives if necessary
- Makes sub-directories as necessary
+ Executes Message Reorganization Procedure
- Allows setting of system date and time if necessary
- Reorganizes Message File
- Puts today's messages in MSGQ
+ Executes JOBQ.BAT
o JOBQ executes
o Loads QSYS.EXE
- Clock/Calendar appears awaiting sign-on
STRT - 1
QQQQQQQQQQQ SSSSSSSSSS YYY YYY SSSSSSSSSS
QQQ QQQ SSS SSS YYY YYY SSS SSS
QQQ QQQ SSS YYY YYY SSS
QQQ QQQ SSS YYY YYY SSS
QQQ QQQ SSSSSSSSSS YYYYYY SSSSSSSSSS
QQQ Q QQQ SSS YYYYY SSS
QQQ QQQQ SSS YYYY SSS
QQQ QQQ SSS YYY SSS
QQQ QQQQ SSS SSS YYY SSS SSS
QQQQQQQQQQQ Q SSSSSSSSSS YYYYYY SSSSSSSSSSS
Version 3.00
(C) Copyright 1984 Dennis Lee
Volume in drive A has no label
Directory of A:\
MAKEDOC BAT 254
MAKEDOC TXT 3274
Q_TITLE DOC 634
Q_CONT DOC 7072
Q_PREF DOC 7313
Q_GEN DOC 9260
Q_INST DOC 24895
Q_START DOC 1651
Q_CLOCK DOC 2217
Q_MENU DOC 22028
Q_JOBQ DOC 7682
Q_MSGQ DOC 1869
Q_MSG DOC 14850
Q_CNFG DOC 13641
Q_ERR DOC 23699
Q_APPA DOC 6727
Q_APPB DOC 7318
Q_APPC DOC 2608
Q_GLOS DOC 1224
READ ME! 4291 2-05-85 10:37p
20 file(s) 162507 bytes
147456 bytes free