Integrating ClearCase with developer tools using DevInt CLI

The IDE integration CLI is a command-line utility that simplifies and standardizes DevOps Code ClearCase® operations across all four view types: dynamic, snapshot, automatic, and web.

This tool provides a unified solution for CLI-based integration in development workflows, minimizing manual intervention and ensuring a consistent experience with ClearCase®, regardless of view configuration. Across all four view types, the IDE integration CLI offers a uniform interface for interacting with ClearCase® repositories.

The IDE integration CLI accepts command-line arguments and returns results via standard output (stdout) in JSON format. For more information, see the API documentation.

The following commands are available in IDE integration CLI, along with their features:

  • login – Authenticate to the system securely (for automatic and web views only).
  • logout – Logs out the current user from the system securely (for automatic and web views only).
  • checkout – Check out the specified resources from the source control system for editing.
  • checkin – Commit your changes to the source control.
  • uncheckout – Revert checked-out files.
  • addtosource – Add new files to source control.
  • hijack – Temporarily override the version control in snapshot, automatic, and web views.
  • unhijack – Restore hijacked files to the source control.
  • rename – Rename version-controlled elements.
  • remove – Removes the specified resources from the source control system.
  • getproperties – View element properties.
  • getnetworkdrives – List of available network drive characters.
  • move – Move the resources to the destination directory path.
  • refresh – Refresh the version-controlled resources.
  • createactivity – Create a new UCM activity.
  • setactivity – Assign work to a specific activity.
  • unsetactivity – Unset the current UCM activity in the specified view path.
  • getactivities – Retrieve a list of available activities in the view.
  • currentactivity – Retrieves the currently set activity from a given view.
  • removeactivity – Delete an existing UCM activity.
  • createview – Create a ClearCase® view.
  • startview – Start a ClearCase® view.
  • stopview – Stop a ClearCase® view.
  • updateview – Update the view from the repository.
  • aggregatestatus – Return a list of checked-out, hijacked, and view-private resources in a view or any directory resource in the view.
  • getviewstream – Get the stream (UCM views only) of the view.
  • getvobs – Retrieve the list of VOB tags.
  • getpvobs – Retrieve the list of project VOB tags.
  • getprojfolders – Retrieve the list of projects and folders.
  • getprojsubfolders – Retrieve the list of projects and sub-folders.
  • getintstream – Retrieve the integration stream of a project.
  • getstreams – Retrieve the streams or sub-streams of a stream.
  • setconfigspec – Configures a base ClearCase® view and updates the Custom Rules section in a UCM view.

Command:

login

  • Description: Authenticate to the system securely by providing your user name and password (for automatic and web views only).

  • Synopsis:
    ideintegration login -userName user-name {-password user-password|-stdin-password} -ccrcWanServerURL server-url
[-primaryGroupName user-primary-group] [-groupList user-group-list]
    Note: Save the token from the login response for all subsequent operations.
  • Options:
    • -userName user-name: User name to log in to the system.
    • -password user-password: Password to log in to the system.
    • -stdin-password: Prompt for the password in the standard input.
    • -ccrcWanServerURL server-url: URL for the CCRC WAN server to connect to it.
    • -primaryGroupName user-primary-group (optional): Primary group name for the session.
    • -groupList user-group-list (optional): List of user group names for the session, separated by space.
  • Example: 
    ideintegration login -userName alias -password password@1234 -ccrcWanServerURL http://www.example.com/ccrc

Command:

logout

  • Description: Logs out the current user from the CCRC WAN server. (for automatic and web views only).

  • Synopsis:
    ideintegration logout {-stdin-token | -token token-string}
  • Options:
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
  • Example: 
    ideintegration logout -token token123

Command:

checkout:

  • Description: Check out the specified resources from the source control system for editing.

    • Note: If you do not specify either reserved or unreserved, ClearCase® automatically uses a reserved checkout by default.

  • Synopsis:

    ideintegration checkout [-reserved|-unreserved] [-token token-string|-stdin-token] [-comment comment] -resourcePaths resource-list
  • Options:
    • -reserved (optional): Reserves the check-out for exclusive editing.
    • -unreserved (optional): Reserves the check-out for editing, but it is not exclusive.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -comment comment (optional): Provide a comment for the check-out operation.
    • -resourcePaths resource-list: List of resources to check out, separated by space.
      Note: The resourcePaths option can be pathnames that are absolute or relative to the current working directory.
  • Example: 
    ideintegration checkout -token token123 -resourcePaths file1.c file2.c

