Browser Primary Commands and Arguments
The M+R Version Browser provides you with three primary commands that are entered on the Command line of the panel:
-
VIEW or V
-
EXCLUDE or X
-
RESET or R
You type one of six arguments with each primary command to create fifteen unique views for version browsing and editing.
This table describes the six arguments for version browser primary commands.
Note
There are two short forms for each argument:
-
First two letters
-
Symbol
| Argument | Specifics |
|---|---|
| ALl \ |
Every base, derivative, and user inserted record, including those deleted by you. ALL can be represented by an asterisk (*). |
| COnflict $ |
Base and derivative record sets that are in conflict; a user must decide how to resolve the differences through editing. CONFLICT can also be represented by a dollar ($) sign (outside U.S.A. and Canada it is the national currency symbol). |
| REmaining # |
Base and derivative record sets that have not been deleted during conflict resolution, as well as base records that have not been overridden by changes made by only one derivative. REMAINING can also be represented by the pound (#) sign. |
| BAse @ |
Records of the base file. BR/>BASE can also be represented by the "at" (@) sign. |
| letter | Derivative records from the specified ID, a single alphabetic character "A" to "Z". |
| USer + |
Changes that you have made so far. |
This table describes the view or context that results from each version browser primary command when it is combined with each of the six arguments.
| COMMAND | Argument | Function | Examples |
|---|---|---|---|
| VIEW V | ALl(V *) | Displays all records, including deleted base/derivative records. | VIEW ALL, V \ |
| BAse (V @) | Displays all base records that are not deleted. | v base, v @ | |
| letter (V letter) | Displays derivative records only; displays all non-deleted records of a derivative with that ID; note that the next View command(s) will add the changes made by the second and following derivative(s) to those already displayed. | v A | |
| USer (V +) | Displays user changes only. | v + | |
| COnflicts (V $) | Displays base/derivative records in conflict; that is, the base records changed by more than one derivative and the changes. | v confl, v $ | |
| REmaining (V #) | Displays the consolidated version (the remaining code that has not been deleted and base records that have not been overridden). | V remain, V # | |
| EXCLUDE X | ALl(X *) | eXclude from view all records; excludes everything so that you can use the RESET command to view either the base or one or more derivatives. | EXCL ALL X \ |
| BAse(X @) | eXclude base records only. | x base, x @ | |
| letter (X id) | eXclude derivative records only. | x A | |
| USer(X +) | eXclude user changes only. | x + | |
| COnflicts(X $) | Display base records changed by one derivative only; excludes the conflicts and displays base records changed by one derivative only and those changes. Note that such base records will be overridden by their single changes in the consolidated version if AUTOOVERRIDE=YES in the user profile. | X co, X $ | |
| Remaining (X #) | Display all deleted and overridden records; excludes the remaining code and displays the deleted base/derivative records and the overridden base records so that you can check whether or not it is acceptable to drop that code from the consolidated version. | X re, X # | |
| RESET R | ALl(R *) | Equivalent to "VIEW ALL". | RES ALL, R \ |
| BAse(R @) | Restore previously eXcluded base records. | res base, r @ | |
| letter (R letter) | Restore previously eXcluded derivative records. | r A | |
| USer (R +) | Restore previously eXcluded user changes. | r + | |
| COnflicts(R $) | Equivalent to "VIEW CONFLICT". | r confl, r $ | |
| REmaining(R #) | Equivalent to "VIEW REMAINING". | R remain, R # |
The Reset and eXclude commands mirror each other because you can reset whatever you have excluded from a context, and you can exclude whatever you have included (i.e., reset), within a context.
By default, a context starts from the statistics record (with zero sequence number). The command Begin nnnnnn sets the start of the context to the base record with a relative sequence number of nnnnnn. When there are no changes of interest before that base record, cutting off the beginning of a context can speed up and simplify the display.