ChDir - Revision history

Laura: /* Syntax */

2014-05-08T16:32:48Z

Syntax

← Older revision		Revision as of 16:32, 8 May 2014
Line 7:		Line 7:

	==Syntax==		==Syntax==
	CHDIR [<drive>:\] [<path>\] [-N]		CHDIR [<[[drive]]>:\] [<path>\] [-N]

	[[File:ChDirCommand.png]]		[[File:ChDirCommand.png]]

Laura: /* Syntax */

2014-05-06T15:04:30Z

Syntax

← Older revision		Revision as of 15:04, 6 May 2014
Line 7:		Line 7:

	==Syntax==		==Syntax==
			CHDIR [<drive>:\] [<path>\] [-N]

	[[File:ChDirCommand.png]]		[[File:ChDirCommand.png]]

Laura: /* Comments and Examples */

2013-01-08T01:21:52Z

Comments and Examples

← Older revision		Revision as of 01:21, 8 January 2013
Line 33:		Line 33:
	==Comments and Examples==		==Comments and Examples==

	~~For a~~ display of the current directory, type CHDIR and press <ENTER>.		To display of the current directory, type CHDIR and press <ENTER>.

	The following example sets the current drive to drive A:		The following example sets the current drive to drive A:

Laura: /* Parameters */

2013-01-08T01:20:05Z

Parameters

← Older revision		Revision as of 01:20, 8 January 2013
Line 25:		Line 25:
	CHDIR B:		CHDIR B:

	~~But~~ if you enter the following command, BR will change the current subdirectory on drive B to \BR\DATA; the workstation will continue to access drive C~~, however~~:		However, if you enter the following command, BR will change the current subdirectory on drive B to \BR\DATA; yet the workstation will continue to access drive C:

	CHDIR B:\BR\DATA		CHDIR B:\BR\DATA

Mikhail.zheleznov: edit

2011-12-17T12:22:29Z

edit

