Skip to content

Primary Edit Commands

M+R includes an assortment of primary commands to help you edit the versions during reconciliation.

Overview

You can use the primary edit commands to do the following tasks:

  • LOCATE a base record by its relative line number within the current context, or locate the next base record if many inserts exist (instead of paging).

  • FIND a string within the current context (or within all undeleted records when issued with the argument ALL). FIND is case sensitive when the string is enclosed with a pair of quotation marks or apostrophes. The position of the searched string can be specified.

  • CHANGE a string to another string within the current context (or within all undeleted records when issued with the argument ALL). CHANGE is case sensitive when the searched string is enclosed with a pair of quotation marks or apostrophes. The position of the searched string can be specified.

  • CUT and PASTE: CUT a record block, delimited by a Copy or Move command, from one context, and PASTE that block After or Before a particular record within the same or different context.

  • EXPORT a record block, delimited by Copy or Move command, as a copybook into the designated export data set.

  • RESET (without argument) a line command conflict or a pending block command.

  • END the current reconciliation session and save its results.

  • CANCEL the current reconciliation session without saving its results.

  • SAVE the intermediate results of the current reconciliation, and continue to reconcile.

Edit Within and Across Contexts

Whereas ISPF/PDF or workstation editors restricts you to a single file, M+R enables you to edit multiple merged files, simultaneously and on the same panel. This is important because you must use more than one file (up to 8 versions) during the reconciliation effort.

M+R supports a simple query language to extract different views of the merged versions. Each view provides a different context for consolidation. Editing in context is important for your reconciliation effort because it provides the following benefits:

  • Mirrors the current practice of comparing the base with each of the derivatives. The resultant listings are an ideal context for analysis, and for editing changes during the reconciliation.

  • Helps you determine the change type (add-on or structural, conflicting or complementary), so that you can better plan your reconciliation strategy.

  • Helps you choose the best structure for the final consolidation version. The structure might be derivative- or base-centered, or something new, as dictated by the amount and sources of the changes (single or conflict).

  • Simplifies the editing process, especially when you plan to move or copy a block of changes highlighted in one context to another context.

Context generation is a one-command operation, and each command has one parameter.

You can use the CUT and PASTE commands in tandem to move or copy records across contexts. For example, to resolve a conflict, you might need to move a block of records after a specific record of derivative Z. You would start the operation from the View Conflicts context with block MOVE and CUT commands, switch to View Z, then complete the operation with the FIND and PASTE commands.

M+R enables you to reconcile version records with lengths up to 240 bytes.

Although consolidating base and derivatives records is the primary application of M+R Version Editor, you can also use its selective cross-session undo features to edit a single file.

Primary Command Summary

The following table illustrates the format, function, and examples of primary commands.

COMMAND Argument Function Examples
BEGIN B nnnnnn Reorients the top of the display to a specific line; the specified line number is displayed at the top of the data.
The BEGIN command can also "shorten" a specific context so that it starts from the relative line number (supplied as an argument) of a base record.		 BEGIN 15
Begin 99
b 37
CANCEL CAN Cancels the current reconciliation session. When the Auto-Save profile option is set to "YES", the results are not saved in the WIS file. CANCEL
can
CHANGE C string_1
string_2		 Change string_1 to string_2 only in records within the current context— optionally, at a specified position for string_1. Repeated change, (R)CHANGE, can be executed by alternatively using [PF5/17] and [PF6/18] function keys. (Quotation (") marks or apostrophes (') can be used for a string containing blanks, or respectively, apostrophe(s) or quotation mark(s); or to signify case sensitivity for string_1.) c x y
c "'p'" 'q r'
c '"i"' "j k"
c 12 app acc
CHANGE C ALL
string_1
string_2		 Change string_1 to string_2 in all undeleted base/derivative/user Inserted records—optionally, at a specified position for string_1. (Quotation (") marks or apostrophes (') can be used for a string containing blanks, or respectively, apostrophe(s) or quotation mark(s); or to signify case sensitivity for string_1.) c all x y 22
c x y all
c all "'p'" 'q r'
c '"i"' "j k" all
CUT Extract a block of records, as defined by Copy or Move line command, to paste it to another place or context. CUT
cut
END
PF03/PF15
PF04/PF16 =*n		 Use for a normal termination of the current reconciliation session. When the Auto-Save profile option is set to "YES", the results are saved in the WIS file. END
PF03/PF15
PF04/PF16
EXPORT EXP copybook name Extract a block of records, as defined by Copy or Move line command, and write it as a copybook into the designated export data set. EXP cpyone
export
mycopy
FIND F string_1 Find string_1 only in records within the current context—optionally, at a specified position for string_1. Repeated find, (R)FIND, can be executed with the [PF5/ 17] function key. (Quotation (") marks or apostrophes (') can be used for a string containing blanks, or respectively, apostrophe(s) or quotation mark(s); or to signify case sensitivity for string_1.) f x
f "q r"
f "'p'"
f '"i"'
f app 12
FIND F ALL string_1 Find string_1 in all undeleted base/ derivative/User Inserted records— optionally, at a specified position for string_1. (Quotation (") marks or apostrophes (') can be used for a string containing blanks, or respectively, apostrophe(s) or quotation mark(s); or to signify case sensitivity for string_1.) f all x
f "q r" all
f all "'p'"
f '"i"' all
f 12 all app
LOCATE L nnnnnn Position to a particular base line number temporarily. Scrolling can proceed after this location has been set. LOCATE 5
Locate 32
l 37
LOCATE L - Position to the next base record. Useful when numerous derivative records have been inserted after a particular base record. LOCATE
l
PASTE PAS - Insert a block of records previously CUT from another place or context. The insertion point is determined by an After or Before line command. PAS
pas
RESET RES - Reset any command conflict, pending, error, and so forth. RESET
reset
RES
res
SAVE SAV - Save the current reconciliation effort and continue to reconcile. Subsequent CANcel command and then LOAD will restore the reconciliation as it was when the last SAVE command was issued. SAVE
sav

...