Moving history file entries

Use the M line command in the Fault Entry List display to move a fault entry.

You can also move a range of fault history entries, using two MM range markers. When you move a range of a matched set of entries, you only move the entries displayed on the screen. You do not move any entries that are not displayed, but are interleaved with the displayed entries on the original history file.

After pressing the Enter key, a display showing the list of fault entries that are selected for move with the M or MM commands is presented. Included are also any fault entries that are selected for copy with the C or CC commands. The display provides a field for specification of a history file to which the fault entries should be moved. This field is initialized with the name of the history file last specified. See Copying history file entries for an example of the Specify Move/Copy Options display that is shown after pressing the Enter key.

The destination history file that is specified is checked for UPDATE access authorization prior to commencing the move/copy processing. If the specified history file does not exist, then the New History File Allocation display is shown (for details, see New history file allocation).

The original fault ID is preserved, if possible. However, if an identical fault ID already exists in the destination history file, then the fault number is incremented to the next available fault ID.

If the move of one or more fault entries was not successful, then a display detailing the reasons is shown.

A locked fault entry cannot be moved. If you need to move a locked fault entry, then first issue the '?' line command and unlock the fault entry from the Fault Entry Information display by changing the Lock Flag value to blanks. If required, lock the moved fault entry again by changing the Lock Flag value to a non-blank value. For details of the values that are permitted for the Lock Flag, see Viewing fault entry information.

The TSO user's access authorization level required to move a fault entry is ALTER.