RADE

Source Code Manager

adl_refresh

Refreshing workspaces

Quick Reference

Abstract

The adl_refresh command refreshes the current image of the current workspace.

Synopsis
Usage
Rules
Options
Examples
References

Synopsis

adl_refresh [-h|-help|-?]

Usage

This command refreshes the current image of the current workspace.
The database and the image are updated to be consistent, yet without any repairs as performed with the [1] adl_restore_image command.

Beware: It is not possible to make merges between images of a same workspace. Hence, the following rules apply:

Rule 1: the command cannot change the refresh state of the image, meaning that if the current image was refreshed before the command, it must still be ‘refreshed’ after. Similarly, if the current image was not refreshed before the command is run, it must still be ‘not refreshed’ after.
Rule 2: the current image must be refreshed before running those commands
Rule 3: once the command run on an image, the other images should be refreshed before running any new command.
Rule 4: a command like the refresh of the current image is included in the command.

It is not useful to run the [2] adl_ci command or the [3] adl_photo on the image before the refresh. Only the checked-in objects are transmitted to the others images (meaning that the refresh is necessary only if a check-in has been done: if there are only official files or files reserved in a private mode, the refresh is useless). With a checked-in file, you can select the modifications you want to retrieve from another image.

Command	Rule 1	Rule 2	Rule 3	Rule 4
adl_attach	Yes	Yes	Yes	No
adl_detach	Yes	Yes	Yes	No
adl_mk[element, module, data, framework]	Yes	Yes	Yes	No
adl_mv	Yes	Yes	Yes	No
adl_rm	Yes	Yes	Yes	No
adl_co	Yes	Yes	No	No
adl_mk_priv	Yes	Yes	Yes	No
adl_sync	No	No	No	Yes (except if there is nothing to do)
adl_collect	No	No	No	Yes (except if there is nothing to do)
adl_mk_image	No	No	No	Yes
adl_ci	Yes	No except with -wr option	Yes	No
adl_rm_priv	Yes	No	No	No
adl_unco	Yes	No	No	No
adl_restore_imag	Yes	No	No	No
adl_promote	Yes	No	No	No
adl_publish	Yes	No	No	No
adl_photo	No except with a check-in	No except with a check-in and the -wr option	No except with a check-in	No
adl_lock_req	Yes	No	No	No
adl_unlock_req	Yes	No	No	No
adl_ls...	Yes	No	No	No
adl_ds...	Yes	No	No	No
adl_rm_promo	Yes	No	No	No
adl_rm_req	Yes	No	No	No
adl_mv_image	Yes	No	No	No
adl_ren...	Yes	No	No	No
adl_refresh	No	No	No	No

[Top]

Rules

E1 = adl_ci, adl_mv, adl_rm, adl_mk, adl_attach, adl_detach on any SCM element
E2 = adl_mv, adl_rm, adl_mk, adl_attach, adl_detach on any SCM element
E3 = adl_ci, adl_mv, adl_mk, adl_attach, on any SCM element and adl_rm, adl_detach except on a given element or one of its containers

Image 1	Image 2	Result
adl_co fic1	adl_co fic2	OK
adl_co fic1	adl_mk_priv fic2	OK
adl_co fic1	E3	OK
adl_co fic1	adl_co fic1	KO
adl_co fic1	adl_mk_priv fic1	KO
adl_mk_priv fic1	adl_co fic2	OK
adl_mk_priv fic1	adl_mk_priv fic2	OK
adl_mk_priv fic1	adl_mk_priv fic1	OK
adl_mk_priv fic1	E3	OK
adl_mk_priv fic1	adl_co fic1	KO
E1	adl_unco fic1	OK
E1	adl_rm_priv fic1	OK
E1	adl_ci –all	OK
E1	adl_co fic2	KO
E1	adl_mk_priv fic2	KO
E1	E2	KO

[Top]

Options

adl_refresh accepts the following options:

-h|-help|-? Help of the command

[Top]

Examples

Refresh of the workspace "MyWs", not yet in the “MyWs“ workspace:

adl_ch_ws MyWs
adl_refresh
Refreshing the image "image_MyWs" of the workspace "MyWs" of the workspace tree "TOOLSTREE"
MyFw/src/MyFirstFile has been deleted
MyFw/src/MySecondFile has been modified
MyFw/src/MyThirdFile has been modified
MyNewFw has been created
MyNewFw/src/MyNewFirstFile has been created
MyNewFw/src/MyNewSecondFile has been created
Command successful.

[Top]

References

[1]
[2]
[3]

adl_restore_image: Restoring an image
adl_ci: Checking_in an object
adl_photo: Freezing a workspace

[Top]

History

Version: 1 [Mar 2001]

Document created

[Top]