xvsamWarmStart

xvsamwarmstart

xvsamWarmStart analyzes an XCICS recovery log file, showing eventual un-committed transactions (AKA in-flight transaction) and, optionally, rolls them back.

After an abnormal XCICS termination (i.e. hardware failure), xvsamWarmStart should be used to remove all uncommitted transactions from the XVSAM files, to ensure data integrity.

xvsamWarmStart is automatically invoked by the XCICS control procedure, xcicsctl, when invoked with command warmstart.

Syntax

xvsamWarmStart [-f<filename>] [-x] [-r]

Options

-f<filename>	specifies the recovery log file to analyze
-r	performs un-committed transaction rollback. Without this option it only shows "in-flight" transactions.
-x	forces the recovery, even if errors should occur
-v	verbose mode

Example

# xvsamWarmStart -f/home/data/RECOVERY.LOG -r

Return codes

0	Function correctly executed
12	error(s) trapped