Start-up Command - Revision history

John at 15:44, 26 February 2014

2014-02-26T15:44:20Z

← Older revision		Revision as of 15:44, 26 February 2014
Line 60:		Line 60:

	<noinclude>		<noinclude>
	~~[[Category:Commands]]~~
	[[Category:Basics]]		[[Category:Basics]]
	[[Category:Needs Help]]		[[Category:Needs Help]]
	</noinclude>		</noinclude>

John: /* Defaults */

2014-02-26T15:44:02Z

Defaults

← Older revision		Revision as of 15:44, 26 February 2014
Line 61:		Line 61:
	<noinclude>		<noinclude>
	[[Category:Commands]]		[[Category:Commands]]
	[[Category:~~The~~ Basics]]		[[Category:Basics]]
	[[Category:Needs Help]]		[[Category:Needs Help]]
	</noinclude>		</noinclude>

John at 15:43, 26 February 2014

2014-02-26T15:43:42Z

← Older revision		Revision as of 15:43, 26 February 2014
Line 61:		Line 61:
	<noinclude>		<noinclude>
	[[Category:Commands]]		[[Category:Commands]]
	[[Category:~~Start-up Commands~~]]		[[Category:The Basics]]
	[[Category:Needs Help]]		[[Category:Needs Help]]
	</noinclude>		</noinclude>

Mikhail.zheleznov: Created new syntax diagram and edited text content

2011-12-19T10:19:31Z

Created new syntax diagram and edited text content

← Older revision		Revision as of 10:19, 19 December 2011
Line 1:		Line 1:
	~~You~~ may use ~~BR in combination with~~ a '''start-up''' [[:Category:Commands\|command]]. It can be executed only from the host [[Wikipedia:Operating system\|operating system]].		In order to modify the default behavior of BR after it starts, you may use a '''start-up''' [[:Category:Commands\|command]]. It can be executed only from the host [[Wikipedia:Operating system\|operating system]].

	~~For example, in Windows:~~

	~~#Click Start → Run~~
	~~#Type in '''C:\BR\BR.exe -45 @alternateUser''' and press <ENTER>~~

	~~The effect of the above command will be:~~
	~~#BR will be started~~
	~~#The workstation ID will be 45 (speceified by the -45 parameter)~~
	~~#Instead of the currently logged in Windows user, an alternative name will be used, in this case '''alternateUser'''~~

	~~The above command assumes that the BR executable is located in the directory C:\BR~~

	==Syntax==		==Syntax==

	~~The complete syntax diagram of the BR command is as follows:~~		[[Image:Startup.png]]

	~~{\| border="1"~~
	\| [[Image:~~HELP0066~~.~~jpg\|left~~]]
	\|}

	==Parameters==		==Parameters==

	The ~~top path in part <1> of the syntax diagram above starting with~~ '''br''' ~~represents Unix and Linux versions of BR. It must be used~~ in lowercase letters ~~to start up BR from either of these systems~~.		The '''name of BR executable''', in either uppercase or lowercase letters, must be specified.

	~~The bottom path <2> represents DOS and DOS NetWork versions~~. ~~'''~~BR~~''', in either uppercase~~ or ~~lowercase letters~~, ~~must be specified~~.		A complete "statement" or "command" may follow the name of BR executable. It will be executed as soon as BR is entered. The use of quotation marks around the command or statement is not required, but it is highly recommended.

	~~In part <4>, a complete "statement" or "command" may follow~~ the ~~br keyword~~. It ~~will~~ be ~~executed as soon as~~ BR ~~is entered. The use~~ of ~~quotation marks around~~ the ~~command or statement is not required, but it is highly recommended~~.		The '''-wsid''' parameter represents the workstation ID. It may be a number from 1 to 999. If no -WSID parameter is specified, BR automatically tries to assign a workstation ID of 1 to the session.

	~~The~~ '''-wsid''' parameter ~~represents~~ the ~~workstation~~ ID. It may be ~~a one- or two-digit~~ number from 01 to 999. If ~~no -WSID parameter~~ is specified, ~~BR automatically tries to assign a workstation ID of~~ 1 to the ~~session~~.		A plus symbol '''+''' may optionally follow the '''-wsid''' parameter to indicate that when the specified wsid is already in use, BR should increment accordingly until an available ID is found. If the plus symbol is followed by an increment parameter, it will be used when it is necessary to increment. The increment parameter may be any whole number from 0 to 999. If the plus symbol is used but increment is not specified, 1 is used as the incremental default. If no plus symbol is specified and the requested ID is already in use, an error results.

	A plus symbol (+) may optionally follow the -WSID parameter to indicate that when the specified WSID is already in use, BR should increment accordingly until an available ID is found. If the plus symbol is followed by an increment parameter, it will be used when it is necessary to increment. The increment parameter may be any whole number from 0 to 999. If the plus symbol is used but increment is not specified, 1 is used as the incremental default. If no plus symbol is specified and the requested ID is already in use, an error results.		The '''name of alternative configuration file''' parameter identifies the name of an alternate BR configuration [[BRConfig.sys]] file. This configuration file can contain important information that helps customize a number of configurable BR and application options for the user. The actual specification must consist of a dash (-) followed by a path (optional) and file name. If a '''name of alternative configuration file''' is not specified, BR automatically looks for a file named [[BRConfig.sys]] and uses its contents as the configuration file.

	~~The -~~file~~-ref~~ parameter identifies the name of an alternate BR configuration (BRConfig.sys) file. This configuration file can contain important information that helps customize a number of configurable BR and application options for the user. The actual specification must consist of a dash (-) followed by a path (optional) and file name. If -file~~-ref~~ is not specified, BR automatically looks for a file named [[BRConfig.sys]] and uses its contents as the configuration file.

	@UserName parameter may also be used to override the windows [[environmental variable]] [[UserName]] in the [[Login_Name$]] [[internal function]].		@UserName parameter may also be used to override the windows [[environmental variable]] [[UserName]] in the [[Login_Name$]] [[internal function]].

	==Comments and Examples==		==Comments and Examples==

	As BR32.exe is executed from the [[Wikipedia:Operating system\|operating system]], it is operating system dependent. In the next example, BR is started on a [[Wikipedia:Microsoft Windows\|Windows]] system. Immediately after BR starts up, the [[RUN]] command is executed and the MENU [[program]] begins to run:		As BR32.exe is executed from the [[Wikipedia:Operating system\|operating system]], it is operating system dependent. In the next example, BR is started on a [[Wikipedia:Microsoft Windows\|Windows]] system. Immediately after BR starts up, the [[RUN]] command is executed and the MENU [[program]] begins to run:

	BR32.exe "RUN MENU"		BR32.exe "RUN MENU"

	The BR command in the next example causes, BR to start up at the same time that it assigns a [[workstation ID]] of 42 and specifies altconfg.sys to be used as the [[BRConfig.sys]] file:		Consider this example for Windows:

			#Click Start → Run
			#Type in '''C:\BR\BR.exe -45 @alternateUser''' and press <ENTER>

			The effect of the above command will be:
			#BR will be started
			#The workstation ID will be 45 (speceified by the -45 parameter)
			#Instead of the currently logged in Windows user, an alternative name will be used, in this case '''alternateUser'''

			The above command assumes that the BR executable is located in the directory C:\BR

			The command in the next example causes BR to start up at the same time that it assigns a [[workstation ID]] of 42 and specifies altconfg.sys to be used as the [[BRConfig.sys]] file:

	br32.exe -42 -altconfg.sys		br32.exe -42 -altconfg.sys
