Command-Line Interface User's Guide
Total Page:16
File Type:pdf, Size:1020Kb
Storage Productivity Center for Replication for System z Version 4.2.2.1 Command-line Interface User's Guide SC27-2323-06 Storage Productivity Center for Replication for System z Version 4.2.2.1 Command-line Interface User's Guide SC27-2323-06 Note Before using this information and the product it supports, read the information in “Notices” on page 133. This edition applies to version 4, release 2, modification 2, fix pack 1 of IBM Tivoli Storage Productivity Center for Replication for System z (product number 5698-B30 and 5698-B31) and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces SC27-2323-05. © Copyright IBM Corporation 2005, 2011. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ...............v lslss .................55 lsmc .................57 Tables ...............vii lspair ................59 lsparameter ..............63 lspath ................65 About this guide ...........ix lspool ................67 Intended audience ............ix lsrolepairs ...............70 Command-line interface conventions ......ix lsrolescpset ..............73 Presentation of command information ....ix lssess ................75 Command entry ............xi lssessactions ..............78 Command modes ...........xii lssessdetails ..............80 User assistance for commands .......xiv lssnapgrp ...............82 Output from command processing .....xv lssnapgrpactions.............85 Accessing the IBM Tivoli Storage Productivity lssnapshots ..............87 Center for Replication Information Center ....xix lssnmp ................89 Publications and related information for IBM Tivoli lsstorcandidate .............90 Storage Productivity Center for Replication for lsvol .................92 System z publications...........xix mkauth ................95 Web resources .............xxi mkbackup ...............97 Providing feedback about publications .....xxii mkcpset ...............98 mklogpkg ..............100 Chapter 1. Customizing the mkpath ...............100 command-line interface ........1 mksess ...............101 Configuring the command-line interface .....1 mksnmp ...............105 Setting up automatic login to the CLI ......1 refreshdevice .............106 rmactive ...............106 Chapter 2. csmcli command rmassoc ...............107 descriptions .............3 rmauth ...............108 rmcpset ...............109 adddevice ...............7 rmdevice ...............110 addhost ................9 rmhost................111 addmc ................9 rmmc ................112 addstorsys...............10 rmpath ...............113 chauth ................11 rmsess................114 chdevice ...............13 rmsnmp ...............114 chhost ................14 rmstdby ...............115 chlocation ...............15 rmstorsys...............116 chmc ................16 setasstdby ..............117 chsess ................17 setparameter..............118 chvol ................25 setstdby ...............118 cmdsess ...............26 showcpset ..............119 cmdsnapgrp ..............28 showdevice ..............120 exportcsv ...............32 showgmdetails .............124 hareconnect ..............33 showha ...............126 hatakeover ..............34 showmc ...............127 importcsv ...............35 showsess ...............128 lsauth ................37 ver.................131 lsavailports ..............38 whoami ...............132 lscpset ................40 lscptypes ...............42 Notices ..............133 lsdevice................45 lshaservers ..............49 Trademarks ..............135 lshost ................51 lslocation ...............53 Index ...............137 © Copyright IBM Corp. 2005, 2011 iii iv Command-line Interface User's Guide Figures © Copyright IBM Corp. 2005, 2011 v vi Command-line Interface User's Guide Tables 1. Exit codes for CLI commands ......xvi © Copyright IBM Corp. 2005, 2011 vii viii Command-line Interface User's Guide About this guide This section briefly describes the content and the audience of this publication and explains how the information in this publication is organized. This guide provides definitions, syntax, and examples for these command-line interface (CLI) commands that are used for the varieties of IBM® Tivoli® Storage Productivity Center for Replication: v IBM Tivoli Storage Productivity Center for Replication Two Site Business Continuity v IBM Tivoli Storage Productivity Center for Replication Three Site Business Continuity v IBM Tivoli Storage Productivity Center for Replication Basic Edition for System z® v IBM Tivoli Storage Productivity Center for Replication for System z IBM Tivoli Storage Productivity Center for Replication is supported on the following platforms: v AIX® V5.3 ML3 and AIX 6.1 v Red Hat Enterprise Linux 4 Update and Red Hat Enterprise Linux 5 AS v Windows Datacenter Edition and Windows 2003 Enterprise Edition v Windows Server 2008 Standard Edition and Windows Server 2008 Enterprise Edition v z/OS® V1.9 or later Intended audience This publication is intended for users of the CLI program for IBM Tivoli Storage Productivity Center for Replication. Command-line interface conventions This topic provides information about using the CLI program for IBM Tivoli Storage Productivity Center for Replication. It includes information about command conventions and modes, command format requirements, and other usage information. Presentation of command information This topic describes how information is presented in the command descriptions. A syntax diagram uses symbols to represent the elements of a command and to specify the rules for using these elements. A keyword represents the name of a command, flag, parameter, or argument. Required key words indicate the parameters or arguments that must be specified for the command. Syntax diagrams conventions To read syntax diagrams, follow the path of the line. Read the diagrams from left-to-right, top-to-bottom, following the main path line: © Copyright IBM Corp. 2005, 2011 ix v Required keywords are displayed on the main path line. Mutually exclusive required keywords are stacked vertically. Optional key words indicate the parameters or arguments you can choose to specify for the command. Optional keywords appear below the main path line. Mutually exclusive optional keywords are stacked vertically. v The main path line begins on the left with double arrowheads (>>) and ends on the right with two arrowheads facing each other (><). If a diagram is longer than one line, each line to be continued ends with a single arrowhead (>) and the next line begins with a single arrowhead. The -->< symbol indicates the end of the syntax diagram. v A dash (-) indicates that you must supply parameters from the stdin file rather than entering parameters. v An arrow returning to the left means you can repeat the item. A character or space within the arrow means you must separate repeated items with that character or space. v A stack of items followed by an arrow returning to the left means that you can select more than one item or, in some cases, repeat a single item. v When a group of parameters is lengthy or a section is used more than once in a command, it is shown as a separate fragment following the main diagram. Syntax diagrams use position to indicate required, optional, and default values for keywords, variables, and operands: v If an element is shown on the line, the element is required. If an element is shown below the line, the element is optional. If an element is shown above the line, the element is the default. v If an operand has a default value, the operand is shown both above and below the main line. A value below the main line indicates that the operand must be specified. You must specify the default value or one of the other valid values that are shown. If an operand is not specified, the default value above the main line is used. v When one or more items are shown below the main line, all of the items are optional. Command emphasis The following typefaces are used to show command emphasis: boldface Text in boldface represents command names. italics Text in italics is used for variables for which you supply actual values, such as a default directory or the name of a cluster. monospace Text in monospace identifies the data or commands that you type, samples of command output, examples of program code or messages from the system, or names of command flags, parameters, arguments, and name-value pairs. Special characters The following special characters are used in the command descriptions: minus sign (-) Flags are prefixed with a minus sign (-). Flags define the action of a command or modify the operation of a command. You can use multiple x Command-line Interface User's Guide flags, followed by parameters, when you issue a command. This character cannot be used as the first character of an object name. vertical bar ( |) A vertical bar signifies that you choose only one value. For example, [a|b]indicates that you can choose a, b, or nothing. Similarly, {a|b}indicates that you must choose either a or b. quotation marks (" ") Quotation marks around a string indicate that the value can include spaces, for example, "my session name." brackets ([ ]) Brackets indicate optional options, parameters, and arguments. braces ({ }) Braces indicate a required choice between two or more options or arguments. ellipsis (...) Ellipses indicate repetition or multiple values or arguments. Command entry This