1 07/16/79  transaction_call, trc
 2 
 3 Syntax:  trc opname switchname {args}
 4 
 5 
 6 Function: This command performs operations on a vfile_ transaction control file
 7 (TCF) I/O switch.
 8 
 9 
10 Arguments:
11 opname
12    specifies the operation to perform.  See "List of operations" section below.
13 switchname
14    is the TCF I/O switch name.
15 args
16    depend upon the operation.
17 
18 
19 List of operations:
20 assign, a: trc a switchname
21    reserves a new transaction number.
22 commit, c: trc c switchname
23    commit the current transaction.
24 number, n: trc n switchname
25    print the current transaction number.
26 rollback, r: trc r switchname
27    rolls back the current transaction.
28 status, s: trc s switchname {transaction_no} {-control_args}
29    prints the status of transaction transaction_no.  If transaction_no is
30    omitted or zero, the current transaction number is used.  Control arguments
31    may be -brief, -verify.
32 transact, t: trc t switchname {-control_args} command_line
33    executes the command line as a transaction.  The command line need not be
34    enclosed in quotes.  Control arguments may be -retry, -signal, -no_signal.
35 
36 
37 Control arguments:
38 -brief, -bf
39    (status) don't count and print the number of passive and nonpassive
40    references made by the transaction.
41 -verify, -vf
42    (status) check all passive references for asynchronous changes.
43 -retry N
44    (transact) specifies maximum number of times to retry the transaction if
45    commitment fails.  The default is zero.
46 -signal
47    (transact) if commitment fails and the retry count has been exceeded, signal
48    the transaction_failure condition.  This is the default.  After
49    transaction_failure has been signaled, program_interrupt will re-execute the
50    command line as a transaction.  The start command does not.  The transaction
51    is rolled back before transaction_failure is signaled.
52 -no_signal
53    (transact) don't signal the transaction_failure condition if commitment
54    fails and the retry count has been exceeded.