cli transaction

cli transaction(1)	      BIG-IP TMSH Manual	    cli transaction(1)



NAME
       transaction - Opens batch mode within which you can submit a set of
       commands as a single transaction.

MODULE
       cli

SYNTAX
       Use the transaction component within the cli module to open batch mode,
       enter a series of commands, and then submit the commands as a single
       transaction.

   CREATE/MODIFY
	create transaction

	modify transaction
	  options:
	    delete [entry_id]

	submit transaction [validate-only]

   DISPLAY
	list transaction

   DELETE
	delete transaction

DESCRIPTION
       tmsh parses each command that you enter in batch mode. If the command
       passes a syntax check, tmsh saves it as part of the transaction you are
       creating and returns a confirmation. After you finish adding commands,
       you submit the transaction to change the running configuration of the
       system. You must run the save config command to save the changes to the
       stored configuration files.

       If, while creating a transaction, you decide you do not want to change
       the running configuration, you can delete the transaction rather than
       submit it. However, you can recreate a transaction that you have
       deleted by using the cli history component.

       There are a few commands that you can enter on the command line that
       the system immediately runs, rather than adding the commands to a
       transaction. These commands are list and show. Additionally, tmsh
       immediately runs the command sequence run bigpipe, but does not add it
       to the transaction.

EXAMPLES
       The following example shows the commands that you enter from within the
       ltm module to create and submit a transaction that creates a Local
       Traffic Manager pool and virtual server, and then associates the two.

       1. Open tmsh batch mode:
	    create /cli transaction

       2. Add a command to the transaction that creates pool1 for the Local
       Traffic Manager using the default values for a pool:
	    create pool pool1

       3. Add a command to the transaction that creates the virtual server
       virtual1 for the Local Traffic Manager using the default values for a
       virtual server, and associates it with pool1.
	    create virtual virtual1 pool pool1

       4. Display, in a numbered list, the current set of commands in the
       transaction:
	    list /cli transaction

	    Note: You can use the preceding command to determine the entry ID
	    of a command. Then, you can use this ID to remove or replace a
	    command in the transaction, or to identify a command before which
	    you want to insert another command.

       5. Submit the transaction:
	    submit /cli transaction

OPTIONS
       command
	    Specifies, in quotation marks, the full path to a command to add
	    to or delete from the transaction that you are creating. You can
	    also replace an existing command with another command or insert a
	    command before a command in the transaction.

       create
	    Opens batch mode.

       delete
	    Deletes the transaction that you are creating and closes batch
	    mode.

       list Displays, in a numbered list, the current set of commands in the
	    transaction that you are creating.

       modify
	    Specifies a previously entered line in the transaction that you
	    want to change. The options are:

	    delete
		 Deletes the specified entries from the transaction that you
		 are creating.

	    entry_id
		 Specifies the number of a command in the list of commands in
		 the transaction that you want to delete.

       submit [validate-only]
	    Submits the transaction that you are entering and closes batch
	    mode. The transaction is submitted in the context of the cli
	    admin-partitions settings that are active when the submit command
	    is issued.

	    validate-only
		 Validates the configuration changes without putting them in
		 production.

SEE ALSO
       cli admin-partitions, create, delete, list, modify, submit, tmsh

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or
       by any means, electronic or mechanical, including photocopying,
       recording, or information storage and retrieval systems, for any
       purpose other than the purchaser's personal use, without the express
       written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2009-2013, 2015. All rights
       reserved.



BIG-IP				  2015-06-01		    cli transaction(1)