ProfitPress Mega CDROM2 Shareware Freeware (MSDOS)(1992)(Eng)

home *** CD-ROM | disk | FTP | other *** search

/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / MISC / SMSTR32C.ZIP / SM08.DOC < prev next >

Wrap

Text File | 1991-01-21 | 47.7 KB | 1,561 lines

------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.1 SYSTEM MASTER Command Listing 1) Timer Operation 2) Command Processing 3) Command Termination 4) System Specific 8.1.1 Timer Operation Instructions are designed and imple- mented to assist you in the automation and the security of unattended command processing. [B] Define Timer Break-out Sequence [T] Set Timer Registers 8.1.2 Command Processing Instructions are designed and imple- mented to perform various screen formatting, command specification, and system environment functions within the SYSTEM MASTER shell. These commands are the heart of the system. %s% System Variable Parameter %n Input Parameter Flags #n Calculated Input Parameter Flag [!] Display a message [?] Prompt for Input [%] Set Input Parameter Directly [-] ECHO OFF [+] ECHO ON [*] Remark [C] Calculate Input Parameter [D] Timed Delay [E] Echo string to display [I] Include Menu Option [M] Multiple Execution [P] Pause for Keystroke [W] Display Input/Message Window 8.1.3 Command termination instructions are designed and imple- mented to achieve a smooth and powerful interface between SYSTEM MASTER and the DOS environment. [J] Jump to Menu Option [L] Load System Master and Jump [X] Load System Master and Execute [R] Resident Mode 8.1.4 System Specific instructions are commands whose only purpose is to control the operation and 'feel' of the SYSTEM MASTER shell. [V] Set System Variables Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 1 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference 8.2.1 Timer Operation Instructions 8.2.1.1 [B] Define Timer Break-out Sequence The "Timer break-out" sequence allows you to assign a user-defined series of key strokes that can be used to exit an invoked timer operation. If a break-out sequence is to be defined, it MUST be defined in the command set ahead of the timer operation it will control. A default sequence of ESC-E-X-I-T-ESC is prede- fined into SYSTEM MASTER and is functional until you override it with a definition of your own. If you need to define a "secure" breakout se- quence, use this command followed by six (6) valid character codes in the format shown below. If the [B] command is a requirement in your command set, don't forget the key sequence you used, because the default key sequence is dis- abled during the timer operation. (See Appendix 'F' for Valid Keycodes) Format: [B] KeyCodeSequence Exampl: [B] \027\000\060\027\000\067 {ESC-F2-ESC-F9} The KeyCodeSequence must begin in character position 5 of the command string and be formatted as shown. Codes of \000 indicate an extended keycode follows. (\000\060 represents the 'F2' key). Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 2 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.1 Timer Operation Instructions (continued) 8.2.1.2 [T] Set Timer for Unattended Processing The "Set Timer" command allows you to execute option(s) and commands at any time of the day or night unattended. Only 1 timer operation may be defined within a menu option. If a command set containing a timer operation contains any [I] instructions, the 'I'ncluded command sets may NOT contain additional timer operations. NOTE: You can, although, terminate a menu selec- tion with the SYSTEM MASTER '[X]' command to 'Chain' and 'Execute' additional menu options that contain timer operations. Format: [T] time date Exampl: [T] 15:00:00 Sets the timer to begin execution at 3:00 PM of the same day. Exampl: [T] 15:00:00 01/31/91 Sets the timer to begin execution at 3:00 PM on January 31, 1991. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 3 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.1 %string% System Variable Input Parameter The "System Variable Input Parameter" allows you to attach System variables, assigned with the DOS 'SET' command to DOS or NON-DOS System commands. The useage of the input parameter passing feature of SYSTEM MASTER is very similar to the DOS Batch feature. Format: command %string% Exampl: cd\%mydir% This command changes the current direc- tory to one specified as a system var- iable 'mydir'. The 'mydir' variable MUST exist in the DOS Environment and MUST have been defined with the DOS 'SET' command. SET mydir=validnam {defines 'mydir'} CD\%mydir% {changes the current directory to 'validnam'} Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 4 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.2 %n Input Parameter Flags The "Input Parameter Flag" allows you to attach input parameters collected by the '[?]' command to DOS or NON-DOS System commands The useage of the input parameter passing feature of SYSTEM MASTER is very similar to the DOS Batch feature. Format: command %1 %2 ... %9 Exampl: copy %1 %2 This command implementation requires that '%1' & '%2' parameters be assigned by using the [?] input command prior to attempting to pass the parameters to a command. [?] S Input Source File Name: {defines %1} [?] S Input Target File Name: {defines %2} copy %1 %2 Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 5 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.3 #n Calculated Input Parameter Flags The "Calculated Input Parameter Flag" allows you to execute a mathematical calculation and then attach input parameters collected by the '[C]' command to DOS or NON-DOS System commands. The useage of the calculated input parameter passing feature of SYSTEM MASTER is not available thru DOS. Format: command #1 #2 ... #9 Exampl: CMDFILE #1 This command implementation requires that the '#1' parameters be assigned by using the [C] calculate command prior to attempting to pass the parameters to a command. [?] R Input First Real Value: {defines %1} [?] R Input Second Real Value: {defines %2} [C] %1 * %2 {calcs %1 * %2 and assigns the result to #1} Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 6 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.4 [!] Display a message The "Display Message" command allows you to dis- play a descriptive message or a set of responses to input prompts on the SYSTEM MASTER screen. Format: [!] Displays an empty line in the open window. Format: [!] n Displays 'n' empty lines in the open window. ('n' must be in the range of 1..7) Format: [!] Message to be displayed Displays a message on the current line of an open window. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 7 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.5 [?] Prompt for Input The "Prompt for Input" command prompts the user to specify input parameters for commands that are designed to operate with them. When collecting input parameters, SYSTEM MASTER automatically begins with 1 and increments a parameter counter for each input prompt encoun- tered up to a maximum of 9. (see the '[F]' com- mand description for exceptions) Format: [?] 0 Resets the Internal Input Parameter Counter to a value of 0. Format: [?] N Forces the user to input an integer value. No Input Message is displayed. Format: [?] R Forces the user to input a real value. No Input Message is displayed. Format: [?] S Forces the user to input a character string. No Input Message is displayed. Format: [?] N Displayed Prompt Forces the user to input an integer value. An Input Message is displayed with the input prompt. Format: [?] R Displayed Prompt Forces the user to input a real value. An Input Message is displayed with the input prompt. Format: [?] S Displayed Prompt Forces the user to input a character string. An Input Message is displayed with the input prompt. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 8 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.6 [%] Set Input Parameter Flags The "Set Input Parameter Flag" allows you to attach input parameters directly to a %n input parameter flag, then assign them to DOS or NON-DOS System commands. The useage of the input parameter passing feature of SYSTEM MASTER is very similar to the DOS Batch feature. Format: [%] varvalue Exampl: del %1 This command implementation takes the input parameter specified with the [%] command and deletes the disk file that corresponds with the value in %1. [%] diskfile.nam {defines %1} del %1 {deletes disk file 'diskfile.nam'} Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8- 9 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.8 [-] ECHO OFF The "Echo Off" command issues a DOS Batch 'ECHO OFF' command. Format: [-] Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-10 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.9 [+] ECHO ON The "Echo On" command issues a DOS Batch 'ECHO ON' command. Format: [+] Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-11 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.7 [*] Remark The "Comment" command allows you to document complicated or unusual command sequences within a SYSTEM MASTER command set. Note: Since you are allowed a maximum of 255 command characters, using the "Remark" command a lot may cause you to run out of command space. Format: [*] Any comment Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-12 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.10 [C] Calculate Input Parameter The "Calculate Input Parameter" command requires 2 Parameters to operate. The 2 parameters MUST be real numbers, and may be assigned directly or collected with the [?] command. When calculating input parameters, SYSTEM MASTER automatically begins with 1 and increments a parameter counter for each Calculate command encountered up to a maximum of 9. Format: [C] 0 Resets the Internal Input Parameter Counter. Format: [C] %r1 *,/,+,- %r2 Performs a calculation based on 2 input parameters '%r1' and '%r2'. These 2 parameters may be assigned directly, as collected input parameters, or a combination of the two. (Only 1 Calculation may be performed within any [C] command). Command operators are as follows: ___ * multiply | / division |- Result = REAL + addition | - subtraction ___| Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-13 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.11 [D] Timed Delay The "Delay" command forces SYSTEM MASTER to delay for 'n'/10 th's of a second. Format: [D] n Exampl: [D] 30 Would delay parameter collection or SYSTEM MASTER processing for 3 seconds. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-14 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.12 [E] Echo string to display The "Echo Message" command allows you to dis- play a message onto the DOS screen as batch commands are being processed. Format: [E] Message to be displayed Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-15 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.13 [I] Include Menu Option The "Include Option" command is a very special SYSTEM MASTER command feature. This command allows you to 'Include' other menu option com- mand sets into the selected menu option command set. You can create menu sub-options in various lo- cations around the SYSTEM MASTER shell, and then have SYSTEM MASTER collect those sub-options at run time, and execute them as if the commands were located within the selected option. Note: Since you are limited to a maximum of 255 total commands within a single selection, you should take care not to exceed this boundary. You can, although, terminate a menu selec- tion with the SYSTEM MASTER '[X]' command to 'Chain' and 'Execute' additional menu options. (see the '[X]' command in the Terminator Commands Sec.) Format: [I] nnnnnn Exampl: [I] 157404 This command would tell SYSTEM MASTER to load menu level 15, menu 7 and copy the contents of Menu box 4, Option 4 into the selected menu option command structure at the location where the '[I]' command occurred in the selected menu option command set. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-16 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.14 [M] Multiple Execution The "Multiple Execution" command allows you to process the 'n1' following command lines, 'n2' times. The 'n1' & 'n2' parameters must be single digit integers in the range of 1..9. Multiple execution of [I] nnnnnn include commands is supported although this practice can use up command space very quickly. Format: [M] n1 n2 Exampl: [M] 6 3 A command call of '[M] 6 3' would pro- cess the 6 lines following the [M] a total of 3 times in succession. Note: Using this command as stated above ([M] 6 3) would take 18 of the maximum 255 command lines available. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-17 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.15 [P] Pause for Keystroke The "Pause" command forces SYSTEM MASTER to pause until the user presses a key. A "Press Any Key to Continue..." message is automatically displayed. Format: [P] Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-18 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.2 Command Processing Instructions (continued) 8.2.2.16 [W] Display Input/Message Window The "Display Window" command opens a work window to allow for the collection of input parameters or for the displaying of information on the SYSTEM MASTER work screen. Format: [W] Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-19 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.3 Command Termination Instructions 8.2.3.1 [J] Jump to Menu Option The "Jump" command allows you to 'Jump' from the selected menu option to another menu option any- where within the SYSTEM MASTER shell. If the target menu option does not exist, SYSTEM MASTER will create all of the necessary data files. The target menu file is then loaded, and the hilite bar is positioned on the target menu option. This command should be used ONLY for internal menu jumps, and should be used in a command set by itself. Format: [J] nnnnnn Exampl: [J] 157404 This command would tell SYSTEM MASTER to jump to menu level 15, menu 7, menu box 4, Option 4 and place the selection bar at that location. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-20 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.3 Command Termination Instructions (continued) 8.2.3.2 [L] Load System Master and Jump The "Load & Jump" command is used at the end of a command set to reload SYSTEM MASTER after com- mand processing in DOS has terminated. Format: [L] Reloads SYSTEM MASTER and repositions the menu selection bar to Level 1, Menu 1, Box 1, Option 1. Format: [L] C Reloads SYSTEM MASTER and repositions the menu selection bar to the 'Calling' menu option. Format: [L] nnnnnn Exampl: [L] 157404 This command would reload SYSTEM MASTER and reposition the menu selection bar in menu level 15, menu 7 on Menu box 4, Option 4. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-21 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.3 Command Termination Instructions (continued) 8.2.3.3 [X] Load System Master and Execute The "Load & Execute" command is used at the end of a command set to reload SYSTEM MASTER and Execute a specified menu option, after current command processing in DOS terminates. Specifying the '[X]' command reloads SYSTEM MASTER but does NOT display the system master screen. SYSTEM MASTER only loads the command definitions, and then executes the specified menu option. This allows for virtually infinite 'Chaining' of menu options and command sequences. Format: [X] nnnnnn Exampl: [L] 157404 This command would reload SYSTEM MASTER and execute the menu option in menu level 15, menu 7 on Menu box 4, Optn 4. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-22 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.3 Command Termination Instructions (continued) 8.2.3.4 [R] Operate in Resident Mode The "Resident" command causes SYSTEM MASTER to remain resident in system memory during command execution. See section 4.2 for the DOS commands that require the 'D' parameter when executed with SYSTEM MASTER in Resident mode. The 'D' parameter allows DOS commands to be executed thru SYSTEM MASTER and the DOS command processor (COMMAND.COM) as long as sufficient system memory remains available. Format: [R] D command Exampl: The 'N' parameter allows DOS command files & program files to be 'Exec'uted thru SYSTEM MASTER as long as sufficient system memory remains available. Format: [R] N command Exampl: The 'command' is a valid DOS command or file name for the command/program file to be executed. The 'command' MUST include the full path (if not in the DOS search path) and the file extension. The 'parms' are any valid input parameters re- quired by the executed command to fulfill its tasks. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-23 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2 SYSTEM MASTER Command Reference (continued) 8.2.4 Command Processing Instructions (continued) 8.2.4.1 [V] Set System Variables The '[V]' command allows for the customization of SYSTEM MASTER environmental and operational variables. Variables for Screen Color & Color Palette Reg- ister customization, System Variables setting, Screen Blanking feature, and System Access set- tings. Format: [V] T %1 Sets system Toggle (ON/OFF) variables. These variables may be set by manually setting to the proper 2 digit integer string as stated below, or by prompting the user. %1 = 02 = Set System Sound ON/OFF (Toggle) %1 = 05 = Set Error Sound ON/OFF (Toggle) %1 = 08 = Set Security ON/OFF (Toggle) NOTE: %1 setting MUST be a 2 digit integer string. Format: [V] N %n1 %n2 Sets system Numerical (integer) variables. These variables may be set by manually setting to the proper range setting as stated below, or by prompting the user or by both in combination. %n1 = 01 = Sets the Screen Blanking Interval to %n2 Minutes (1..60) %n1 = 02 = Sets the Blank Message move Inter- val to %n2 Seconds (1..30) %n1 = 03 = Sets the maximum menu level which can be accessed by the F10 - PgUp /PgDn keys. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-24 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2.4.1 [V] Set System Variables (continued) %n1 = 04 = Sets the Minimum User Access Level required to satisfy the access requirements of the Option edit feature. %n1 = 05 = Sets the Minimum User Access Level required to satisfy the access requirements of the User Profile Editor feature. %n1 = 06 = Sets the Minimum User Access Level required to satisfy the access requirements of the F10 Menu Select feature. %n1 = 07 = Sets the Minimum User Access Level required to satisfy the access requirements of the Exit to DOS System ESC feature. Format: [V] S %n1 %n2 Sets system Character String variables. These variables may be set by manually providing a string value to a variable, or by prompting the user or by both in combination. %n1 = 01 = Sets the Message displayed by the Screen Blanking feature to a value of %n2. %n1 = 02 = Sets the SYSTEM MASTER internal COMSPEC for use when 'F6'ing to DOS or for invoking a 2nd command processor. Format: [V] P %n1 %n2 Sets Color Palette Register variables. These variables may be set by manually setting to the proper range setting as stated below, or by prompting the user or by both in combination. This feature should only be used with EGA and VGA systems since a system 'lock-up' could occur while attempting to access these registers. Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-25 ------------------------------------------------------------------------- SECTION 8 SYSTEM MASTER Command Reference ------------------------------------------------------------------------- 8.2.4.1 [V] Set System Variables (continued) Using the [V] P command sets SYSTEM MASTER Palette Register %1 to a value of %2. (See Appendix 'E' for Default Palette Settings) Format: [V] C %n1 %n2 %n3 Sets SYSTEM MASTER ColorSet/Attribute variables. These variables may be set by manually setting to the proper range setting as stated below, or by prompting the user or by both in combination. Using the [V] C command sets SYSTEM MASTER ColorSet %1 - Attribute %2 to a value of %3. (See Appendix 'B' for ColorSet definitions) (See Appendix 'C' for Attribute definitions) (See Appendix 'D' for Default Attributes) Release Date: 21 January, 1991 ------------------------------------------------------------------------- System Master 3.2 Page 8-26