===================================================================
<*> Computer Tyme MarxMenu <*>
Reference Manual
Copyright 1989 - 1995 by Marc Perkel
All Rights Reserved * Version 2.50 * Release Date: 05-16-95
Computer Tyme * 411 North Sherman Suite 300 * Springfield, MO 65802
(417) 866-1222 voice * (417) 866-1665 bbs/fax
CompuServe: 71333,427
MHS: Marc @ CTyme
Internet: Marc @ CTyme.MHS.Compuserve.com
===================================================================
Computer Tyme * MarxMenu * Table of Contents Page #1
-----------------------------------------------------------------
Copyright .............................................. 1
License Agreement ...................................... 1
MarxMenu Trademarks .................................... 3
Technical Support ...................................... 3
Installation ........................................... 4
Getting Started Quick .................................. 6
Use MarxHelp ........................................... 8
Common Questions and Mistakes .......................... 8
MarxMenu Features ...................................... 12
Overview of the MarxMenu System ........................ 13
What MarxMenu Does ..................................... 15
The MARX.BAT File ...................................... 16
DROPTO.BAT ............................................. 18
Support for early DOS versions ......................... 19
About Environment Variables ............................ 20
Dealing with Multiple DOS Shells ....................... 22
MarxMenu and TSR Control ............................... 22
Network Users .......................................... 23
Network Menu Strategy .................................. 23
Using TRUENAME on Networks ............................. 24
Novell Users ........................................... 24
Netware 4.x Issues ..................................... 25
The Novell Menu Translator ............................. 25
Logging out under Menu Control ......................... 27
Logging out with VLM Shells ............................ 28
Logging in with MarxMenu ............................... 28
Logging in with VLM Shells ............................. 28
Using Novell's Login ................................... 29
The CONFIG.SYS File .................................... 30
The AUTOEXEC.BAT File .................................. 30
Using a Menu File to Log In ............................ 32
Novell Search Drives ................................... 32
Novell Drive Mapping Tricks ............................ 33
Setting File Attributes ................................ 34
Novell Semaphores ...................................... 34
Using Semaphores for Software Metering ................. 35
NetWare MHS & MarxMenu ................................. 36
Upgrading MarxMenu ..................................... 37
Customizing MarxMenu Sample Files ...................... 38
Menu Analysis .......................................... 39
Onkey Statements ....................................... 39
Popup Menus ............................................ 40
The Console ............................................ 41
Repositioning the Top Window ........................... 42
Mouse Support .......................................... 42
Starting off the Easy Way .............................. 42
About Variables ........................................ 43
Numeric Variables ...................................... 44
Boolean Variables ...................................... 44
String Variables ....................................... 44
Real Numbers ........................................... 45
Local Variables ........................................ 46
Dates .................................................. 46
Passing Parameters to Procedures ....................... 46
About Constants ........................................ 47
Computer Tyme * MarxMenu * Table of Contents Page #2
-----------------------------------------------------------------
About Arrays ........................................... 48
About Qualifiers ....................................... 49
Pointer Variables ...................................... 50
Comments in Menu Files ................................. 51
The MarxMenu Compiler .................................. 51
MarxMenu Language Rules ................................ 52
Compiler Compatibility ................................. 52
A word about DOS versions .............................. 53
A word about BUGS ...................................... 54
Tips From the Master ................................... 54
Computers do Simple Tasks .............................. 54
Complex Tasks are made of Simple Tasks ................. 55
Learning Good Programming Habits ....................... 55
Use Long Names ......................................... 55
Use Comments Liberally ................................. 57
Indent Your code ....................................... 58
For Duplicate Tasks, Use Procedures .................... 59
Don't Program Yourself into a Corner ................... 59
For the POWER User ..................................... 60
Where MarxMenu is Heading .............................. 60
A word to Writers and Reviewers ........................ 61
Security Issues ........................................ 62
Keeping Users in the Menu .............................. 63
Using BREAK.SYS ........................................ 63
Using the SHELL= Command ............................... 64
Conditional Statements ................................. 65
Environment Variables used by MarxMenu ................. 67
MarxMenu DataBase Functions ............................ 68
Additional Information ................................. 69
Computer Tyme on Compuserve ............................ 69
MarxMenu Commands ...................................... 70
#Define ................................................ 71
#If .................................................... 72
#Else .................................................. 72
#Endif ................................................. 72
| ...................................................... 73
( ...................................................... 73
) ...................................................... 73
* ...................................................... 74
+ ...................................................... 74
- ...................................................... 74
/ ...................................................... 74
< ...................................................... 75
<= ..................................................... 75
<> ..................................................... 75
= ...................................................... 75
> ...................................................... 75
>= ..................................................... 76
Abs .................................................... 76
Actual ................................................. 76
AllowAbort ............................................. 76
AllowEsc ............................................... 77
AmPm ................................................... 77
And .................................................... 77
AnsiInstalled .......................................... 77
Computer Tyme * MarxMenu * Table of Contents Page #3
-----------------------------------------------------------------
AnsiWindows ............................................ 78
AppendArray ............................................ 78
AppendInstalled ........................................ 78
ApplicationMemory ...................................... 78
ArcTan ................................................. 79
ArrayInsert ............................................ 79
AssignInstalled ........................................ 79
AssignList ............................................. 79
BadDate ................................................ 80
Bat .................................................... 80
BatFileName ............................................ 80
BigShadow .............................................. 81
BinString .............................................. 81
BiosDate ............................................... 81
Blanked ................................................ 81
BlankMessage ........................................... 81
BlankScreenProgram ..................................... 82
BlankTime .............................................. 83
Blink .................................................. 83
BlockBox ............................................... 83
BootDrive .............................................. 84
BoxBorderColor ......................................... 84
BoxFooter .............................................. 84
BoxFooterLeft .......................................... 84
BoxFooterRight ......................................... 85
BoxHeader .............................................. 85
BoxHeaderColor ......................................... 86
BoxHeaderLeft .......................................... 86
BoxHeaderRight ......................................... 86
BoxInsideColor ......................................... 87
Break .................................................. 87
BrightBackground ....................................... 87
BtrvAbortTransaction ................................... 88
BtrvBeginTransaction ................................... 88
BtrvClearOwner ......................................... 88
BtrvClose .............................................. 88
BtrvCreate ............................................. 89
BtrvDelete ............................................. 91
BtrvEndTransaction ..................................... 91
BtrvGetEqual ........................................... 92
BtrvGetFirst ........................................... 92
BtrvGetGreater ......................................... 93
BtrvGetGreaterOrEqu .................................... 93
BtrvGetLast ............................................ 94
BtrvGetLess ............................................ 94
BtrvGetLessOrEqu ....................................... 95
BtrvGetNext ............................................ 95
BtrvGetPrev ............................................ 95
BtrvIndexes ............................................ 96
BtrvInsert ............................................. 96
BtrvOpen ............................................... 96
BtrvPageSize ........................................... 97
BtrvRecLen ............................................. 97
BtrvRecords ............................................ 97
BtrvReset .............................................. 98
Computer Tyme * MarxMenu * Table of Contents Page #4
-----------------------------------------------------------------
BtrvResult ............................................. 98
BtrvResultMessage ...................................... 99
BtrvSetOwner ........................................... 99
BtrvStepFirst .......................................... 99
BtrvStepLast ........................................... 100
BtrvStepNext ........................................... 100
BtrvStepPrev ........................................... 101
BtrvStop ............................................... 101
BtrvUnUsedPages ........................................ 101
BtrvUpdate ............................................. 102
BtrvVersion ............................................ 102
BuildPath .............................................. 103
CancelListEntry ........................................ 103
CapFirstChar ........................................... 103
CapsColor .............................................. 103
CapsLock ............................................... 104
CarouselLoaded ......................................... 104
Chain .................................................. 104
Char ................................................... 105
CharString ............................................. 105
ChDir .................................................. 105
CleanFileName .......................................... 105
ClearIfNewInput ........................................ 106
ClearKbdBuffer ......................................... 106
ClearKeyEvents ......................................... 106
ClearLine .............................................. 106
ClearScreen ............................................ 107
ClearScreenFirst ....................................... 107
ClearScreenOnExit ...................................... 107
ClockColor ............................................. 107
ClockMode .............................................. 108
ClockPos ............................................... 108
ClosePrinter ........................................... 109
ClusterSize ............................................ 109
CmdLine ................................................ 109
CMOS ................................................... 110
ColdBoot ............................................... 110
ColorScreen ............................................ 110
ComAcceptFileProgram ................................... 110
ComAutoDownload ........................................ 111
ComBasePort ............................................ 112
ComBaud ................................................ 112
ComBlockErrors ......................................... 112
ComBlockNumber ......................................... 112
ComBlockSize ........................................... 113
ComBreakReceived ....................................... 113
ComBytesRemaining ...................................... 113
ComBytesTransferred .................................... 113
ComCD .................................................. 113
ComCDAbort ............................................. 114
ComCharReady ........................................... 114
ComCheckActivity ....................................... 114
ComDataBits ............................................ 115
ComDonePort ............................................ 115
ComDrainSendBuffer ..................................... 115
Computer Tyme * MarxMenu * Table of Contents Page #5
-----------------------------------------------------------------
ComDTR ................................................. 115
ComEchoRecChar ......................................... 115
ComEchoSendChar ........................................ 116
ComEmptyRecBuffer ...................................... 116
ComEmptySendBuffer ..................................... 116
ComErrorLimit .......................................... 116
ComFileName ............................................ 116
ComFileSize ............................................ 117
ComFullFileName ........................................ 117
ComInitPort ............................................ 117
ComHangupOnExit ........................................ 117
ComIRQ ................................................. 117
ComLastChar ............................................ 118
ComLastLine ............................................ 118
ComLocalInput .......................................... 118
CommaString ............................................ 118
Comment ................................................ 119
ComNewLineProgram ...................................... 119
ComParity .............................................. 119
ComPort ................................................ 120
ComProtocol ............................................ 120
ComReadChar ............................................ 120
ComReadln .............................................. 121
ComReadTimeout ......................................... 121
ComRec1kXmodem ......................................... 121
ComRecKermit ........................................... 121
ComRecXmodem ........................................... 122
ComRecYmodem ........................................... 122
ComRecYmodemG .......................................... 122
ComRecZmodem ........................................... 122
ComResult .............................................. 123
ComRI .................................................. 123
ComRTS ................................................. 123
ComSendBreak ........................................... 123
ComSend1kXmodem ........................................ 123
ComSendKermit .......................................... 124
ComSendKbdChar ......................................... 124
ComSendXmodem .......................................... 124
ComSendYmodem .......................................... 124
ComSendYmodemG ......................................... 125
ComSendZmodem .......................................... 125
ComStopBits ............................................ 126
ComStripHighBit ........................................ 126
ComThisLine ............................................ 126
ComTimeout ............................................. 126
ComTotalErrors ......................................... 127
ComUseInt14 ............................................ 127
ComUseUart ............................................. 127
ComWatchCD ............................................. 127
ComWrite ............................................... 128
ComWriteln ............................................. 128
ComWriteRecChar ........................................ 128
ComWriteTimeout ........................................ 128
ComXmitAbortProgram .................................... 128
ComXmitEnding .......................................... 129
Computer Tyme * MarxMenu * Table of Contents Page #6
-----------------------------------------------------------------
ComXmitStarting ........................................ 129
ComXmitStatusProgram ................................... 129
ComZRecover ............................................ 129
Console ................................................ 130
ConsoleBorderColor ..................................... 130
ConsoleHeaderColor ..................................... 130
ConsoleInsideColor ..................................... 130
ConsolePos ............................................. 130
Const .................................................. 131
Contains ............................................... 131
CopyFile ............................................... 131
Cos .................................................... 131
CountryCode ............................................ 132
CpuClass ............................................... 132
CpuName ................................................ 132
CurrencySymbol ......................................... 133
CurrentDirectory ....................................... 133
CurrentDrive ........................................... 133
CurrentEnvironment ..................................... 133
CurrentWindow .......................................... 133
Cursor ................................................. 134
CustomBox .............................................. 134
DateSeparator .......................................... 134
DateString ............................................. 134
Day .................................................... 135
DayOf .................................................. 135
DayOfWeek .............................................. 135
DayOfWeekOf ............................................ 135
DBaseMode .............................................. 136
DbClose ................................................ 136
DbDeleted .............................................. 136
DbCreateFile ........................................... 136
DbDeleteRecord ......................................... 137
DbGetRecord ............................................ 137
DbFields ............................................... 137
DbLockFile ............................................. 138
DbLockRecord ........................................... 138
DbOpen ................................................. 138
DbRecLen ............................................... 139
DbRecords .............................................. 139
DbUnDeleteRecord ....................................... 139
DbUnLockFile ........................................... 139
DbUnLockRecord ......................................... 139
DbWriteRecord .......................................... 140
DecimalSeparator ....................................... 140
DefaultExtension ....................................... 140
Delete ................................................. 141
DelFile ................................................ 141
Devices ................................................ 142
DirectoriesOnly ........................................ 142
DisplayType ............................................ 142
DiskType ............................................... 142
Dispose ................................................ 143
DisposeAll ............................................. 143
DosBusy ................................................ 144
Computer Tyme * MarxMenu * Table of Contents Page #7
-----------------------------------------------------------------
DosKeyInstalled ........................................ 144
DosVersion ............................................. 144
DosVersionString ....................................... 144
DosWindow .............................................. 144
DoubleLineBox .......................................... 145
DPMIInstalled .......................................... 145
DPMIVersion ............................................ 145
DrawBox ................................................ 145
Drives ................................................. 146
DriveType .............................................. 146
DvAppNumber ............................................ 146
DvFrame ................................................ 146
DvFreeze ............................................... 146
DvHide ................................................. 147
DvKillTask ............................................. 147
DvLastHandle ........................................... 147
DvLoaded ............................................... 147
DvMoveWindow ........................................... 147
DvMyHandle ............................................. 148
DvPifExecute ........................................... 148
DvResizeWindow ......................................... 148
DvSetBottom ............................................ 148
DvSetTop ............................................... 149
DvUnFreeze ............................................. 149
DvUnHide ............................................... 149
EatKbdChar ............................................. 149
EchoChar ............................................... 149
Else ................................................... 150
ElseIf ................................................. 150
EmsInstalled ........................................... 151
EmsOverlays ............................................ 151
EmsVersion ............................................. 151
EndComment ............................................. 151
Endif .................................................. 152
EndLoop ................................................ 152
EndOfFile .............................................. 152
EndProc ................................................ 153
EndsWith ............................................... 153
EndWhile ............................................... 153
EnvExpandString ........................................ 153
EnvFree ................................................ 154
EnvSize ................................................ 154
EraseWinAfterOvr ....................................... 154
EraseTopWindow ......................................... 154
EraseWindow ............................................ 154
Execute ................................................ 155
ExistDir ............................................... 156
ExistFile .............................................. 156
ExistOnPath ............................................ 157
ExitCode ............................................... 157
ExitMenu ............................................... 157
Exp .................................................... 157
Explode ................................................ 158
ExplodeDelay ........................................... 158
Extension .............................................. 158
Computer Tyme * MarxMenu * Table of Contents Page #8
-----------------------------------------------------------------
FileAppend ............................................. 158
FileAssign ............................................. 159
FileAttr ............................................... 159
FileClose .............................................. 160
FileCreate ............................................. 160
FileDate ............................................... 160
FileFlush .............................................. 160
FileLog ................................................ 160
FileOpen ............................................... 161
FilePart ............................................... 161
FilePos ................................................ 161
FileReadln ............................................. 161
FileRename ............................................. 162
FileResult ............................................. 162
FileSeek ............................................... 162
FileSize ............................................... 162
FileTime ............................................... 163
FileWrite .............................................. 163
FileWriteln ............................................ 163
FixPath ................................................ 163
Floppies ............................................... 163
ForceExplosion ......................................... 164
ForceExtension ......................................... 164
Forever ................................................ 164
FormatNum .............................................. 164
Fraction ............................................... 165
FreeDiskSpace .......................................... 165
FreeEms ................................................ 165
FreeMem ................................................ 165
FreeMemory ............................................. 166
FreeXms ................................................ 166
FullLineReturn ......................................... 166
GetMem ................................................. 166
GotoXY ................................................. 167
Hash ................................................... 167
HashDispose ............................................ 167
HashDisposeAll ......................................... 168
HashDisposeLevel ....................................... 168
HashLevel .............................................. 168
HashLib ................................................ 168
HexString .............................................. 169
HiddenAndSystem ........................................ 169
HighWord ............................................... 169
Hour ................................................... 169
HourOf ................................................. 169
Hundredth .............................................. 170
IdleProgram ............................................ 170
If ..................................................... 171
InactiveBox ............................................ 171
InactiveBoxColor ....................................... 172
InactiveShadow ......................................... 172
Include ................................................ 172
IncludeDirectories ..................................... 173
InFile ................................................. 173
InitialCursorPos ....................................... 173
Computer Tyme * MarxMenu * Table of Contents Page #9
-----------------------------------------------------------------
InMem .................................................. 174
InputBlankChar ......................................... 174
InputLength ............................................ 174
InputRedirected ........................................ 175
InputString ............................................ 175
Insert ................................................. 175
InsertMode ............................................. 176
Int .................................................... 176
Integer ................................................ 176
InterpretCounter ....................................... 176
Intr ................................................... 177
InverseColor ........................................... 177
InvertString ........................................... 177
IpxLoaded .............................................. 177
Jump ................................................... 177
KbdReady ............................................... 178
KeyEvent ............................................... 178
KeyFromMouse ........................................... 178
KeySave ................................................ 178
KillMusic .............................................. 179
LastDrive .............................................. 179
LastKey ................................................ 179
Left ................................................... 179
Length ................................................. 179
LeftOfEqual ............................................ 180
Ln ..................................................... 180
Loc .................................................... 180
Local .................................................. 182
LockWord ............................................... 182
Logoff ................................................. 183
LogoffTime ............................................. 183
Logout ................................................. 184
LongestLine ............................................ 184
LongestString .......................................... 184
Loop ................................................... 184
LoopIndex .............................................. 186
LoopLevel .............................................. 186
LoopLimit .............................................. 186
LoopVal ................................................ 187
LowerCase .............................................. 187
LowWord ................................................ 187
MachineName ............................................ 188
MakeListEntry .......................................... 188
MarxVersion ............................................ 188
MasterEnvironment ...................................... 188
Max .................................................... 188
MatrixInvert ........................................... 189
McpClass ............................................... 189
McpName ................................................ 189
Mem .................................................... 189
MemL ................................................... 190
MemSize ................................................ 190
MemW ................................................... 190
MemoryLoc .............................................. 190
MenuFileName ........................................... 191
Computer Tyme * MarxMenu * Table of Contents Page #10
-----------------------------------------------------------------
MenuKeyBuffer .......................................... 191
MhsDirectory ........................................... 191
MhsMailDirectory ....................................... 191
MhsReadFile ............................................ 192
MhsSendDirectory ....................................... 192
MhsUserDirectory ....................................... 192
Mid .................................................... 193
Min .................................................... 193
MinorDosVersion ........................................ 193
Minute ................................................. 193
MinuteOf ............................................... 194
MkDir .................................................. 194
Mod .................................................... 194
ModifyPath ............................................. 194
Month .................................................. 195
MonthOf ................................................ 195
Mouse .................................................. 195
MouseHorizontal ........................................ 195
MouseIRQ ............................................... 196
MouseType .............................................. 196
MouseVersion ........................................... 196
MouseVertical .......................................... 196
MoveWindow ............................................. 196
MsDos .................................................. 197
MxCmd .................................................. 197
NamePart ............................................... 197
NetworkVersion ......................................... 198
NewOverlayName ......................................... 198
NextWord ............................................... 198
Nil .................................................... 198
NilProgram ............................................. 199
NoBoxBorder ............................................ 199
NoExit ................................................. 199
Not .................................................... 199
NotesLeft .............................................. 200
NotesPlayed ............................................ 200
NovAccountDisabled ..................................... 200
NovAccountExpDate ...................................... 200
NovAddUserToGroup ...................................... 200
NovAddToSet ............................................ 201
NovAddTrustee .......................................... 201
NovAttach .............................................. 201
NovAttachedServers ..................................... 202
NovAutoDetach .......................................... 202
NovBinderyAccess ....................................... 202
NovBroadcastMode ....................................... 202
NovCaptureBanner ....................................... 203
NovCaptureCopies ....................................... 203
NovCaptureFF ........................................... 203
NovCaptureFile ......................................... 203
NovCaptureFlush ........................................ 204
NovCaptureForm ......................................... 204
NovCaptureIgnoreTabs ................................... 204
NovCaptureNotify ....................................... 205
NovCaptureQueue ........................................ 205
Computer Tyme * MarxMenu * Table of Contents Page #11
-----------------------------------------------------------------
NovCaptureReset ........................................ 205
NovCaptureSetup ........................................ 206
NovCaptureTabSize ...................................... 206
NovCaptureTimeOut ...................................... 206
NovCaptureUseBanner .................................... 206
NovChangePassword ...................................... 207
NovChangeObjPassword ................................... 207
NovCleanVolumeName ..................................... 207
NovClearConnection ..................................... 207
NovCloseBindery ........................................ 208
NovCloseSemaphore ...................................... 208
NovConLoggedIn ......................................... 208
NovConnection .......................................... 208
NovConnectionInfo ...................................... 209
NovConnectionsInUse .................................... 209
NovConOpenFiles ........................................ 209
NovConsoleOperator ..................................... 210
NovConTableSize ........................................ 210
NovConUsingAFile ....................................... 210
NovCreateGroup ......................................... 210
NovCreateObject ........................................ 211
NovCreatePrintQueue .................................... 212
NovCreateProperty ...................................... 212
NovCreateUser .......................................... 213
NovDefaultServer ....................................... 213
NovDeleteFromSet ....................................... 213
NovDeleteObject ........................................ 214
NovDeleteProperty ...................................... 214
NovDeleteTrustee ....................................... 214
NovDetach .............................................. 214
NovDirectoryRights ..................................... 214
NovDiskSpaceDel ........................................ 215
NovDiskSpaceDelNA ...................................... 215
NovDownServer .......................................... 215
NovEndCapture .......................................... 215
NovFirstNetworkDrive ................................... 215
NovForceDownServer ..................................... 216
NovFreeDirSlots ........................................ 216
NovFreeVolumeSpace ..................................... 216
NovFullName ............................................ 216
NovGetConnections ...................................... 217
NovGetMessage .......................................... 217
NovGetRootLevel ........................................ 217
NovGraceLoginReset ..................................... 218
NovGraceLogins ......................................... 218
NovGroupMembers ........................................ 218
NovGroups .............................................. 219
NovInGroup ............................................. 219
NovLastLoginDate ....................................... 219
NovLogin ............................................... 219
NovLoginName ........................................... 220
NovLoginTime ........................................... 220
NovLoginType ........................................... 221
NovLogout .............................................. 221
NovLongMachineName ..................................... 221
Computer Tyme * MarxMenu * Table of Contents Page #12
-----------------------------------------------------------------
NovManager ............................................. 221
NovMapDrive ............................................ 221
NovMapRoot ............................................. 222
NovMaxConnections ...................................... 222
NovMaxConnectionsUsed .................................. 222
NovMaxUserConnections .................................. 222
NovMinPasswordLength ................................... 223
NovMyLoginName ......................................... 223
NovMyPassword .......................................... 223
NovMyPrintQueues ....................................... 223
NovNumberOfPrinters .................................... 224
NovObjectID ............................................ 224
NovObjects ............................................. 224
NovObjectSecurity ...................................... 225
NovOpenBindery ......................................... 225
NovOpenSemaphore ....................................... 225
NovPasswordExpDate ..................................... 226
NovPasswordInterval .................................... 226
NovPasswordRequired .................................... 226
NovPreferredServer ..................................... 226
NovPrimaryServer ....................................... 227
NovPrintQueues ......................................... 227
NovPropertySecurity .................................... 227
NovPropertyValues ...................................... 228
NovReadGroups .......................................... 228
NovReadSecurityEquals .................................. 229
NovRemoveUserFromGroup ................................. 229
NovRenameObject ........................................ 229
NovResult .............................................. 229
NovScanProperties ...................................... 230
NovScanTrusteePaths .................................... 230
NovSecurityEquals ...................................... 230
NovSemaphoreInfo ....................................... 231
NovSemaphoreTimeout .................................... 231
NovSemaphoreUsers ...................................... 231
NovSemaphoreValue ...................................... 232
NovSendMessage ......................................... 232
NovSerialNumber ........................................ 232
NovServDescription ..................................... 232
NovServerLogin ......................................... 233
NovServers ............................................. 233
NovServerTime .......................................... 233
NovSetPreferredServer .................................. 233
NovSetPrimaryServer .................................... 234
NovSetProperty ......................................... 234
NovShellLoaded ......................................... 234
NovShellVersion ........................................ 234
NovShortMachineName .................................... 235
NovShowNotLoggedIn ..................................... 235
NovSignalSemaphore ..................................... 235
NovSpaceLimit .......................................... 235
NovSpaceUsed ........................................... 235
NovStaticObject ........................................ 236
NovStaticProperty ...................................... 236
NovStationAddress ...................................... 236
Computer Tyme * MarxMenu * Table of Contents Page #13
-----------------------------------------------------------------
NovTotalDirSlots ....................................... 237
NovTotalVolumeSpace .................................... 237
NovUsedVolumeSpace ..................................... 237
NovUserDirectories ..................................... 237
NovUserFiles ........................................... 238
NovUserInGroup ......................................... 238
NovUserPassword ........................................ 238
NovUsers ............................................... 238
NovUsersLoggedIn ....................................... 239
NovVersionNumber ....................................... 239
NovVolumeNumber ........................................ 239
NovVolumes ............................................. 239
NovWaitOnSemaphore ..................................... 240
NovWritePropValue ...................................... 240
NumberOfElements ....................................... 240
Now .................................................... 241
NumericOnly ............................................ 241
NumLock ................................................ 241
Offset ................................................. 242
OldKbdBuffer ........................................... 242
OnKey .................................................. 242
OnScreenOnly ........................................... 244
OpenPrinter ............................................ 244
OptionSwitch ........................................... 244
Or ..................................................... 245
Ord .................................................... 245
OutFile ................................................ 245
OutputRedirected ....................................... 246
OverKey ................................................ 246
Overlay ................................................ 246
Overlayed .............................................. 246
PadLeft ................................................ 247
PadLeftChar ............................................ 247
PadRight ............................................... 247
PadRightChar ........................................... 247
ParallelPorts .......................................... 248
ParamsToArray .......................................... 248
ParamStr ............................................... 248
ParentEnvironment ...................................... 248
Password ............................................... 249
PathPart ............................................... 249
PauseAfterExecute ...................................... 249
PcType ................................................. 249
Pi ..................................................... 250
PickFile ............................................... 250
PickMany ............................................... 250
PickManyFlags .......................................... 251
PickManyPositions ...................................... 252
PickOne ................................................ 252
PickPosition ........................................... 252
Port ................................................... 252
PickRedisplay .......................................... 253
Pos .................................................... 253
PosInList .............................................. 253
PosInListLeft .......................................... 254
Computer Tyme * MarxMenu * Table of Contents Page #14
-----------------------------------------------------------------
PosInListPartial ....................................... 254
PosInSortedList ........................................ 255
Power .................................................. 255
Pred ................................................... 255
Print .................................................. 255
PrinterName ............................................ 256
PrintInstalled ......................................... 256
Println ................................................ 256
PrintScreen ............................................ 256
Procedure .............................................. 256
PullMenu ............................................... 258
Qualifier .............................................. 258
QualVal ................................................ 259
RamOverlays ............................................ 259
Random ................................................. 259
ReadAscTextFile ........................................ 259
ReadDirectory .......................................... 260
ReadEnv ................................................ 261
ReadEnvironment ........................................ 261
ReadFileBlock .......................................... 261
ReadKey ................................................ 262
Readln ................................................. 262
ReadlnAsc .............................................. 263
ReadlnTimeout .......................................... 263
ReadSqDirectory ........................................ 263
ReadTextFile ........................................... 264
Real ................................................... 265
Reboot ................................................. 265
ReleaseDate ............................................ 265
Repeat ................................................. 265
ResizeWindow ........................................... 266
ResultsInK ............................................. 266
Return ................................................. 267
ReturnCode ............................................. 267
Right .................................................. 267
RightOfEqual ........................................... 268
RmDir .................................................. 268
RollWindow ............................................. 268
Run .................................................... 269
SavePosition ........................................... 269
ScreenHeight ........................................... 270
ScreenWidth ............................................ 270
ScrollLock ............................................. 270
ScrollMove ............................................. 270
Second ................................................. 271
SecondOf ............................................... 271
Security ............................................... 271
Segment ................................................ 271
SelectPath ............................................. 271
SemAttachTo ............................................ 272
SerialNumber ........................................... 272
SerialPorts ............................................ 272
Set .................................................... 272
SetArraySize ........................................... 273
SetEnv ................................................. 273
Computer Tyme * MarxMenu * Table of Contents Page #15
-----------------------------------------------------------------
SetTimerTask ........................................... 273
SetTopWindow ........................................... 274
SetWindowUnder ......................................... 274
Shadow ................................................. 274
ShadowColor ............................................ 274
ShadowPosition ......................................... 275
Shared ................................................. 275
ShareInstalled ......................................... 275
ShellEnvironment ....................................... 275
Shl .................................................... 276
Shr .................................................... 276
Sin .................................................... 276
SingleLineBox .......................................... 276
SmallShadow ............................................ 276
SortArray .............................................. 277
SortArrayLinked ........................................ 277
Sound .................................................. 278
SplitPath .............................................. 278
SpxFreeConnections ..................................... 278
SpxLoaded .............................................. 278
SpxMaxConnections ...................................... 278
Sqr .................................................... 279
StandardIO ............................................. 279
StartsWith ............................................. 279
Str .................................................... 279
StuffAKey .............................................. 280
StuffKBD ............................................... 280
StuffKeyboardNow ....................................... 280
Stubstitute ............................................ 280
Succ ................................................... 281
Suggest ................................................ 281
Swapping ............................................... 281
TaskNumber ............................................. 281
TextBackground ......................................... 282
TextColor .............................................. 282
TextMode ............................................... 282
TextPos ................................................ 282
TextSeek ............................................... 283
Then ................................................... 283
TimeOf ................................................. 283
Timer .................................................. 283
TimeSeparator .......................................... 284
TimeString ............................................. 284
TMaxActiveTasks ........................................ 284
TMaxCreateTask ......................................... 284
TMaxCut ................................................ 285
TMaxDeleteTask ......................................... 285
TMaxDirectSwitching .................................... 285
TMaxEMSMemLim .......................................... 285
TMaxGetPasteBuffer ..................................... 285
TMaxInstalled .......................................... 286
TMaxMaxTasks ........................................... 286
TMaxNameTask ........................................... 286
TMaxPaste .............................................. 286
TMaxReadTaskInfo ....................................... 286
Computer Tyme * MarxMenu * Table of Contents Page #16
-----------------------------------------------------------------
TMaxResult ............................................. 287
TMaxReturnCount ........................................ 287
TMaxSetPasteBuffer ..................................... 287
TMaxSwitchTasks ........................................ 287
TMaxSwitchToManager .................................... 287
TMaxTakeOver ........................................... 288
TMaxTaskOpenFiles ...................................... 288
TMaxThisTask ........................................... 288
TMaxVersion ............................................ 288
Today .................................................. 288
Tomorrow ............................................... 289
Tone ................................................... 289
TotalDiskSpace ......................................... 289
TotalEms ............................................... 289
Trim ................................................... 290
TrimInputString ........................................ 290
TrimLead ............................................... 290
TrimTrail .............................................. 290
TrueName ............................................... 291
TSRs ................................................... 291
UnBlank ................................................ 291
Unique ................................................. 292
UniqueFileName ......................................... 292
Until .................................................. 292
UpperCase .............................................. 293
UpperCaseCompare ....................................... 293
UpperCaseOnly .......................................... 293
UseArrows .............................................. 294
UseCommand ............................................. 294
UsedDiskSpace .......................................... 294
UseNovPassword ......................................... 295
Value .................................................. 295
Var .................................................... 295
VarType ................................................ 296
VCPIInstalled .......................................... 296
VCPIVersion ............................................ 296
VideoMode .............................................. 296
VideoPage .............................................. 297
ViewArray .............................................. 297
ViewTextFile ........................................... 297
VinCheckService ........................................ 297
VinesInt ............................................... 298
VinesLoaded ............................................ 298
VinUserName ............................................ 298
VinSerialNumber ........................................ 298
VlmLoaded .............................................. 298
Volume ................................................. 299
VT100mode .............................................. 299
Wait ................................................... 299
WaitOrKbdReady ......................................... 299
WhereX ................................................. 300
WhereXAbs .............................................. 300
WhereY ................................................. 300
WhereYAbs .............................................. 300
While .................................................. 300
Computer Tyme * MarxMenu * Table of Contents Page #17
-----------------------------------------------------------------
WholeFileNames ......................................... 300
Window ................................................. 301
WindowHeight ........................................... 301
WindowWidth ............................................ 301
WindowsLoaded .......................................... 301
WinX ................................................... 301
WinY ................................................... 301
Within ................................................. 302
WordStarKeys ........................................... 302
WorkString ............................................. 302
Write .................................................. 302
WriteAscTextFile ....................................... 303
WriteCenter ............................................ 303
WriteError ............................................. 303
WriteFileBlock ......................................... 303
Writeln ................................................ 303
WritelnAsc ............................................. 304
WritelnError ........................................... 304
WriteTextFile .......................................... 305
WriteVertical .......................................... 305
XmsInstalled ........................................... 305
XmsOverlays ............................................ 305
XmsVersion ............................................. 306
Xor .................................................... 306
Year ................................................... 306
YearOf ................................................. 306
String Constants ....................................... 307
Time and Date Constants ................................ 308
Video Constants ........................................ 308
Color Constants ........................................ 308
Boolean Constants ...................................... 308
Computer Tyme * MarxMenu * Users Manual Page #1
-----------------------------------------------------------------
COPYRIGHT
This manual is copyrighted material and all rights are reserved.
MarxMenu is a programming language which describes to the computer what
it is supposed to do. Even though some of the individual words in
MarxMenu are used in other programming languages, I claim a copyright on
the collection of words which make up the MarxMenu language. I therefore
consider it an infringement of my Copyright to create a software product
which uses the MarxMenu language, or translates MarxMenu source code,
without purchasing a license to do so.
The combinations of definitions of commands in this manual constitute a
copyrighted work. Any publication which describes a computer language
for which the MarxMenu command set is a subset is a violation of the
copyright of this software and this written manual.
You agree not to translate, modify, disassemble, decompile, or reverse
engineer any of our programs. This program contains proprietary memory
variable and array addressing algorithms which are considered to be
trade secrets and our property. These algorithms include, but are not
limited to, the MarxMenu variable addressing structures and concepts as
well as those data structures MarxMenu uses in it's database features.
Our claim of intellectual property and trade secrets is not limited to
the actual implementation of code, but extends to the MarxMenu source
language and the user interface language constructs that are unique to
this software product.
In addition to intellectual property rights protected by law, your use
of this product constitutes your acceptance of these terms and
conditions and your acknowledgement of the above rights.
In other words, don't try to clone MarxMenu.
LICENSE AGREEMENT
You are licensed to use this program on a single CPU or workstation. If
you are running on a network, you are required to license a separate
copy for each workstation or a file server license for each file server.
If you are running on a multiuser operating system such as Concurrent
DOS, you are required to license a copy for each workstation. Everyone
who uses this menu, must license a copy unless several people share the
same workstation.
This software is licensed and not sold. The license begins when Computer
Tyme receives payment in full. You may not transfer, sublease or rent
this software without the written consent of Computer Tyme. You are not
allowed to distribute MarxMenu in runtime form with software you've
developed unless it is in combination with a paid-for copy of MarxMenu,
or you have made special arrangements in writing with Computer Tyme to
do so.
Computer Tyme * MarxMenu * Users Manual Page #2
-----------------------------------------------------------------
Network licenses include a license to use this software on a local hard
disk in stand-alone mode provided that the computer is part of a
computer network. Computers that are not connected to the network are
not covered. The network license also includes a license for a single
network supervisor to use the software at home for menu development and
testing.
Site licenses require the payment of an annual renewal and support fee.
If the annual renewal fee is not paid within six months of the due date
then the site license status is considered expired and terminated.
The warranty is limited to the diskettes to be machine readable for a
period of 180 days after purchase. Although we try hard to write perfect
software that has no bugs, we do not guarantee that. This software is
provided AS IS. We also do not guarantee that this product is fit for
any particular purpose and we are not liable for any damages that might
occur from use of this product. We reserve the right to make changes to
any and all parts of this software at any time without obligation to
notify any person or entity of such changes. This agreement is governed
by the laws of the State of Missouri.
Use of this product constitutes your acceptance of the terms and
conditions of this license and of my copyright and your agreement to
abide by these terms and conditions. We may terminate this license at
any time if you are in breach of any of its terms or conditions.
We reserve the right to conduct or have conducted audits to verify your
compliance with this agreement.
I would like to thank the following people for making this product
possible:
Joe Smith, and Kevin Moore for helping write this manual.
The Computer Tyme staff for being the best employees in the world.
Borland International for writing Borland Pascal and keeping it bug free
and well supported.
TurboPower Software for their very powerful extensions to Turbo Pascal
and their well written, well supported product.
All users who actually paid for this product so that we may continue to
eat.
Those of you who have pointed out bugs and made suggestions to improve
our product.
Computer Tyme * MarxMenu * Users Manual Page #3
-----------------------------------------------------------------
MARXMENU TRADEMARKS
MarxMenu is a registered trademark of Computer Tyme. DOS ToolBox,
Directory Master, MarxBase, MarxCom, anything that begins with the word
Marx, and The Network Survival Kit are trademarks of Computer Tyme.
Lotus is a registered trademark of Lotus Development.
Wordstar is a registered trademark of MicroPro International.
Smart Software is a trademark of Informix.
MS-DOS and MS-Windows are trademarks of Microsoft.
Turbo Pascal is a trademark of Borland International.
OPRO and TPRO are trademarks of TurboPower Software.
Netware, Novell and Btrieve are trademarks of Novell.
Concurrent DOS and DR-DOS are trademarks of Novell.
DesqView and QEMM are trademarks of Quarterdeck.
IBM and OS/2 are trademarks of International Business Machines.
Created using Turbo Pascal
Copyright 1983-92 by Borland International
When I first started writing this program my friends referred to it as
Marc's Menu. That's where the name MarxMenu came from. It has nothing to
do with either Carl or Groucho Marx.
TECHNICAL SUPPORT
Technical support for MarxMenu is provided in several ways. The first is
by calling our voice line 1-417-866-1222. We would ask that you not call
the 800 number as that is for orders and ordering information only.
We have several support staff and will try to answer your questions as
quickly and efficiently as possible. We at Computer Tyme look at
technical support as an opportunity to improve our product.
We also have a 24 hour 3 line BBS system. The BBS system is written in
MarxMenu script and the source code to the BBS is available for
download. Users with modems can leave messages about support issues.
There are several user uploaded menus here and it serves as a forum for
MarxMenu users to share ideas and techniques.
Our BBS number is 1-417-866-1665. It supports 14400 baud but is 2400
baud compatible. Use 8 bits, no parity, 1 stop bit (8N1). You will also
need to set your terminal emulation mode to ANSI or VT100. Do not try to
call the BBS with 7 bits or even parity. It won't work.
On our BBS are additional sample menu files that other MarxMenu users
like yourself have uploaded. We encourage you to share your work with
others so that more MarxMenu users can benefit.
Computer Tyme * MarxMenu * Users Manual Page #4
-----------------------------------------------------------------
When uploading problem menus to our BBS, try to isolate the problem and
send as small a sample as you can that demonstrates the problem. Be sure
to add a comment block in your code describing the problem and include
your name and phone number so that we can call you back when we are done
with your menu.
We are also available on Compuserve in the Novell vendors forum. From
any Compuserve prompt type GO COMPTYME. We have section 3.
We also have 3 fax servers on line. Our fax number is 417-866-0135. If
you're having a problem with menu code please don't fax long menus to
us. We prefer that you upload the code to our BBS so that we can run it.
We also offer a Fast Update Service which includes regular upgrades sent
to you automatically as we come out with them. This doesn't mean every
version of MarxMenu, but every few months after making several
improvements and the product is at a stable point. The Fast Update
Service includes special access to our support BBS.
This service is for the very fierce MarxMenu user who has to have the
"Latest and Greatest" all the time.
Computer Tyme provides technical support for users evaluating the
software as well as registered users. You should know your MarxMenu
version number before you call. If you type MARXMENU at the command line
it will give you a version number and a release date.
INSTALLATION
The following installation instructions are for both MarxMenu single
user version and MarxMenu network version. The network version is
included in The Network Survival Kit.
The single user version of MarxMenu is installed by copying the disks
into a subdirectory called MARX to keep the files better organized.
However, this is not necessary. Copy all the disks that come with
MarxMenu into a directory on your hard disk or network.
The Network Survival Kit is installed by copying the disk into a
directory on your server. Typically you would make a directory called
NSK under the PUBLIC directory. That way the NSK directory will inherit
the rights of PUBLIC. It will unpack into about 3.5 megs of programs and
documentation.
Once the files are copied into the proper directory, for example,
PUBLIC\NSK on the network or C:\MARX on a single hard drive, type
INSTALL. Be sure to have your serial number and access code ready. When
this is done, you can run some of the sample menus by typing MARX