im refmode
sets the sharing behaviour for content
Synopsis
im refmode [--refmode=[reuse|share] [shareID=value] [[no]useDefault] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] node id...
Description
im refmode allows you to set or change the reference mode on individual or multiple nodes in a segment.
Options
This command takes the universal options available to all
im commands, as well as some general options. See the
options reference page for descriptions.
• --refmode=[reuse|share]
allows you to specify the reference mode for content. Selecting --share creates a share relationship while --reuse removes one if it exists on a node. The available reference modes explained:
Share:When the author changes their content you will automatically see the changes reflected in your document.
Reuse: If the author changes content, the content will be branched and a copy of the changes is created. The reuser becomes the author of the new shared item. When this option is specified, neither --shareID nor --useDefault can be specified.
• --shareID=value
When this option is specified, the reference mode does not need to be defined. Share is assumed. The selected item follows the significant field edits happening on the item specified with this option.
• --[no]useDefault
specifies to use the ID of the originating node from where the you want to change was branched. When --useDefault is specified, --shareID is ignored. When --[no]useDefault is specified, --shareID is required. Default is --nouseDefault.
• node id...
the node ID(s) of the content you want to change. Use a space separated list to specify more than one issue ID, for example, 240 241 242.
See Also