.c;################ROCHESTER INSTITUTE OF TECHNOLOGY
.C;################INFORMATION SYSTEMS AND COMPUTING
.C;################TECHNICAL SUPPORT
.B
.B
.flags bold
.flags Hyphenate
.tab stops 36
.lm 36
.rm 72
.i -36;Descriptive Title:
	Change Directory - A concise method for moving about VMS directories
.b
.i -36;Usage Restrictions:
	None.
.b
.i -36;Calling Name:
	CD
.b
.i-36;Project Number:
.b
.i -36;Author and Affiliation:
	Andrew W. Potter
.br
Rochester Institute of Technology
.b
.i -36;Installed at RIT by:
	Andrew W. Potter

.i-36;Language:
	VAX/VMS Extended FORTRAN-77
.b
.i -36;Computer:
	Digital VAX/VMS
.b
.i -36;Program Availability:
	This Utility is available on VAXA, VAXB, VAXC, VAXD, and VAXV.
.b
.i -36;Contact:
	Internal: User Computing Center, Rochester Institute of Technology
.b
External: Academic Computing
.br; Infor=mation Systems and Computing,
Rochester Institute of Tech=nology. One Lomb Memorial Drive Rochester NY 14623
.b
.i -36;Date
	15 December, 1983
.page
.b
.tab  stops 8,16,24,32,40,48,56,64
.left margin 0
.b
.c;FUNCTIONAL ABSTRACT
.b
CD is a utility that is intended to replace the many
DCL command procedures that have written to simplify the moving about 
the VMS tree structured file system. 
.b
.b
.c;###USER INSTRUCTIONS
.note;These Instructions assume the user is familiar with the VMS 
"SET DEFAULT" command
.end note 
Before CD can be used, it must be defined by entering the following:
.b
.noflags hyphenate
.c;####$#^*CD == "$LIB$DISK:[ACCLIB.CD]CD"\*
.noflags hyphenate
.flags hyphenate
.b
If the user intends to use CD frequently then it would be advisable to
place the above definition in the account LOGIN.COM file. (For more
information on LOGIN.COM files and command definitions please 
refer to the VMS publications
"Guide to Writing Command Procedures" and the "Command Language
Users Guide".)
.b
The CD command takes the following form:
.b
.c;####$#^*CD [directive][directory][[subdirective][subdirectory]...]\*
.b
The directive can be as follows:
.b
.tab stops
.tab stops 20
.left margin 20
.i -20;"*.*." or "*^"	Move one level up in the current directory structure.
	This is equivalent to "SET DEFAULT [-]" This directive
	may be repeated to move more than one level up at a time.
.b
.i -20;"*/" or "*_%"	Move to the top directory on the cur=rent device.
This is the same as SET DEFAULT [000000].
.b
.i-20;"*_~" or "*_\"	Move to the users default login directory
.b
.i-20;"*_&"	Move to the top of the USER public volume. Equiv=alent to
SET DEF USER:[000000]
.b
.i-20;"*_#"	Move to the top of the SYSTEM device volume. Equiv=alent 
to SET DEFAULT SYS$SYSDEVICE:[000000]
.b
.i-20;"*<"	Move to the Top of the RIT Library volume Equiv=alent to
SET DEFAULT LIB$DISK:[000000]
.b
.i-20;"*?"	Type a quick command reference.
.page
.tab stops
.flags bold
.left margin 0
^*Directive\* is optionally followed by  ^*Directory\*. A directory name
would be the name of a top level direc=tory specified without the 
enclosing brackets
and with=out the 'DIR' file type. For example, ^*CD#_/USER\* is the same as
SET DEFAULT [USER] and ^*CD#_<LIBDIR\* is the same as SET DEFAULT 
LIB$DISK:[LIBDIR]. 
.b
^*Directory\* may be followed by zero or more occurrences of ^*subdirective\* 
(either "*." or "*/") and then a
subdirectory name. If the specified subdirectory is down one level from the
users current working directory then the directive and directory specifications
are not necessary. For Example if the users default working directory
is USER:[USERNAME] and he wishes to move into USER:[USERNAME.SUBDIR] then
the command "^*CD#SUBDIR\*" is all that is needed. This is the same as if 
the user entered "^*CD#_&USERNAME.SUBDIR\*".
.b
.c;######EXAMPLES
.left margin 8
.B
.TAB STOPS 32
.nofill
CD#_/USER/SUB/LOWERSUB	_=_=_>##SET DEFAULT [USER.SUB.LOWERSUB]
.B
CD SUB	_=_=_>##SET DEFAULT [.SUB]
.b
CD SUB.LOWERSUB	_=_=_>##SET DEFAULT [.SUB.LOWERSUB]	
.B
CD ~OFFROOT	_=_=_>##SET DEFAULT USER:[USERNAME.OFFROOT]
.B
CD#..#or#CD#_^	_=_=_>##SET DEFAULT [-]
.b
CD#....SUB or CD#_^_^SUB	_=_=_>##SET DEFAULT [--.SUB]
.b