ADE Commands

ADECommandReference

Info: ADE Command Reference

View-related commands

Basic view operations

Command	Description	Synonyms	Keywords
lsviews	list active views
createview	create a view based on a label
useview	use the named view in a new shell with the view's environment
pwv	list currently active view
pwd	list working directory
refreshview	refresh view to update in more recent label
destroyview	destroy view from local storage

Developer tasks

Command	Description	Synonyms	Keywords
expand	make a view's read-only file system tree writable		Read-only file system
unexpand	un-expand any previously expanded but unchanged directories
lsexpand	list all expanded directories
cleanview	remove any view-private files and recreate links to the label server
lsprivate	recursively list view-private files
mkprivate	make file private to the view
resetdeplabel	change a dependent product label in a view

Config spec-related commands

Command	Description	Synonyms	Keywords
setview	select a different view
catcs	print the config spec
edcs	edit the config spec
setcs	set the config spec

Transaction-related commands

Basic transaction management

Command	Description	Synonyms	Keywords
begintrans	begin transaction	xbranchmerge
xbranchmerge	merge a transaction done on one branch to another branch	begintrans
describetrans	describe transaction and its state
savetrans	save transaction to safe storage without merging it
endtrans	closes a transaction without merging
aborttrans	aborts and reverts any changes made during transaction
destroytrans	ends transaction and destroys all associated data
lstrans	list information about transactions
renametrans	rename a transaction

Transaction merge commands

Command	Description	Synonyms	Keywords
beginmerge	begin merge process
graballconflicts	closes conflicts associated with a merge
lsconflict	list all unresolved conflicts
conflict	manage merge conflicts
tkreview	tool to view all changes pending in transaction
merge	merge or re-merge specific files during transaction
mergemail	Create a merge exception list on an un-merged transactions.
mergepeek	Create a report of conflicts between the current transactions and any recently merged transactions.
mkhlink	Create a merge link for documentation purposes.
mergetrans	merge checked-out files during the merge phase of a transaction
endmerge	ends merge and transaction
abortmerge	aborts and reverts any changes made during merge
nomerge	Information only, marks a transaction as not to be merged for the benefit of Release Management

Making changes in a transaction

Command	Description	Synonyms	Keywords
mkdir	create a new directory		create
mkelem	create a new version controlled object file/directory/symlink		create
symlink	create symbolic link to another object
co	check out a version controlled object, make it part of the transaction, and make it writable		check out, Read-only read-write
mv	move or rename an object
remove	remove a file, directory, or symlink	rm, rmname	delete
rm	remove file, directory, or symlink	remove, rmname	delete
rmname	remove file, directory, or symlink	remove, rm	delete
igot	list all current checked-out files in current transaction	lsco
lsco	list all current checked-out files in current transaction	igot
ci	save a changed version of an element and make it read-only.		check in
ciall	checks in all checked-out elements		check in
comment	add comment to a file or directory
reserve	set reserve status
unreserve	remove reserved status
unbranch	undo all changes in transaction on specified branch		delete, remove
unco	remove any changes, make read-only, and remove an element from the transaction		check out
unmkdir	undo previous mkelem or mkdir command in a transaction	unmkelem	delete
unmkelem	undo previous mkelem or mkdir command in a transaction		delete
unremove	bring back an object removed in a transaction	unrm, unrmname
unrm	undo removal of element in a transaction	unremove, unrmname
unrmname	undo removal of element in a transaction	unrm, unremove

Including other transactions

Command	Description	Synonyms	Keywords
fetchtrans	retrieve another transaction, merging it into the current one		get, include
grabtrans	merge another transaction's updates into a view		get, include

Sharing a transactions

Command	Description	Synonyms	Keywords
sharetrans	enable collaboration on transaction
sync	sync view tree with transaction tree for branched files		merge
endsharetrans	end sharing of transaction

Miscellaneous commands

Command	Description	Synonyms	Keywords
disconnect	stores transaction data to local storage to allow working off-line
reconnect	reconnect transaction to the network and copy data as needed
dump	print debug information
makebranch	add a branch to an element	mkbranch
mkbranch	add a branch to an element	makebranch

Integration-related commands

Label-related commands