Line 53:		Line 48:
	#Do not load BR as a memory-resident task.		#Do not load BR as a memory-resident task.
	#Enter BR without executing a command or statement.		#Enter BR without executing a command or statement.
	#~~workstation~~ ID assignment		#Workstation ID assignment
	##assign a workstation ID of 01 on single-user systems		##assign a workstation ID of 1 on single-user systems
	##assign the workstation's hardware-dependent ID on Unix and Linux systems		##assign the workstation's hardware-dependent ID on Unix and Linux systems
	##assign according to sign-on order on Windows systems.		##assign according to sign-on order on Windows systems.
	#Access BRConfig.sys from the ~~default~~ directory.		#Access BRConfig.sys from the current directory.
	#Use the specified [[WSID]]. If already in use, return an error.		#Use the specified [[WSID]]. If already in use, return an error.
	#Use an increment of 1.		#Use an increment of 1.

Mikhail.zheleznov: Heavily edited the startup command page as it was in terrible shape

2011-12-14T13:10:51Z

Heavily edited the startup command page as it was in terrible shape

Show changes

Mikhail.zheleznov: Uploaded, added, and positioned help image

2011-12-13T22:15:02Z

Uploaded, added, and positioned help image

← Older revision		Revision as of 22:15, 13 December 2011
Line 4:		Line 4:

	The complete syntax of the BR command is as follows:		The complete syntax of the BR command is as follows:
	~~[[Image:HELP0066.jpg]]~~

			[[Image:HELP0066.jpg\|left]]

	~~Note: [[Business Rules!\|BR!]] was [[history\|once]] called WB and the image above has yet to be updated. Consider the WB above as BR32.exe.~~		<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>

	a @UserName may also be used to override the windows [[environmental variable]] [[UserName]] in the [[Login_Name$]] [[internal function]].		a @UserName may also be used to override the windows [[environmental variable]] [[UserName]] in the [[Login_Name$]] [[internal function]].

Mikhail.zheleznov: Created and edited the Start-up command page

2011-12-13T21:02:47Z

Created and edited the Start-up command page

New page

You may use BR in combination with a '''start-up''' [[command]]. It can be executed only from the host [[operating system]].

===Syntax===

