CLI Reference > Workflows and Documents Commands > im refmode
 
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.
--[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
Commands: im createsegment, im viewsegment, im insertsegment
Miscellaneous: diagnostics, options, preferences