Command:

checkin

  • Description: Check in the specified resources to the source control system.

  • Synopsis:

    ideintegration checkin [-checkinIdentical] [-token token-string|-stdin-token] [-comment comment] -resourcePaths resource-list
  • Options:
    • -checkinIdentical (optional): Check in even if the file is identical to the previous version.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -comment comment (optional): Provide a comment for the check-in operation.
    • -resourcePaths resource-list: List of resources to check-in, separated by space.
      Note: The resourcePaths option can be pathnames that are absolute or relative to the current working directory.
  • Example: 
    ideintegration checkin -token token123 -resourcePaths file1.c file2.c

Command:

uncheckout

  • Description: Cancels the check-out of the specified resources, with an option to keep any local changes.

  • Synopsis:

    ideintegration uncheckout [-token token-string|-stdin-token] [-keep] -resourcePaths resource-list
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -keep (optional): After uncheck-out of a resource, a local copy of the changes is created with the .keep extension.
      Note: If you do not specify the keep option, a backup keep file will not be generated. If a .keep file already exists and if the file is checked out again, the backup file is named .keep.number, where the number is the next available positive integer.
    • -resourcePaths resource-list: List of resource paths to uncheck-out, separated by space.
      Note: The resourcePaths option can be pathnames that are absolute or relative to the current working directory.

  • Example:

    ideintegration uncheckout -token token123 -resourcePaths file1.c file2.c

Command:

addtosource

  • Description: Adds the specified resources to the source control system.

  • Synopsis:

    ideintegration addtosource [-token token-string|-stdin-token] [-comment comment] -resourcePaths resource-list
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -comment comment (optional): Provide a comment for the add operation.
    • -resourcePaths resource-list: List of resources to add, separated by space.
    Note: The resourcePaths option can be pathnames that are absolute or relative to the current working directory.

  • Example:

    ideintegration addtosource -token token123 -comment "Initial add" -resourcePaths file1.c

Command:

hijack

  • Description: Hijacks the specified resources, allowing manual editing outside of source control.

  • Synopsis:
    ideintegration hijack [-token token-string|-stdin-token] -resourcePaths resource-list
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -resourcePaths resource-list: List of resource paths to hijack, separated by space.
      Note: The resourcePaths option can be pathnames that are absolute or relative to the current working directory.

  • Example:

    ideintegration hijack -token token123 -resourcePaths file1.c

Command:

unhijack

  • Description: Restores the specified hijacked resources to their original state in the source control.

  • Synopsis:
    ideintegration unhijack [-token token-string|-stdin-token] [-keep] -resourcePaths resource-list
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -keep (optional): After unhijacking of a resource, a local copy of the changes is created with the .keep extension.
      Note: If you do not specify the keep option, a backup keep file will not be generated. If a .keep file already exists and if the file is checked out again, the backup file is named .keep.number, where the number is the next available positive integer.
    • -resourcePaths resource-list: List of resource paths to unhijack, separated by space.
      Note: The resourcePaths option can be pathnames that are absolute or relative to the current working directory.

  • Example: 

    ideintegration unhijack -token token123 -resourcePaths file1.c

Command:

rename

  • Description: Renames the specified resource to a new name in the source control.

  • Synopsis:
    ideintegration rename [-token token-string|-stdin-token] -resourcePath resource-path -newName new-name
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -resourcePath resource-path: Path of the resource to rename.
      Note: The resourcePath option can be pathnames that are absolute or relative to the current working directory.
    • -newName new-name: New name for the resource.
  • Example: 
    ideintegration rename -token token123 -resourcePath file1.c -newName file2.c
    Note: The rename command allows you to move the resource to another directory, provided the destination directory is checked out.

Command:

remove

  • Description: Removes the specified resources from the source control system. This is equivalent to rmname. It removes the name from visibility in the source control for the current configuration while leaving it visible in previous configurations.

  • Synopsis: 
    ideintegration remove [-token token-string|-stdin-token] [-forceRemove] [-comment comment] -resourcePaths resource-list
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -forceRemove (optional): Use this option for force removal of resources.
    • -comment comment (optional): Provide a comment for the remove operation.
    • -resourcePaths resource-list: List of resources to remove, separated by space.
      Note: The resourcePaths option can be pathnames that are absolute or relative to the current working directory.

  • Example:

    ideintegration remove -token token123 -forceRemove -resourcePaths file1.c