The complete syntax of the BR command is as follows:
[[Image:HELP0066.jpg]]

Note: [[Business Rules!|BR!]] was [[history|once]] called WB and the image above has yet to be updated. Consider the WB above as BR32.exe.

a @UserName may also be used to override the windows [[environmental variable]] [[UserName]] in the [[Login_Name$]] [[internal function]].

===Comments and Examples===
As BR32.exe is executed from the [[operating system]], it is operating system dependent. In the next example, Business Rules! is started on a [[Windows]] system. Immediately after Business Rules! starts up, the [[RUN]] command is executed and the MENU [[program]] begins to run:

BR32.exe "RUN MENU"

The BR command in the next example causes, Business Rules! to start up at the same time that it assigns a [[workstation ID]] of 42 and specifies altconfg.sys to be used as the [[BRConfig.sys]] file:

br32.exe -42 -altconfg.sys

The BR command in the next example uses all the available specifications for a Windows version of Business Rules!. It causes a PROC command to be executed as soon as Business Rules! is started; it assigns a WSID of 21 to the workstation; and it identifies ALT6.SYS as the alternate BRConfig.sys file:

BR32.exe "PROC START" -21 -ALT6.SYS

[[Image:HELP0168.jpg]]

===Defaults===
:1.) Do not load Business Rules! as a memory-resident task.
:2.) 25.
:3.) Enter Business Rules! without executing a command or statement.
:4.) Assign a workstation ID of 01 on single-user systems; assign the workstation's hardware- dependent ID on Unix and Linux systems; assign according to sign-on order on Windows systems.
:5.) Access BRConfig.sys from the default directory.
:
At startup the number of authorized users is displayed, in addition to the number of current users.

:4.) Load Business Rules! without executing a command or statement.
:5.) Assign a workstation ID of 01 on single-user systems; Assign according to sign-on order on Networks.
:6.) Use the specified [[WSID]]. If already in use, return an error.
:7.) Use an increment of 1.
:8.) Assume that the configuration file is named [[BRConfig.sys]].

===Parameters===

The top path represents Unix and Linux versions of Business Rules "br", in lowercase letters, must be used to start up Business Rules from either of these systems.

The bottom path represents DOS and DOS NetWork versions. "BR", in either uppercase or lowercase letters, must be specified.

A complete "statement" or "command" may follow the br keyword. It will be executed as soon as Business Rules is entered. The use of quotation marks around the command or statement is not required, but it is highly recommended.

The "-xx" parameter represents the workstation ID. It may be a one or two-digit number from 01 to 99. The "-file-ref" parameter allows you to specify the name of an alternate Business Rules configuration file (BRConfig.sys). The system automatically tries to access a file named BRConfig.sys when no other name is specified. All versions of Business Rules (except the single-user DOS version) must access a BRConfig.sys or alternate file that includes a DRIVES specification. If such a file cannot be accessed, the start-up will fail.

The "statement" and "command" parameters represent a Business Rules statement or command that is to be executed at start-up. The use of quotation marks around the statement or command is not required, but is recommended.

The -WSID parameter identifies the workstation ID that is to be assigned to this session. The actual specification must consist of a dash (-) followed by a workstation ID of up to three digits. If no -WSID parameter is specified, Business Rules automatically tries to assign a workstation ID of 1 to the session.

A plus symbol (+) may optionally follow the -WSID parameter to indicate that when the specified WSID is already in use, Business Rules should increment accordingly to create a new ID. If the plus symbol is followed by the increment parameter, the increment specified will be used when it is necessary to increment. If the plus symbol is used but increment is not specified, 1 is used as the incremental default. If no plus symbol is specified and the requested ID is already in use, an error results.

The increment parameter may be any whole number from 0 to 999. If the requested -WSID is not available to assign, Business Rules adds this specified increment to the ID requested and attempts to assign the resulting sum as the ID. If the result is also already in use, Business Rules continues to increment in the same fashion until an unused ID is found.

The -file-ref parameter identifies the name of an alternate Business Rules configuration (BRConfig.sys) file. This configuration file can contain important information that helps customize a number of configurable Business Rules and application options for the user. The actual specification must consist of a dash (-) followed by a path (optional) and file name. If -file-ref is not specified, Business Rules automatically looks for a file named [[BRConfig.sys]] and uses its contents as the configuration file.

Note that with more recent versions of Business Rules, the BR executable file may have a different name (NOT BR.exe). Additionally, you may rename the exe file to anything you like. This is especially handy if you have multiple BR versions on your computer. You might name them according to version or release number (i.e. BR41.exe, BR390k.exe, etc). If this is the case, simply start Business Rules by using the name of the executable file.

===See Also===
*[[BR32.exe Debug]]

<noinclude>
[[Category:Basics]]
[[Category:Commands]]
[[Category:Start-up Commands]]
[[Category:Needs Help]]
[[Category:Files]]
[[Category:Required Files]]
</noinclude>