Command	Description	Synonyms	Keywords
showseries	list label series
showlabels	list labels
label_product	apply a new label to every element in a product and/or create a .emd file
label_push	add a copy of a label to a label server
label_push2	add a copy of a label to a label server ( ADE 4.1 and later )
finalizelabel	merge new DOs built from a new label ( Integrator Only )
slidelabel	move a label from one version of an object to another version of the object ( Integrator Only )
rmlabel	remove a label from an element
difflabels	report the differences between one label and another		compare
applylabel	assign a label to an element
renamelabel	Change the name of a label. ( Integrator Only )
showdeltas	show list of all delta labels off base label
showdepprods	show dependencies
freezelabel	block further changes to a label ( ADE 4.1 and later )
unfreezelabel	allow further changes to a label ( ADE 4.1 and later )

Branch-related commands

Command	Description	Synonyms	Keywords
mksysbranch	add a branch to all the elements in a product
freezebranch	block further changes on a branch
unfreezebranch	allow changes on a branch
renamebranch	Change the name of a branch ( Integrator Only )

Miscellaneous commands

Command	Description	Synonyms	Keywords
project	begin refresh of a project transaction

Versioned-element-related commands

Command	Description	Synonyms	Keywords
desc	describe element and its meta-data	describe group
describe	describe element and its meta-data	describe group
describefile	describe element and its meta-data	describe group
describeversion	describe element and its meta-data	describe group
ls	display object's latest version
cat	echo the specified version of a file from the ADE repository (REPOS) to STDOUT
diff	Compare two versions of a file, with optional GUI.		compare
fetch	retrieve file from repository to local copy
gethistory	List all of the meta-data on all branches for a single element.	lshistory
lshistory	List all meta-data on all branches.	gethistory
lsvtree	list version tree of object	describe group
tkvtree	graphic display of the version tree of a single object
find	find versioned objects based on type (file/directory/symlink,) branch, label, or property

Property-related commands

Command	Description	Synonyms	Keywords
lsproperties	List all of the properties that can be set in ADE.
mkproptype	Create a property type that can be applied to any versioned object.
setbranchpropert	Set a property on a branch.
setlabelproperty	Set a property on a label.
setproject	associates project id with transaction
setproperty	set, reset, or remove a property as a name:value pair on a versioned object(file/dir/symlink/branch/version.)
settranscomment	set or reset a transaction comment
settransproperty	set or reset a transaction property as a name:value pair
setlabelcomment	set, append, or replace the comment on a label.

Other utilities

Command	Description	Synonyms	Keywords
lsprod	List or describe product schemas.
mktype	Create a branch or label type. ( Integrator Only. )
sqlplus	Open a read-only SQL*Plus session connected to the ADE Repository.
annotate	lists file with version annotations for each modified line
copy_dos	Make a local copy of the DOs in a label.
filter	apply a batch process defined by filter to files
copydb	copy and optionally start a seed database.
mktwork	make working directories for RDBMS tests		T_WORK, T_SRC, T_SCRIPT
recover	recovers view after failed command
rollback	rollback or undo failed command
syncbranch	Merge selected files with those in the current view.

Kerberos authentication commands ADE 4 and later

Command	Description	Synonyms	Keywords
okinit	obtain Kerberos credentials ( ADE 4 and later )
oklist	list status of Kerberos credentials ( ADE 4 and later )
okdstry	remove Kerberos credentials ( ADE 4 and later )
identity	display user identity ( ADE 4 and later )
lsgroups	list available groups/roles ( ADE 4 and later )
chgrp	change the ADE access code group of the branch of a versioned object

Utility scripts

Command	Description	Synonyms	Keywords
exec	Execute a command, usually a utility or ad-hoc query script, in an ADE context.
changes_since_label.pl	List transactions merged since a given label.
get_branch_locks.pl	Provide information on locked branches.
get_config_spec	Get the config spec used to create a label.
check_connection_quality.pl	Check the performance of access to ADE resources.
fetch_file.pl	Fetch a specific version of a file.
find_paths	Find previous paths for moved objects.
overwrite_changes_on_a_branch.pl	Copy changes on one branch to another.

Additional ad hoc query scripts

Reference
Ad Hoc Query Scripts

Help

Command	Description	Synonyms	Keywords
cmhelp	ask help of ADE staff, file SR, manage SR
help	display command help
version	displayed the version of ADE