Command:

getproperties

  • Description: Displays properties of the specified resources in the source control.

  • Synopsis: 
    ideintegration getproperties [-token token-string|-stdin-token] -resourcePaths resource-list
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -resourcePaths resource-list: List of resource paths to display properties, separated by space.
      Note: The resourcePaths option can be pathnames that are absolute or relative to the current working directory.

  • Example:

    ideintegration getproperties -token token123 -resourcePaths file1.c file2.c

Command:

getnetworkdrives

  • Description: Retrieve a list of available network drive characters (for Windows only).

  • Synopsis: 
    ideintegration getnetworkdrives [-stdin-token | -token token-string]
  • Options:
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.

  • Example:

    ideintegration getnetworkdrives -token token123

Command:

move

  • Description: Move the resources to the destination directory path.

  • Synopsis: 
    move [-stdin-token | -token token-string] [-comment comment] 
-destination destination-path -resourcePaths resource-list
  • Options:
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -comment comment (optional): Provide a comment for the move operation.
    • -destination destination-path: The directory path within a view where resources need to be moved.
    • -resourcePaths resource-list: List of resource paths to be moved, separated by space.

  • Example:

    ideintegration move -token token123 -destination /view/viewname/newDir -resourcePaths file1.c

Command:

refresh

  • Description: Refresh the version-controlled resources.

  • Synopsis: 
    ideintegration refresh [-stdin-token | -token token-string] -resourcePaths resource-list
  • Options:
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • resourcePaths resource-list: List of resources to be refreshed, separated by space.

  • Example:

    ideintegration refresh -token token123 -resourcePaths file1.c file2.c

Command:

createactivity

  • Description: Creates a new UCM activity in the specified view path.

  • Synopsis:
    ideintegration createactivity [-token token-string|-stdin-token] -activityID activity-ID 
[-activityHeader activity-headline] [-setActivity] -viewPath view-path
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -activityID activity-ID: Identifier for the new activity.
    • -activityHeader activity-headline (optional): Header name of the activity.
    • -setActivity (optional): Set the new activity as current.
    • -viewPath view-path: Path of the view for the activity.
      Note: The createactivity view-path option can be any valid pathname within the view (including '.' if the current working directory is in the view).

  • Example:

    ideintegration createactivity -token token123 -activityID 42 -viewPath /project

Command:

setactivity

  • Description: Sets the specified activity as the current UCM activity in the given view path.

  • Synopsis:
    ideintegration setactivity [-token token-string|-stdin-token] -activityID activity-ID -viewPath view-path
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -activityID activity-ID: Identifier of the activity to set.
    • -viewPath view-path: Path of the view for the activity to set.
      Note: The setactivity view-path option can be any valid pathname within the view (including '.' if the current working directory is in the view).

  • Example:

    ideintegration setactivity -token token123 -activityID 42 -viewPath /view/viewname

Command:

unsetactivity

  • Description: Unset the current UCM activity in the specified view path.

  • Synopsis:
    ideintegration unsetactivity [-stdin-token | -token token-string] -viewPath view-path
  • Options:
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -viewPath view-path: Path of the view for the activity to unset.
      Note: The unsetactivity view-path option can be any valid pathname within the view (including '.' if the current working directory is in the view).

  • Example:

    ideintegration unsetactivity -token token123 -viewPath /view/viewname

Command:

getactivities

  • Description: Lists the UCM activities related to the specified stream.

  • Synopsis: 
    ideintegration getactivities [-token token-string|-stdin-token] -stream stream
  • Options:
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -stream stream: Name of the stream.

  • Example:

    ideintegration getactivities -token token123 -stream main

Command:

currentactivity

  • Description: Retrieves the currently set activity from a given view.

  • Synopsis: 
    ideintegration currentactivity [-stdin-token | -token token-string] -viewPath view-path
  • Options:
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -viewPath view-path: Path of the view for the current activity.
    Note: The currentactivity view-path option can be any valid pathname within the view (including '.' if the current working directory is in the view).

  • Example:

    ideintegration currentactivity -token token123 -viewPath /view/viewname

Command:

removeactivity

  • Description: Deletes the specified UCM activity.

  • Synopsis: 
    ideintegration removeactivity [-stdin-token | -token token-string] -activityID activity-ID
  • Options:
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
    • -activityID activity-ID: Identifier for the activity to be removed.

  • Example:

    ideintegration removeactivity -token token123 -activityID act_123

