edcs

Edits the config spec of a view

APPLICABILITY

ClearCase (cleartool subcommand), Attache (command)

SYNOPSIS

• Edit the config spec of a dynamic view:

  edcs [ -tag view-tag ] [ file ]

• Edit the config spec of a snapshot view:

  edcs [ file ]

DESCRIPTION

This command does not require a product license.

The Edit Session

The edcs command revises a view's config spec by invoking a text editor on an existing config spec (ClearCase) or by downloading a config spec into a temporary file and invoking a text editor on an existing config spec (Attache). The config spec can be one of the following

• The view's current config spec
• Atext file that you want to edit and then make the view's config spec. (If you don't need to edit the file, use setcs.)

In ClearCase, the text editor invoked by edcs is specified by the VISUAL environment variable; if this EV is not set, edcs uses the value of the EDITOR environment variable. If neither EV is set, edcs invokes the Notepad.

After the Edit Session

At the end of the edit session, there is a confirmation step. For dynamic views, this prompt is:

Set config spec for view "view-tag"? [yes]

For snapshot views, this prompt is:

Set config spec and load snapshot view "view-tag"? [yes]

If you answer yes:

• In ClearCase, the modified config spec is set as the view's config spec. (In a snapshot view, there is an additional confirmation step if the edits to the config spec cause elements to be unloaded from the snapshot view.)

  NOTE: In a snapshot view, setting the config spec initiates an update -noverwrite operation. To execute this command on the command line, you must be in or under the root directory of the snapshot view.

• In Attache, the changed file is uploaded and a remote setcs command is issued.

If you answer no, the command is canceled; the view retains its current config spec.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

OPTIONS AND ARGUMENTS

SPECIFYING THE VIEW.  Default: Edits and sets a config spec for the current view.

-tag view-tag

The view-tag of any dynamic view; the view need not be active.

NOTE: To edit the config spec of a snapshot view, you must be in that view. However, in a snapshot view, you can use this option to edit the config spec of a dynamic view.

SPECIFYING THE CONFIG SPEC FILE.  Default: Edits the view's current config spec.

file

The pathname of a file to be used as input to the edit session.

EXAMPLES

Examples including wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Edit the config spec of the current view.

cmd-context edcs

• Edit the config spec of the dynamic view with the view-tag jackson_fix.

cmd-context edcs -tag jackson_fix

• Use a text file named cspec_rel3 as input to an edit session, producing a new config spec for the current view.

cmd-context edcs cspec_rel3

SEE ALSO

attache_command_line_interface, attache_graphical_interface, catcs, config_spec, lsview, mktag, setcs, update