← Older revision		Revision as of 12:22, 17 December 2011
Line 17:		Line 17:
	==Parameters==		==Parameters==

	The first parameter '''drive''' is the drive letter, which must be followed by a colon. The results of this parameter depend upon whether or not it is followed by the '''path''' parameter. When specified by itself, '''drive''' causes BR to change the current drive to the one specified.		The first optional parameter '''drive''' is the drive letter, which must be followed by a colon and a backslash. The results of this parameter depend upon whether or not it is followed by the '''path''' parameter. When specified by itself, '''drive''' causes BR to change the current drive to the one specified.

	The '''path''' parameter may be specified after the drive letter to indicate the sequence of directories you wish to use as the current directory path. Each directory name must be preceded with a '''backslash \'''. If no backslash is present at the beginning of the directory name series, BR automatically appends the newly specified path to the end of the current directory path.		The '''path''' optional parameter may be specified after the drive letter to indicate the sequence of directories you wish to use as the current directory path. Each directory name must be preceded with a '''backslash \'''. If no backslash is present at the beginning of the directory name series, BR automatically appends the newly specified path to the end of the current directory path.

	When path is specified, BR changes the current directory on the specified drive, but it does not change the current drive. As an example, assume that the current drive at your workstation is drive C. If you enter the following command, BR will change the current drive to drive B:		When path is specified, BR changes the current directory on the specified drive, but it does not change the current drive. As an example, assume that the current drive at your workstation is drive C. If you enter the following command, BR will change the current drive to drive B:
Line 28:		Line 28:

	CHDIR B:\BR\DATA		CHDIR B:\BR\DATA

	~~The '''subdirectory''' parameter is the name of a subdirectory that is to become the new current directory.~~

	The '''-N''' option may be used to turn off the automatic display of the new directory. This can be useful with PROC NOECHO.		The '''-N''' option may be used to turn off the automatic display of the new directory. This can be useful with PROC NOECHO.

Mikhail.zheleznov: Removed references to System/23, changed the syntax diagram, edited the text

2011-12-15T18:27:48Z

Removed references to System/23, changed the syntax diagram, edited the text

← Older revision		Revision as of 18:27, 15 December 2011
Line 17:		Line 17:
	==Parameters==		==Parameters==

	The first parameter '''drive''' is the drive letter, which must be followed by a colon. The results of this parameter depend upon whether or not it is followed by the '''path''' parameter. When specified by itself, '''drive''' causes BR to change the ~~default~~ drive to the one specified.		The first parameter '''drive''' is the drive letter, which must be followed by a colon. The results of this parameter depend upon whether or not it is followed by the '''path''' parameter. When specified by itself, '''drive''' causes BR to change the current drive to the one specified.

	The '''path''' parameter may be specified after the drive letter to indicate the sequence of directories you wish to use as the ~~default~~ directory path. Each directory name must be preceded with a ~~backslash~~ '''\'''. If no backslash is present at the beginning of the directory name series, BR automatically appends the newly specified path to the end of the current ~~default~~ directory path.		The '''path''' parameter may be specified after the drive letter to indicate the sequence of directories you wish to use as the current directory path. Each directory name must be preceded with a '''backslash \'''. If no backslash is present at the beginning of the directory name series, BR automatically appends the newly specified path to the end of the current directory path.

	When path is specified, BR changes the ~~default~~ directory on the specified drive, but it does not change the current drive. As an example, assume that the current ~~default~~ drive at your workstation is drive C. If you enter the following command, BR will change the ~~default~~ drive to drive B:		When path is specified, BR changes the current directory on the specified drive, but it does not change the current drive. As an example, assume that the current drive at your workstation is drive C. If you enter the following command, BR will change the current drive to drive B:

	CHDIR B:		CHDIR B:

	But if you enter the following command, BR will change the ~~default~~ subdirectory on drive B to \\BR\\DATA; the workstation will continue to access drive C, however:		But if you enter the following command, BR will change the current subdirectory on drive B to \BR\DATA; the workstation will continue to access drive C, however:

	CHDIR B:\\BR\\DATA		CHDIR B:\BR\DATA

	The ~~second route through the CHDIR syntax is the System/23-format equivalent to the top route.~~ '''~~/Subdirectory/~~''' is the name of a subdirectory that is to become the new default; the forward slashes indicate System/23 format. '''Drive-num''' is a System/23 drive number which BR translates into a drive letter according to the information in the BRConfig.sys file's S/23-DRIVES specification. When this parameter is specified without a preceding subdirectory name, BR changes the current drive to the drive specified. When a drive-num is preceded by a subdirectory name, BR changes the default directory on the specified drive to the named subdirectory, but it does not change the current drive.		The '''subdirectory''' parameter is the name of a subdirectory that is to become the new current directory.

	The third and fourth routes through the CHDIR syntax allow you to specify either the '''path''' or the '''/subdirectory''' parameters to change the default directory on the default drive. '''Path''' is the sequence of directories that is to become the default. When it is not preceded by a backslash, BR automatically appends the specification to the end of the current ~~default~~ directory ~~path. '''/Subdirectory''' is the System/23-format equivalent to the path parameter~~.

	The '''-N''' option may be used to turn off the automatic display of the new directory. This can be useful with PROC NOECHO.		The '''-N''' option may be used to turn off the automatic display of the new directory. This can be useful with PROC NOECHO.

	==Comments and Examples==		==Comments and Examples==
	For a display of the current ~~default~~ directory, type CHDIR and press <ENTER>.~~<br>~~
	The following example sets the ~~default~~ drive to drive A:		For a display of the current directory, type CHDIR and press <ENTER>.

			The following example sets the current drive to drive A:

	CHDIR A:		CHDIR A:

	If the current ~~default~~ directory is \sales and you wish to change it to \sales\december, any of the following commands will work:		If the current directory is \sales and you wish to change it to \sales\december, any of the following commands will work:

	CHDIR \sales\december<br>		CHDIR \sales\december<br>
Line 47:		Line 47:
	CHDIR /december		CHDIR /december

	You can change the ~~default~~ directory by typing CHDIR, a space, and the parameters that specify the desired path (separate each parameter with a comma or a space). If the specified path does not begin with a backslash (indicating the root directory), the system automatically places the pre-existing ~~default~~ directory path before the path you specify.~~<br>~~		You can change the current directory by typing CHDIR, a space, and the parameters that specify the desired path (separate each parameter with a comma or a space). If the specified path does not begin with a backslash (indicating the root directory), the system automatically places the pre-existing current directory path before the path you specify.
	BR automatically displays the name of the new ~~default~~ directory after the CHDIR command has been executed. If this is undesirable, the -N option may be used to turn the display off.
			BR automatically displays the name of the new current directory after the CHDIR command has been executed. If this is undesirable, the -N option may be used to turn the display off.

	A valid path for the CD command may be:		A valid path for the CD command may be:
Line 77:		Line 78:
	cd ..\..		cd ..\..
	In the example above, CD command is used with acombination of two dots, a backslash, and two more dots, which changes the current directory to the parent of the parent of the current directory. So if your current directory is C:\BR\data\companies\ABC_company, then after the '''CD ..\..''' command is used, the current directory will become '''C:\BR\data'''		In the example above, CD command is used with acombination of two dots, a backslash, and two more dots, which changes the current directory to the parent of the parent of the current directory. So if your current directory is C:\BR\data\companies\ABC_company, then after the '''CD ..\..''' command is used, the current directory will become '''C:\BR\data'''

	~~==Technical Considerations==~~
	~~When '''CD -N''' is specified, the -N parameter will be overridden by the request for a display of the current directory.~~

	<noinclude>		<noinclude>

Mikhail.zheleznov: *

2011-12-15T17:34:09Z

@@ Line 9: / Line 9: @@
 [[File:ChDirCommand.png]]
 ==Comments and Examples==
@@ Line 23: / Line 48: @@
 You can change the default directory by typing CHDIR, a space, and the parameters that specify the desired path (separate each parameter with a comma or a space). If the specified path does not begin with a backslash (indicating the root directory), the system automatically places the pre-existing default directory path before the path you specify.<br>
-Business Rules automatically displays the name of the new default directory after the CHDIR command has been executed. If this is undesirable, the -N option may be used to turn the display off.
+BR automatically displays the name of the new default directory after the CHDIR command has been executed. If this is undesirable, the -N option may be used to turn the display off.
 A valid path for the CD command may be:
@@ Line 52: / Line 77: @@
   cd ..\..
 In the example above, CD command is used with acombination of two dots, a backslash, and two more dots, which changes the current directory to the parent of the parent of the current directory. So if your current directory is C:\BR\data\companies\ABC_company, then after the '''CD ..\..''' command is used, the current directory will become '''C:\BR\data'''
 ==Technical Considerations==
-When "CD -N" is specified, the -N parameter will be overridden by the request for a display of the current directory.
+When '''CD -N''' is specified, the -N parameter will be overridden by the request for a display of the current directory.
 <noinclude>

Mikhail.zheleznov: *

2011-12-15T16:01:16Z

← Older revision		Revision as of 16:01, 15 December 2011
Line 8:		Line 8:
	==Syntax==		==Syntax==

	~~INSERT SYNTAX DIAGRAM HERE~~		[[File:ChDirCommand.png]]

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

Mikhail.zheleznov: *

2011-12-13T20:36:55Z

← Older revision		Revision as of 20:36, 13 December 2011
Line 79:		Line 79:
	The "-N" option may be used to turn off the automatic display of the new directory. This can be useful with PROC NOECHO.		The "-N" option may be used to turn off the automatic display of the new directory. This can be useful with PROC NOECHO.

	===Technical Considerations===		==Technical Considerations==
	When "CD -N" is specified, the -N parameter will be overridden by the request for a display of the current directory.		When "CD -N" is specified, the -N parameter will be overridden by the request for a display of the current directory.

Mikhail.zheleznov: Added more examples and changed some of the wording to the ChDir command page

2011-12-13T20:35:46Z

Added more examples and changed some of the wording to the ChDir command page

← Older revision		Revision as of 20:35, 13 December 2011
Line 1:		Line 1:
	The '''ChDir''' command displays or changes the current directory. You may also use the '''CD''' command - it is identical to '''ChDir'''.		The '''ChDir''' command displays or changes the current directory. You may also use the '''CD''' command - it is identical to '''ChDir''' in effect, but is shorter.

			If the CD command is not followed by a valid path, it will simply display the current directory.
			In order to switch to a different directory, the CD command must be followed by a valid path.

			After the command is executed, the name of the new current directory is displayed on the screen, unless the -N flag is included in the CD command after the path.

	====Syntax====		==Syntax==

	~~If the CD command is not followed by~~ a ~~valid path, it will simply~~ display the current directory.		INSERT SYNTAX DIAGRAM HERE

			==Comments and Examples==
			For a display of the current default directory, type CHDIR and press <ENTER>.<br>
			The following example sets the default drive to drive A:

			CHDIR A:

			If the current default directory is \sales and you wish to change it to \sales\december, any of the following commands will work:

	~~In order to switch to a different directory, the CD command must be followed by a valid path.~~		CHDIR \sales\december<br>
			CHDIR december<br>
			CHDIR /december

	~~After~~ the ~~command is executed~~, the name of the new ~~current~~ directory is ~~displayed on the screen~~, ~~unless~~ the -N ~~flag is included in~~ the ~~CD command after the path~~.		You can change the default directory by typing CHDIR, a space, and the parameters that specify the desired path (separate each parameter with a comma or a space). If the specified path does not begin with a backslash (indicating the root directory), the system automatically places the pre-existing default directory path before the path you specify.<br>
			Business Rules automatically displays the name of the new default directory after the CHDIR command has been executed. If this is undesirable, the -N option may be used to turn the display off.

	A valid path for the CD command may be:		A valid path for the CD command may be:
Line 17:		Line 32:
	* two dots		* two dots

	~~Examples~~:		If you use the '''CD''' command with an invalid path (a path that does not exist, is misspelled, or otherwise incorrect), then you will get a [[4152]] error

			Here are some more examples:

	~~1. '''~~cd C:\BR\data\companies\ABC_company~~'''~~		cd C:\BR\data\companies\ABC_company

	In the example above, the CD command is used with an absolute path, in which the drive and the entire folder structure is included		In the example above, the CD command is used with an absolute path, in which the drive and the entire folder structure is included

			cd data\companies
	~~2. '''~~cd data\companies~~'''~~

	In the example above, CD command is used with a relative path, which does not include the drive and the entire folder structure. Instead, this command assumes that the current directory has a sub-directory named data, which in turn also has a sub-directory called companies.		In the example above, CD command is used with a relative path, which does not include the drive and the entire folder structure. Instead, this command assumes that the current directory has a sub-directory named data, which in turn also has a sub-directory called companies.

	~~3. '''~~ cd \~~'''~~		cd \
	In the example above, CD command is used		In the example above, CD command is used with a backslash, which changes the current directory to the root of the current directory tree. So if your current directory is C:\BR\data\companies\ABC_company, then after the '''CD \''' command is used, the current directory will become '''C:\'''

	~~====Comments and Examples====~~
	~~For~~ a ~~display~~ of the current ~~default~~ directory~~, type CHDIR and press <ENTER>~~.~~<br>~~
	~~The following example sets the default drive to drive A:~~

	~~;CHDIR A:~~

	~~If the~~ current ~~default~~ directory is \~~sales and you wish to change it to~~ \~~sales~~\~~december~~, ~~any of~~ the ~~following commands~~ will ~~work~~:

	~~CHDIR~~ \~~sales~~\~~december<br>~~		cd ..
	~~CHDIR december<br>~~		In the example above, CD command is used with two dots, which changes the current directory to the parent of the current directory. So if your current directory is C:\BR\data\companies\ABC_company, then after the '''CD ..''' command is used, the current directory will become '''C:\BR\data\companies'''
	~~CHDIR /december~~

	~~You can change~~ the ~~default directory by typing CHDIR~~, a ~~space~~, and ~~the parameters that specify the desired path (separate each parameter with a comma or a space). If the specified path does not begin with a backslash (indicating the root directory)~~, the ~~system automatically places the pre-existing default~~ directory ~~path before~~ the ~~path you specify.<br>~~		cd ..\..
	~~Business Rules automatically displays~~ the ~~name~~ of the ~~new default~~ directory after the ~~CHDIR~~ command ~~has been executed. If this~~ is ~~undesirable~~, the ~~-N option may be used to turn the display off.~~		In the example above, CD command is used with acombination of two dots, a backslash, and two more dots, which changes the current directory to the parent of the parent of the current directory. So if your current directory is C:\BR\data\companies\ABC_company, then after the '''CD ..\..''' command is used, the current directory will become '''C:\BR\data'''

	====Defaults====		==Defaults==
	#Display the current directory drive and path.		#Display the current directory drive and path.
	#Change the current drive.		#Change the current drive.
	#Display the name of the new directory.		#Display the name of the new directory.

	====Parameters====		==Parameters==
	The syntax of the CHDIR command allows you to choose either the default or one of four optional syntactical routes.		The syntax of the CHDIR command allows you to choose either the default or one of four optional syntactical routes.

Line 72:		Line 79:
	The "-N" option may be used to turn off the automatic display of the new directory. This can be useful with PROC NOECHO.		The "-N" option may be used to turn off the automatic display of the new directory. This can be useful with PROC NOECHO.

	====Technical Considerations====		===Technical Considerations===
	When "CD -N" is specified, the -N parameter will be overridden by the request for a display of the current directory.		When "CD -N" is specified, the -N parameter will be overridden by the request for a display of the current directory.