Command:

createview

  • Description: Create ClearCase® views.

  • Synopsis

    dynamic or snapshot: 
    createview -viewTag view-Tag [-streamSelector stream-selector]\
-textMode { TRANSPARENT | INSERT_CR | NL_TO_CR | STRIP_CR } -viewType {dynamic | snapshot}\
[-hasRealSymlinks {true | false}] [-autoHijack {true | false}] [-ucmView {true | false}]\
[-shareDerivedObject {true | false}] [-copyAreaPath copy-areapath] [-driveLetter drive-letter]\
[-sharedCleartextCacheLocation Cache-location] -viewStoragePath view-storage-path | 
-viewStorageLocation view-storage-location\n\
    web or automatic
    createview -viewTag view-Tag [-stdin-token | -token token-string] 
[-streamSelector stream-selector] \
-textMode { TRANSPARENT | INSERT_CR | NL_TO_CR | STRIP_CR } -viewType {web | automatic}\
[-hasRealSymlinks {true | false}] [-autoHijack {true | false}] [-ucmView {true | false}]\
[-shareDerivedObject {true | false}] [-copyAreaPath copy-areapath] [-driveLetter drive-letter]\
[-sharedCleartextCacheLocation Cache-location] [-viewStoragePath shared-storagepath]\n\
    Graphical
    createview [-stdin-token | -token token-string] -graphical
  • Options:
    • -stdin-token (optional): Prompt for the token in the standard input.
    • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used. This is required for web and automatic views.
    • -viewTag: Name of the view.
    • -streamSelector (optional): Stream selector of a view. This is required for the UCM view.
    • -viewStoragePath (optional): The storage path of the view. If you do not provide a path, the API chooses your home directory as the view storage path.
    • -viewStorageLocation (optional): The storage location of the view. This is applicable only to dynamic and snapshot views.
    • -sharedCleartextCacheLocation (optional): View cache location. This is only valid for automatic view.
    • -textMode: Line terminator for text files. Allowable values are TRANSPARENT, INSERT_CR, NL_TO_CR, and STRIP_CR.
    • -viewType: This parameter decides what type of view should be created. Valid values are Dynamic, Snapshot, Automatic, and Web.
    • -hasRealSymlinks (optional): This parameter enables native symbolic links. This is applicable to the snapshot view.
    • -autoHijack (optional): This parameter automatically hijacks files in a view. This is applicable to snapshot, automatic, and web views.
    • -ucmView (optional): This parameter decides whether to create a UCM or a base view.
    • -shareDerivedObject (optional): Create shareable derived objects. Valid values are true or false, and it is applicable only to the dynamic view.
    • -copyAreaPath (optional): It is a view path where artifacts are loaded. This is applicable to snapshot and web views.
    • -driveLetter (optional): To map the view to the network drive. Valid values are [A-Z] and applicable to dynamic and automatic views.

  • Example:

    ideintegration.exe createview -viewTag viewtag1 -textMode TRANSPARENT 
-viewType dynamic -viewStoragePath \sharedpath\viewname.vws

Command:

startview

  • Description: Start a ClearCase® view.

  • Synopsis: 
    startview -viewTags viewTag-Array\n\

    Graphical

    startview -graphical
    • Options:
      • -viewTag: Name of the view.

    • Example:

      ideintegration.exe startview -viewTags test

Command:

stopview

  • Description: Stop a ClearCase® view.

  • Synopsis: 
    stopview -viewTags viewTag-Array
    • Options:
      • -viewTag: Name of the view.

    • Example:

      ideintegration.exe stopview -viewTags test

Command:

updateview

  • Description: Update the view from the repository.

  • Synopsis: 
    ideintegration updateview [-stdin-token | -token token-string][-hijackedHandling keep | overwrite | rename] -viewPath view-path
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
      • hijackedHandling (optional): Specify how to manage a hijacked resource.
        Note: By default, the keep option is selected for a hijacked file unless you specify the option.
        • keep: Retains the file in its current state.
        • overwrite: Restores the file to its state before the hijacking.
        • rename: Restores the file to its previous state while saving a renamed copy.
      • -viewPath view-path: This specifies the path of the view to be updated.
        Note: The updateview view-path option can be any valid pathname within the view (including '.' if the current working directory is in the view).

    • Example:

      ideintegration updateview -token token123 -hijackedHanding overwrite -viewPath /view/viewname

Command:

aggregatestatus

  • Description: Retrieves a list of checked-out, hijacked, and view private resources in a view or any directory resource in the view.

  • Synopsis: 
    ideintegration aggregatestatus [-stdin-token | -token token-string] -resourcePath resource-path
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
      • -resourcePath resource-path: Path of the view or any directory in a view.

    • Example:

      ideintegration aggregatestatus [-token token-string|-stdin-token] -resourcePath /view/viewname/dir

Command:

getviewstream

  • Description: Get the stream (UCM views only) of the view.

  • Synopsis: 
    ideintegration getviewstream [-stdin-token | -token token-string] -viewPath view-path
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
      • -viewPath view-path: Path of the view.
        Note: The getviewstream view-path option can be any valid pathname within the view (including '.' if the current working directory is in the view).

    • Example:

      ideintegration getviewstream -token token123 -viewPath /view/viewname

Command:

getvobs

  • Description: Retrieve the list of VOB tags.

  • Synopsis: 
    ideintegration getvobs [-stdin-token | -token token-string]
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.

    • Example:

      ideintegration getvobs -token token123

Command:

getpvobs

  • Description: Retrieve the list of project VOB tags.

  • Synopsis: 
    ideintegration getpvobs [-stdin-token | -token token-string]
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.

    • Example:

      ideintegration getpvobs -token token123

Command:

getprojfolders

  • Description: Retrieve the list of projects and folders.

  • Synopsis: 
    ideintegration getprojfolders [-stdin-token | -token token-string] -vobSelector project-vob-tag
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
      • -vobSelector project-vob-tag: Tag of the project VOB.

    • Example:

      ideintegration getprojfolders -token token123 -vobSelector "vobtag:/AutoPVOB@local-reg"

Command:

getprojsubfolders

  • Description: Retrieve the list of projects and sub-folders.

  • Synopsis: 
    ideintegration getprojsubfolders [-stdin-token | -token token-string] -folder folder-selector
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
      • -folder folder-selector: The project folder from which the sub-folder needs to be retrieved.

    • Example:

      ideintegration getprojsubfolders -token token123 -folder "dir@AutoPVOB"

Command:

getintstream

  • Description: Retrieve the integration stream of a project.

  • Synopsis: 
    ideintegration getintstream [-stdin-token | -token token-string] -project project-selector
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
      • -project project-selector: A project selector to determine which integration streams should be retrieved.

    • Example:

      ideintegration getintstream -token token123 -project "NewProject@AutoPVOB"

Command:

getstreams

  • Description: Retrieve a list of streams or sub-streams of a stream.

  • Synopsis: 
    ideintegration getstreams [-stdin-token | -token token-string] -stream stream-selector
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used.
      • -stream stream-selector: The stream name in the stream selector format, such as streamName@ProjectVOB.

    • Example:

      ideintegration getstreams -token token123 -stream "stream:streamXY@AutoPVOB"

Command:

setconfigspec

  • Description: Sets the config spec for a base ClearCase® view and updates the Custom Rules section of the config spec in a UCM view.

  • Synopsis

    dynamic or snapshot: 
    ideintegration setconfigspec -viewPath local-viewPath\
-configSpec view-config-spec | -elementRules element-rules [-loadRules load-rules]\
[-mountVobs list-vobs]\n\
    web or automatic
    ideintegration setconfigspec [-stdin-token | -token token-string] -viewPath local-viewPath\
-configSpec view-config-spec | -elementRules element-rules [-loadRules load-rules]\
[-mountVobs list-vobs]\n\
    Graphical
    ideintegration setconfigspec [-stdin-token | -token token-string] 
-graphical -viewPath local-viewPath"\n\
    • Options:
      • -stdin-token (optional): Prompt for the token in the standard input.
      • -token token-string (optional): Use this option to provide an authentication token. For LAN-based views, this option should not be used. This is required for web and automatic views.
      • -viewPath: Path in the view, where you will operate.
      • -configSpec: It is a combination of Element rules and Load rules, if they exist. For example, 'element * /main/1 \n load /testVob'".
      • -elementRules: Element rules, which are set within the view. For example, 'element * /main/1'".
      • -loadRules: Load rules, which are set within the view. For example, 'load /testVob'".
      • -mountVobs: VOBs that need to be mounted. This is applicable only to automatic views.

    • Example:

      ideintegration.exe setconfigspec -viewPath \testfoler\viewname.vws -configSpec "config spec text"