More Related Content Similar to Informatica Command Line Statements Similar to Informatica Command Line Statements (20) Informatica Command Line Statements2. Informatica PowerCenter Command Line Reference
Version 8.5.1
December 2007
Copyright (c) 1998–2007 Informatica Corporation. All rights reserved.
This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing
restrictions on use and disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be
reproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. This
Software is protected by U.S. and/or international Patents and other Patents Pending.
Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as
provided in DFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR
52.227-14 (ALT III), as applicable.
The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report
them to us in writing.
Informatica, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica
Data Quality, Informatica Data Explorer, Informatica Complex Data Exchange and Informatica On Demand Data Replicator are trademarks or registered
trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade
names or trademarks of their respective owners.
Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies.
All rights reserved. Copyright © 2007 Adobe Systems Incorporated. All rights reserved. Copyright © Sun Microsystems. All rights reserved. Copyright © RSA
Security Inc. All Rights Reserved. Copyright © Ordinal Technology Corp. All rights reserved. Copyright © Platon Data Technology GmbH. All rights reserved.
Copyright © Melissa Data Corporation. All rights reserved. Copyright © Aandacht c.v. All rights reserved. Copyright 1996-2007 ComponentSource®. All
rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright 2007 Isomorphic Software. All rights reserved. Copyright © Meta Integration
Technology, Inc. All rights reserved. Copyright © MySQL AB. All rights reserved. Copyright © Microsoft. All rights reserved. Copyright © Oracle. All rights
reserved. Copyright © AKS-Labs. All rights reserved. Copyright © Quovadx, Inc. All rights reserved. Copyright © SAP All rights reserved. Copyright 2003,
.
2007 Instantiations, Inc. All rights reserved.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/), software copyright 2004-2005 Open Symphony (all
rights reserved) and other software which is licensed under the Apache License, Version 2.0 (the “License”). You may obtain a copy of the License at http://
www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
“AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language
governing permissions and limitations under the License.
This product includes software which was developed by Mozilla (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved;
software copyright, Red Hat Middleware, LLC, all rights reserved; software copyright © 1999-2006 by Bruno Lowagie and Paulo Soares and other software
which is licensed under the GNU Lesser General Public License Agreement, which may be found at http://www.gnu.org/licenses/lgpl.html. The materials are
provided free of charge by Informatica, “as-is”, without warranty of any kind, either express or implied, including but not limited to the implied warranties of
merchantability and fitness for a particular purpose.
The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of
California, Irvine, and Vanderbilt University, Copyright (c) 1993-2006, all rights reserved.
This product includes software copyright (c) 2003-2007, Terence Parr. All rights reserved. Your right to use such materials is set forth in the license which may
be found at http://www.antlr.org/license.html. The materials are provided free of charge by Informatica, “as-is”, without warranty of any kind, either express or
implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose.
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and
redistribution of this software is subject to terms available at http://www.openssl.org.
This product includes Curl software which is Copyright 1996-2007, Daniel Stenberg, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations
regarding this software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for
any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
The product includes software copyright 2001-2005 (C) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to
terms available at http://www.dom4j.org/license.html.
The product includes software copyright (c) 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are
subject to terms available at http://svn.dojotoolkit.org/dojo/trunk/LICENSE.
This product includes ICU software which is copyright (c) 1995-2003 International Business Machines Corporation and others. All rights reserved. Permissions
and limitations regarding this software are subject to terms available at http://www-306.ibm.com/software/globalization/icu/license.jsp
This product includes software copyright (C) 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be
found at http://www.gnu.org/software/kawa/Software-License.html.
This product includes OSSP UUID software which is Copyright (c) 2002 Ralf S. Engelschall, Copyright (c) 2002 The OSSP Project Copyright (c) 2002 Cable
& Wireless Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-
license.php.
3. This product includes software developed by Boost (http://www.boost.org/). Permissions and limitations regarding this software are subject to terms available at
http://www.boost.org/LICENSE_1_0.txt.
This product includes software copyright © 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms
available at http://www.pcre.org/license.txt.
This product includes software copyright (c) 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject
to terms available at http://www.eclipse.org/org/documents/epl-v10.php.
The product includes the zlib library copyright (c) 1995-2005 Jean-loup Gailly and Mark Adler.
This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html.
This product includes software licensed under the terms at http://www.bosrup.com/web/overlib/?License.
This product includes software licensed under the terms at http://www.stlport.org/doc/license.html.
This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php.)
This product includes software developed by the Indiana University Extreme! Lab. For further information please visit http://www.extreme.indiana.edu/.
This Software is protected by U.S. Patent Numbers 6,208,990; 6,044,374; 6,014,670; 6,032,158; 5,794,246; 6,339,775; 6,850,947; 6,895,471 and other U.S.
Patents Pending.
DISCLAIMER: Informatica Corporation provides this documentation “as is” without warranty of any kind, either express or implied, including, but not limited
to, the implied warranties of non-infringement, merchantability, or use for a particular purpose. Informatica Corporation does not warrant that this software or
documentation is error free. The information provided in this software or documentation may include technical inaccuracies or typographical errors. The
information in this software and documentation is subject to change at any time without notice.
Part Number: PC-CLR-85100-0001
5. Table of Contents
List of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Informatica Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Informatica Customer Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Informatica Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Informatica Knowledge Base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Informatica Global Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Chapter 1: Using the Command Line Programs . . . . . . . . . . . . . . . . . . 1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Entering Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Syntax Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Chapter 2: Configuring Environment Variables . . . . . . . . . . . . . . . . . . 5
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
INFA_CLIENT_RESILIENCE_TIMEOUT . . . . . . . . . . . . . . . . . . . . . . . . . 8
INFA_CODEPAGENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
INFA_DEFAULT_DATABASE_PASSWORD . . . . . . . . . . . . . . . . . . . . . . . 10
INFA_DEFAULT_DOMAIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
INFA_DEFAULT_DOMAIN_PASSWORD . . . . . . . . . . . . . . . . . . . . . . . . 12
INFA_DEFAULT_DOMAIN_USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
INFA_REPCNX_INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
INFATOOL_DATEFORMAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Encrypting Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Using a Password as an Environment Variable . . . . . . . . . . . . . . . . . . . . 16
Setting the User Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Chapter 3: infacmd Command Reference . . . . . . . . . . . . . . . . . . . . . . 19
Using infacmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Running Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Command Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Return Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
AddAlertUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
v
6. AddDomainLink. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
AddDomainNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
AddGroupPermission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
AddGroupPrivilege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
AddLicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
AddNodeResource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
AddRolePrivilege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
AddServiceLevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
AddUserPermission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
AddUserPrivilege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
AddUserToGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
AssignedToLicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
AssignISToMMService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
AssignLicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
AssignRoleToGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
AssignRoleToUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
AssignRSToWSHubService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
BackupDARepositoryContents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
ConvertLogFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
CreateDARepositoryContents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
CreateFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
CreateGrid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
CreateGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
CreateIntegrationService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Integration Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Integration Service Process Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
CreateMMService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Metadata Manager Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
CreateOSProfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Integration Service Process Options for Operating System Profiles . . . . . . 82
CreateReportingService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Reporting Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Reporting Source Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Lineage Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
CreateRepositoryService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Repository Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
CreateRole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
CreateSAPBWService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
vi Table of Contents
7. SAP BW Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
SAP BW Service Process Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
CreateUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
CreateWSHubService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Web Services Hub Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
DeleteDARepositoryContents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
DisableNodeResource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
DisableService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
DisableServiceProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
DisableUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
EditUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
EnableNodeResource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
EnableService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
EnableServiceProcess. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
EnableUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
ExportUsersAndGroups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
GetFolderInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
GetLastError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
GetLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
GetNodeName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
GetServiceOption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
GetServiceProcessOption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
GetServiceProcessStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
GetServiceStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
GetSessionLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
GetWorkflowLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
ImportUsersAndGroups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
ListAlertUsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
ListAllGroups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
ListAllRoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
ListAllUsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
ListDomainLinks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
ListDomainOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
ListFolders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
ListGridNodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
ListGroupPrivileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
ListLDAPConnectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
vii Table of Contents
8. ListLicenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
ListNodeOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
ListNodeResources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
ListOSProfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
ListRepositoryLDAPConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
ListRolePrivileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
ListSecurityDomains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
ListServiceLevels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
ListServiceNodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
ListServicePrivileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
ListServices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
ListSMTPOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
ListUserPrivileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
MoveFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
MoveObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
PurgeLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
RemoveAlertUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
RemoveDomainLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
RemoveFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
RemoveGrid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
RemoveGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
RemoveGroupPrivilege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
RemoveLicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
RemoveNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
RemoveNodeResource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
RemoveOSProfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
RemoveRole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
RemoveRolePrivilege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
RemoveService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
RemoveServiceLevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
RemoveUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
RemoveUserFromGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
RemoveUserPrivilege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
ResetPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
RestoreDARepositoryContents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
RunCPUProfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
SetLDAPConnectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
viii Table of Contents
9. SetRepositoryLDAPConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
ShowLicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
ShutdownNode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
SwitchToGatewayNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
SwitchToWorkerNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
UnassignISMMService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
UnassignLicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
UnAssignRoleFromGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
UnAssignRoleFromUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
UnassignRSWSHubService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
UnassociateDomainNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
UpdateDomainOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
UpdateDomainPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
UpdateFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
UpdateGatewayInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
UpdateGrid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
UpdateIntegrationService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
UpdateLicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
UpdateMMService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
UpdateNodeOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
UpdateOSProfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
UpdateReportingService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
UpdateRepositoryService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
UpdateSAPBWService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
UpdateServiceLevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
UpdateServiceProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
UpdateSMTPOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
UpdateWSHubService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
UpgradeDARepositoryContents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
UpgradeDARepositoryUsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Chapter 4: infasetup Command Reference . . . . . . . . . . . . . . . . . . . . 263
Using infasetup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Running Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Command Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Return Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Using Database Connection Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
ix Table of Contents
10. BackupDomain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
DefineDomain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
DefineGatewayNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
DefineWorkerNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
DeleteDomain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
RestoreDomain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
UpdateGatewayNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
UpdateWorkerNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Chapter 5: pmcmd Command Reference . . . . . . . . . . . . . . . . . . . . . 289
Using pmcmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Running Commands in Command Line Mode . . . . . . . . . . . . . . . . . . . 290
Running Commands in Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . 292
Running in Wait Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Scripting pmcmd Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Entering Command Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
aborttask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
abortworkflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
getrunningsessionsdetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
getservicedetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
getserviceproperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
getsessionstatistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
gettaskdetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
getworkflowdetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
pingservice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
recoverworkflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
scheduleworkflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
setfolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
setnowait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
setwait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
showsettings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
starttask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
x Table of Contents
11. Using Parameter Files with starttask . . . . . . . . . . . . . . . . . . . . . . . . . . 331
startworkflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Using Parameter Files with startworkflow . . . . . . . . . . . . . . . . . . . . . . 334
stoptask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
stopworkflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
unscheduleworkflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
unsetfolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
waittask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
waitworkflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Chapter 6: pmrep Command Reference . . . . . . . . . . . . . . . . . . . . . . 349
Using pmrep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
Running Commands in Command Line Mode . . . . . . . . . . . . . . . . . . . 350
Running Commands in Interactive Mode . . . . . . . . . . . . . . . . . . . . . . 350
Running Commands in Normal Mode and Exclusive Mode . . . . . . . . . 351
Return Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
Using Native Connect Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
Scripting pmrep Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
AddToDeploymentGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
ApplyLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
AssignPermission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
BackUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
ChangeOwner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
CheckIn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
CleanUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
ClearDeploymentGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
CreateConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Specifying the Database Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Specifying the Database Code Page . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
CreateDeploymentGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
CreateFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
Assigning Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
CreateLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Table of Contents xi
12. DeleteConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
DeleteDeploymentGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
DeleteFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
DeleteLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
DeleteObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
DeployDeploymentGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
DeployFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
ExecuteQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
FindCheckout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
GetConnectionDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
KillUserConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
ListConnections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
ListGroupsForUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
ListObjectDependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
ListObjects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Listing Object Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Listing Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Listing Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
ListTablesBySess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
ListUserConnections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
ModifyFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
Notify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
ObjectExport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
ObjectImport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
PurgeVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
RegisterPlugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Registering a Security Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
RollbackDeployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
ShowConnectionInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
xii Table of Contents
13. SwitchConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
TruncateLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
UndoCheckout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
Unregister . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
UnregisterPlugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
Unregistering an External Security Module . . . . . . . . . . . . . . . . . . . . . 432
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
UpdateConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
UpdateEmailAddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
UpdateSeqGenVals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
UpdateSrcPrefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
UpdateStatistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
UpdateTargPrefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
Upgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
Validate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
Chapter 7: Working with pmrep Files . . . . . . . . . . . . . . . . . . . . . . . . 447
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
Using the Persistent Input File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
Creating a Persistent Input File with pmrep . . . . . . . . . . . . . . . . . . . . . 449
Creating a Persistent Input File Manually . . . . . . . . . . . . . . . . . . . . . . 450
Using the Object Import Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Object Import Control File Parameters . . . . . . . . . . . . . . . . . . . . . . . . 453
Object Import Control File Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
Importing Source Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
Importing Multiple Objects into a Folder . . . . . . . . . . . . . . . . . . . . . . 456
Checking In and Labeling Imported Objects . . . . . . . . . . . . . . . . . . . . 457
Retaining Sequence Generator and Normalizer Values . . . . . . . . . . . . . 457
Importing Objects and Local Shortcut Objects to the Same Repository . 457
Importing Shortcut Objects from Another Repository . . . . . . . . . . . . . 458
Importing Objects to Multiple Folders . . . . . . . . . . . . . . . . . . . . . . . . 458
Importing Specific Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Reusing and Replacing Dependent Objects . . . . . . . . . . . . . . . . . . . . . 459
Replacing Invalid Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Renaming Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
Copying SAP Mappings and SAP Program Information . . . . . . . . . . . . 460
Table of Contents xiii
14. Applying Default Connection Attributes . . . . . . . . . . . . . . . . . . . . . . . 461
Resolving Object Conflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
Using the Deployment Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Deployment Control File Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Deployment Control File Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
Deploying the Latest Version of a Folder . . . . . . . . . . . . . . . . . . . . . . . 468
Deploying the Latest Version of a Deployment Group . . . . . . . . . . . . . 468
Listing Multiple Source and Target Folders . . . . . . . . . . . . . . . . . . . . . 469
Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
xiv Table of Contents
15. List of Tables
Table 1-1. Syntax Notation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . . 3
Table 2-1. Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . . 6
Table 2-2. pmpasswd Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 16
Table 3-1. AddAlertUser Options and Arguments . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 22
Table 3-2. AddDomainLink Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 24
Table 3-3. AddDomainNode Options and Arguments . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 26
Table 3-4. AddGroupPermission Options and Arguments . . . . . . . . . . . . . . . . . .. . . .. . .. . . 28
Table 3-5. AddGroupPrivilege Options and Arguments . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 30
Table 3-6. AddLicense Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 32
Table 3-7. AddNodeResource Options and Arguments . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 34
Table 3-8. AddRolePrivilege Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 36
Table 3-9. AddServiceLevel Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 38
Table 3-10. AddUserPermission Options and Arguments . . . . . . . . . . . . . . . . . .. . . .. . .. . . 40
Table 3-11. AddUserPrivilege Options and Arguments . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 42
Table 3-12. AddUserToGroup Options and Arguments . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 44
Table 3-13. AssignedToLicense Options and Arguments . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 46
Table 3-14. AssignISToMMService Options and Arguments . . . . . . . . . . . . . . . .. . . .. . .. . . 47
Table 3-15. AssignLicense Options and Arguments . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 49
Table 3-16. AssignRoleToGroup Options and Arguments . . . . . . . . . . . . . . . . . .. . . .. . .. . . 51
Table 3-17. AssignRoleToUser Options and Arguments . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 53
Table 3-18. AssignRSToWSHubService Options and Arguments . . . . . . . . . . . .. . . .. . .. . . 55
Table 3-19. BackupDARepositoryContents Options and Arguments . . . . . . . . . .. . . .. . .. . . 57
Table 3-20. ConvertLogFile Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 59
Table 3-21. CreateDARepositoryContents Options and Arguments . . . . . . . . . . .. . . .. . .. . . 60
Table 3-22. CreateFolder Options and Arguments . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 62
Table 3-23. CreateGrid Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 64
Table 3-24. CreateGroup Options and Arguments . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 66
Table 3-25. CreateIntegrationService Options and Arguments . . . . . . . . . . . . . .. . . .. . .. . . 68
Table 3-26. Integration Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 71
Table 3-27. Integration Service Process Options . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 75
Table 3-28. CreateMMService Options and Arguments . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 77
Table 3-29. Metadata Manager Service Options . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 78
Table 3-30. CreateOSProfile Options and Arguments . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 81
Table 3-31. Integration Service Process Options for Operating System Profiles . .. . . .. . .. . . 83
Table 3-32. CreateReportingService Options and Arguments . . . . . . . . . . . . . . .. . . .. . .. . . 84
Table 3-33. Reporting Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 86
Table 3-34. Reporting Source Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 87
Table 3-35. Lineage Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 88
Table 3-36. CreateRepositoryService Options and Arguments . . . . . . . . . . . . . . .. . . .. . .. . . 89
Table 3-37. Repository Service Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . 91
List of Tables xv
16. Table 3-38. CreateRole Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . . 93
Table 3-39. CreateSAPBWService Options and Arguments . . . . . .. . . .. . .. . . .. . . .. . .. . . 95
Table 3-40. SAP BW Service Options . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . . 97
Table 3-41. SAP BW Service Process Option . . . . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . . 98
Table 3-42. CreateUser Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . . 99
Table 3-43. CreateWSHubService Options and Arguments . . . . . .. . . .. . .. . . .. . . .. . .. . .102
Table 3-44. Web Services Hub Options . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .104
Table 3-45. DeleteDARepositoryUsers Options and Arguments . .. . . .. . .. . . .. . . .. . .. . .106
Table 3-46. DisableNodeResource Options and Arguments . . . . .. . . .. . .. . . .. . . .. . .. . .107
Table 3-47. DisableService Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .109
Table 3-48. DisableServiceProcess Options and Arguments . . . . .. . . .. . .. . . .. . . .. . .. . .111
Table 3-49. DisableUser Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .113
Table 3-50. EditUser Options and Arguments . . . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .115
Table 3-51. EnableNodeResource Options and Arguments . . . . . .. . . .. . .. . . .. . . .. . .. . .117
Table 3-52. EnableService Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .119
Table 3-53. EnableServiceProcess Options and Arguments . . . . . .. . . .. . .. . . .. . . .. . .. . .120
Table 3-54. EnableUser Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .121
Table 3-55. ExportUsersAndGroups Options and Arguments . . . .. . . .. . .. . . .. . . .. . .. . .123
Table 3-56. GetFolderInfo Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .125
Table 3-57. GetLastError Options and Arguments . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .126
Table 3-58. GetLog Options and Arguments . . . . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .128
Table 3-59. GetServiceOption Options and Arguments . . . . . . . .. . . .. . .. . . .. . . .. . .. . .132
Table 3-60. GetServiceProcessOption Options and Arguments . . .. . . .. . .. . . .. . . .. . .. . .134
Table 3-61. GetServiceProcessStatus Options and Arguments . . . .. . . .. . .. . . .. . . .. . .. . .136
Table 3-62. GetServiceStatus Options and Arguments . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .138
Table 3-63. GetSessionLog Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .139
Table 3-64. GetWorkflowLog Options and Arguments . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .142
Table 3-65. Help Option and Argument . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .145
Table 3-66. ImportUsersAndGroups Options and Arguments . . . .. . . .. . .. . . .. . . .. . .. . .146
Table 3-67. ListAlertUsers Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .148
Table 3-68. ListAllGroups Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .149
Table 3-69. ListAllRoles Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .150
Table 3-70. ListAllUsers Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .151
Table 3-71. ListDomainLinks Options and Arguments . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .152
Table 3-72. ListDomainOptions Options and Arguments . . . . . . .. . . .. . .. . . .. . . .. . .. . .153
Table 3-73. ListFolders Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .154
Table 3-74. ListGridNodes Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .155
Table 3-75. ListGroupPrivileges Options and Arguments . . . . . . .. . . .. . .. . . .. . . .. . .. . .156
Table 3-76. ListLDAPConnectivity Options and Arguments . . . . .. . . .. . .. . . .. . . .. . .. . .158
Table 3-77. ListLicenses Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .159
Table 3-78. ListNodeOptions Options and Arguments . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .160
Table 3-79. ListNodeResources Options and Arguments . . . . . . .. . . .. . .. . . .. . . .. . .. . .161
Table 3-80. ListOSProfile Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . . .. . .. . .162
xvi List of Tables
17. Table 3-81. ListRepositoryLDAPConfiguration Options and Arguments . . . .. . .. . . .. . .. . 163
Table 3-82. ListRolePrivileges Options and Arguments . . . . . . . . . . . . . . . .. . .. . . .. . .. . 165
Table 3-83. ListSecurityDomains Options and Arguments . . . . . . . . . . . . . .. . .. . . .. . .. . 167
Table 3-84. ListServiceLevels Options and Arguments . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 168
Table 3-85. ListServiceNodes Options and Arguments . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 169
Table 3-86. ListServicePrivileges Options and Arguments . . . . . . . . . . . . . . .. . .. . . .. . .. . 170
Table 3-87. ListServices Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 171
Table 3-88. ListSMTPOptions Options and Arguments . . . . . . . . . . . . . . . .. . .. . . .. . .. . 172
Table 3-89. ListUserPrivileges Options and Arguments . . . . . . . . . . . . . . . .. . .. . . .. . .. . 173
Table 3-90. MoveFolder Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 175
Table 3-91. MoveObject Options and Arguments . . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 176
Table 3-92. Ping Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 178
Table 3-93. PurgeLog Options and Arguments . . . . . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 179
Table 3-94. RemoveAlertUser Options and Arguments . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 181
Table 3-95. RemoveDomainLink Options and Arguments . . . . . . . . . . . . . .. . .. . . .. . .. . 182
Table 3-96. RemoveFolder Options and Arguments . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 183
Table 3-97. RemoveGrid Options and Arguments . . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 184
Table 3-98. RemoveGroup Options and Arguments . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 185
Table 3-99. RemoveGroupPrivilege Options and Arguments . . . . . . . . . . . . .. . .. . . .. . .. . 186
Table 3-100. RemoveLicense Options and Arguments . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 188
Table 3-101. RemoveNode Options and Arguments . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 189
Table 3-102. RemoveNodeResource Options and Arguments . . . . . . . . . . . .. . .. . . .. . .. . 190
Table 3-103. RemoveOSProfile Options and Arguments . . . . . . . . . . . . . . . .. . .. . . .. . .. . 192
Table 3-104. RemoveRole Options and Arguments . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 193
Table 3-105. RemoveRolePrivilege Options and Arguments . . . . . . . . . . . . .. . .. . . .. . .. . 194
Table 3-106. RemoveService Options and Arguments . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 196
Table 3-107. RemoveServiceLevel Options and Arguments . . . . . . . . . . . . . .. . .. . . .. . .. . 197
Table 3-108. RemoveUser Options and Arguments . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 198
Table 3-109. RemoveUserFromGroup Options and Arguments . . . . . . . . . . .. . .. . . .. . .. . 199
Table 3-110. RemoveUserPrivilege Options and Arguments . . . . . . . . . . . . .. . .. . . .. . .. . 201
Table 3-111. ResetPassword Options and Arguments . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 203
Table 3-112. RestoreDARepositoryContents Options and Arguments . . . . . .. . .. . . .. . .. . 205
Table 3-113. RunCPUProfile Options and Arguments . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 207
Table 3-114. SetLDAPConnectivity Options and Arguments . . . . . . . . . . . .. . .. . . .. . .. . 208
Table 3-115. SetRepositoryLDAPConfiguration Options and Arguments . . .. . .. . . .. . .. . 210
Table 3-116. ShowLicense Options and Arguments . . . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 213
Table 3-117. ShutdownNode Options and Arguments . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 214
Table 3-118. SwitchToGatewayNode Options and Arguments . . . . . . . . . . .. . .. . . .. . .. . 215
Table 3-119. SwitchToWorkerNode Options and Arguments . . . . . . . . . . . .. . .. . . .. . .. . 216
Table 3-120. UnassignISMMService Options and Arguments . . . . . . . . . . . .. . .. . . .. . .. . 217
Table 3-121. UnassignLicense Options and Arguments . . . . . . . . . . . . . . . . .. . .. . . .. . .. . 219
Table 3-122. UnassignRoleFromGroup Options and Arguments . . . . . . . . . .. . .. . . .. . .. . 221
Table 3-123. UnassignRoleFromUser Options and Arguments . . . . . . . . . . .. . .. . . .. . .. . 223
List of Tables xvii
18. Table 3-124. UnassignRSWSHubService Options and Arguments . . . . . . . . . . . . . . . . . . . . . .225
Table 3-125. UnassociateDomainNode Options and Arguments . . . . . . . . . . . . . . . . . . . . . . .227
Table 3-126. UpdateDomainOptions Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . .229
Table 3-127. UpdateDomainPassword Options and Arguments . . . . . . . . . . . . . . . . . . . . . . .231
Table 3-128. UpdateFolder Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232
Table 3-129. UpdateGatewayInfo Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . .233
Table 3-130. UpdateGrid Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
Table 3-131. UpdateIntegrationService Options and Arguments . . . . . . . . . . . . . . . . . . . . . . .235
Table 3-132. UpdateLicense Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
Table 3-133. UpdateMMService Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
Table 3-134. UpdateNodeOptions Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . .241
Table 3-135. UpdateOSProfile Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243
Table 3-136. UpdateReportingService Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . .245
Table 3-137. UpdateRepositoryService Options and Arguments . . . . . . . . . . . . . . . . . . . . . . .247
Table 3-138. UpdateSAPBWService Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . .249
Table 3-139. UpdateServiceLevel Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . .251
Table 3-140. UpdateServiceProcess Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . .253
Table 3-141. UpdateSMTPOptions Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . .255
Table 3-142. UpdateWSHubService Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . .257
Table 3-143. UpgradeDARepositoryContents Options and Arguments . . . . . . . . . . . . . . . . . .259
Table 3-144. UpgradeDARepositoryUsers Options and Arguments . . . . . . . . . . . . . . . . . . . . .260
Table 4-1. Database Connection String Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
Table 4-2. BackupDomain Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .267
Table 4-3. DefineDomain Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269
Table 4-4. DefineGatewayNode Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . .273
Table 4-5. DefineWorkerNode Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .276
Table 4-6. DeleteDomain Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .278
Table 4-7. Help Option and Argument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280
Table 4-8. RestoreDomain Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .282
Table 4-9. UpdateGatewayNode Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . .284
Table 4-10. UpdateWorkerNode Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . .286
Table 5-1. pmcmd Return Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291
Table 5-2. Setting Defaults for Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .293
Table 5-3. aborttask Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .296
Table 5-4. abortworkflow Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299
Table 5-5. connect Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301
Table 5-6. getrunningsessionsdetails Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . .305
Table 5-7. getservicedetails Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
Table 5-8. getserviceproperties Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .309
Table 5-9. getsessionstatistics Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
Table 5-10. gettaskdetails Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313
Table 5-11. getworkflowdetails Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316
Table 5-12. help Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .318
xviii List of Tables
19. Table 5-13. pingservice Options and Arguments . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 319
Table 5-14. recoverworkflow Options and Arguments . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 320
Table 5-15. scheduleworkflow Options and Arguments . . . . . . . . . . . .. . . .. . .. . . .. . .. . 323
Table 5-16. setfolder Option and Argument . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 325
Table 5-17. starttask Options and Arguments . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 329
Table 5-18. startworkflow Options and Arguments . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 332
Table 5-19. stoptask Options and Arguments . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 336
Table 5-20. stopworkflow Options and Arguments . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 339
Table 5-21. unscheduleworkflow Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . .. . 341
Table 5-22. waittask Options and Arguments . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 345
Table 5-23. waitworkflow Options and Arguments . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 347
Table 6-1. Native Connect String Syntax . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 352
Table 6-2. AddToDeploymentGroup Options and Arguments . . . . . . .. . . .. . .. . . .. . .. . 354
Table 6-3. ApplyLabel Options and Arguments . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 356
Table 6-4. AssignPermission Options and Arguments . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 358
Table 6-5. Query and Connection Subtypes . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 359
Table 6-6. Backup Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 360
Table 6-7. ChangeOwner Options and Arguments . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 361
Table 6-8. CheckIn Options and Arguments . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 362
Table 6-9. ClearDeploymentGroup Options and Arguments . . . . . . . . .. . . .. . .. . . .. . .. . 364
Table 6-10. Connect Options and Arguments . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 365
Table 6-11. Create Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 367
Table 6-12. CreateConnection Options and Arguments . . . . . . . . . . . .. . . .. . .. . . .. . .. . 369
Table 6-13. Database Type Strings . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 371
Table 6-14. CreateDeploymentGroup Options and Arguments . . . . . . .. . . .. . .. . . .. . .. . 372
Table 6-15. CreateFolder Options and Arguments . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 373
Table 6-16. CreateLabel Options and Arguments . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 375
Table 6-17. Delete Options and Arguments . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 376
Table 6-18. DeleteConnection Options and Arguments . . . . . . . . . . . .. . . .. . .. . . .. . .. . 377
Table 6-19. DeleteDeploymentGroup Options and Arguments . . . . . . .. . . .. . .. . . .. . .. . 378
Table 6-20. DeleteFolder Option and Argument . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 379
Table 6-21. DeleteLabel Options and Arguments . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 380
Table 6-22. DeleteObject Options and Arguments . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 381
Table 6-23. DeployDeploymentGroup Options and Arguments . . . . . .. . . .. . .. . . .. . .. . 382
Table 6-24. DeployFolder Options and Arguments . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 384
Table 6-25. ExecuteQuery Options and Arguments . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 386
Table 6-26. FindCheckout Options and Arguments . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 389
Table 6-27. GetConnectionDetails Options and Arguments . . . . . . . . .. . . .. . .. . . .. . .. . 391
Table 6-28. KillUserConnection Options and Arguments . . . . . . . . . . .. . . .. . .. . . .. . .. . 393
Table 6-29. ListConnections Option . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 394
Table 6-30. ListGroupsForUser Option and Argument . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 395
Table 6-31. ListObjectDependencies Options and Arguments . . . . . . . .. . . .. . .. . . .. . .. . 396
Table 6-32. ListObjects Options and Arguments . . . . . . . . . . . . . . . . .. . . .. . .. . . .. . .. . 400
List of Tables xix
20. Table 6-33. Object Types and Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .401
Table 6-34. Transformation and Task Types to Use with pmrep . . . . . . . . . . . . . . . . . . . . . . .402
Table 6-35. ListTablesBySess Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405
Table 6-36. ModifyFolder Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .408
Table 6-37. Notify Option and Argument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .410
Table 6-38. ObjectExport Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .411
Table 6-39. ObjectImport Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .413
Table 6-40. PurgeVersion Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .415
Table 6-41. Register Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .417
Table 6-42. RegisterPlugin Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .419
Table 6-43. Restore Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .421
Table 6-44. RollbackDeployment Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . .423
Table 6-45. Run Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .424
Table 6-46. SwitchConnection Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .426
Table 6-47. TruncateLog Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .427
Table 6-48. UndoCheckout Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .428
Table 6-49. Unregister Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .429
Table 6-50. UnregisterPlugin Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .431
Table 6-51. UpdateConnection Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . .433
Table 6-52. UpdateEmailAddr Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .435
Table 6-53. UpdateSeqGenVals Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . .436
Table 6-54. UpdateSrcPrefix Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .438
Table 6-55. UpdateTargPrefix Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . .440
Table 6-56. Upgrade Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .441
Table 6-57. Validate Options and Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .443
Table 7-1. Object Import Control File Elements and Attributes . . . . . . . . . . . . . . . . . . . . . . .453
Table 7-2. Object Types for OBJECTTYPENAME Attribute . . . . . . . . . . . . . . . . . . . . . . . . .454
Table 7-3. Object Import Control File Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .455
Table 7-4. Deployment Control File Elements and Attributes . . . . . . . . . . . . . . . . . . . . . . . . .464
xx List of Tables
21. Preface
The Command Line Reference is written for PowerCenter administrators and developers who
manage the repositories and administer the domain and services. This guide assumes you have
knowledge of the operating systems in your environment. This guide also assumes you are
familiar with the interface requirements for the supporting applications.
xxi
22. Informatica Resources
Informatica Customer Portal
As an Informatica customer, you can access the Informatica Customer Portal site at
http://my.informatica.com. The site contains product information, user group information,
newsletters, access to the Informatica customer support case management system (ATLAS),
the Informatica Knowledge Base, Informatica Documentation Center, and access to the
Informatica user community.
Informatica Web Site
You can access the Informatica corporate web site at http://www.informatica.com. The site
contains information about Informatica, its background, upcoming events, and sales offices.
You will also find product and partner information. The services area of the site includes
important information about technical support, training and education, and implementation
services.
Informatica Knowledge Base
As an Informatica customer, you can access the Informatica Knowledge Base at
http://my.informatica.com. Use the Knowledge Base to search for documented solutions to
known technical issues about Informatica products. You can also find answers to frequently
asked questions, technical white papers, and technical tips.
Informatica Global Customer Support
There are many ways to access Informatica Global Customer Support. You can contact a
Customer Support Center through telephone, email, or the WebSupport Service.
Use the following email addresses to contact Informatica Global Customer Support:
♦ support@informatica.com for technical inquiries
♦ support_admin@informatica.com for general customer service requests
WebSupport requires a user name and password. You can request a user name and password at
http://my.informatica.com.
xxii Preface
23. Use the following telephone numbers to contact Informatica Global Customer Support:
North America / South America Europe / Middle East / Africa Asia / Australia
Informatica Corporation Informatica Software Ltd. Informatica Business Solutions
Headquarters 6 Waltham Park Pvt. Ltd.
100 Cardinal Way Waltham Road, White Waltham Diamond District
Redwood City, California Maidenhead, Berkshire Tower B, 3rd Floor
94063 SL6 3TN 150 Airport Road
United States United Kingdom Bangalore 560 008
India
Toll Free Toll Free Toll Free
+1 877 463 2435 00 800 4632 4357 Australia: 1 800 151 830
Singapore: 001 800 4632 4357
Standard Rate Standard Rate Standard Rate
United States: +1 650 385 5800 Belgium: +32 15 281 702 India: +91 80 4112 5738
France: +33 1 41 38 92 26
Germany: +49 1805 702 702
Netherlands: +31 306 022 797
United Kingdom: +44 1628 511 445
Preface xxiii
25. Chapter 1
Using the Command Line
Programs
This chapter includes the following topic:
♦ Overview, 2
1
26. Overview
PowerCenter includes command line programs that you use to perform tasks from any
machine in the PowerCenter environment. The command line programs allow you to run a
subset of tasks that you can complete in the Administration Console. For example, you can
enable or disable a Repository Service from the Administration Console or the command line
program, infacmd.
PowerCenter includes the following command line programs:
♦ infacmd. Use infacmd to access the PowerCenter application services. For more
information about infacmd, see “infacmd Command Reference” on page 19.
♦ infasetup. Use infasetup to perform installation tasks such as defining a node or a domain.
For more information about infasetup, “infasetup Command Reference” on page 263.
♦ pmcmd. Use pmcmd to manage workflows. You can start, stop, schedule, and monitor
workflows using pmcmd. For more information about pmcmd, see “pmcmd Command
Reference” on page 289.
♦ pmrep. Use pmrep to perform repository administration tasks such as listing repository
objects, creating and editing groups, and restoring and deleting repositories. For more
information about pmrep, see “pmrep Command Reference” on page 349.
To run command line programs on UNIX, you may need to set the library path environment
variable to the location of the PowerCenter utilities.
For ease of use, you can configure environment variables that apply each time you run the
command line programs. For example, you can set an environment variable for the default
domain name, user, and password to avoid typing the options at the command line. For more
information about environment variables, see “Configuring Environment Variables” on
page 5.
Entering Options and Arguments
Each command line program requires a set of options and arguments. These include user
name, password, domain name, and connection information.
Use the following rules when you enter command options and arguments:
♦ To enter options, type a hyphen followed by one letter, two letters, or a word, depending
on the command line program syntax.
For example, the pmrep Connect command uses a single letter option for the repository
name:
connect -r <repository_name>
♦ Enter options in any order.
♦ The first word after the option is the argument.
♦ Most options require arguments. You must separate options from arguments with a single
space when using pmcmd or infacmd. You do not have to separate options from arguments
when using pmrep.
2 Chapter 1: Using the Command Line Programs
27. ♦ If any argument contains more than one word, enclose the argument in double quotes. For
pmcmd, you can also use single quotes. The command line programs ignore quotes that do
not enclose an argument. Unmatched quotes result in an error.
Syntax Notation
Table 1-1 describes the notation used in this book to show the syntax for all PowerCenter
command line programs:
Table 1-1. Syntax Notation
Convention Description
-x Option placed before a argument. This designates the parameter you enter. For
example, to enter the user name for pmcmd, type -u or -user followed by the user name.
<x> Required option. If you omit a required option, the command line program returns an
error message.
<x | y > Select between required options. For the command to run, you must select from the
listed options. If you omit a required option, the command line program returns an error
message.
{x | y} In pmrep, curly brackets denote groupings of required options, as in the following
example:
killuserconnection
{-i <connection_id> |
-n <user_name> |
-a (kill all)}
If a pipe symbol ( | ) separates options, you must specify exactly one option. If options
are not separated by pipe symbols, you must specify all the options.
[x] Optional parameter. The command runs whether or not you enter optional parameters.
For example, the help command has the following syntax:
Help [Command]
If you enter a command, the command line program returns information on that
command only. If you omit the command name, the command line program returns a list
of all commands.
[x|y] Select between optional parameters. For example, many commands in pmcmd run in
either the wait or nowait mode.
[-wait|-nowait]
If you specify a mode, the command runs in the specified mode.
The command runs whether or not you enter the optional parameter. If you do not
specify a mode, pmcmd runs the command in the default nowait mode.
<< x | y>| <a | b>> When a set contains subsets, the superset is indicated with bold brackets < >. A bold
pipe symbol (|) separates the subsets.
(text) In pmrep, parentheses surround descriptive text, such as the list of the possible values
for an argument or an explanation for an option that does not take an argument.
Overview 3
28. 4 Chapter 1: Using the Command Line Programs
29. Chapter 2
Configuring Environment
Variables
This chapter includes the following topics:
♦ Overview, 6
♦ INFA_CLIENT_RESILIENCE_TIMEOUT, 8
♦ INFA_CODEPAGENAME, 9
♦ INFA_DEFAULT_DATABASE_PASSWORD, 10
♦ INFA_DEFAULT_DOMAIN, 11
♦ INFA_DEFAULT_DOMAIN_PASSWORD, 12
♦ INFA_DEFAULT_DOMAIN_USER, 13
♦ INFA_REPCNX_INFO, 14
♦ INFATOOL_DATEFORMAT, 15
♦ Encrypting Passwords, 16
♦ Setting the User Name, 18
5
30. Overview
You can configure environment variables for the command line programs. For example, you
can set environment variables to encrypt passwords, configure time and date display options,
or store the default login information for a domain. The environment variables you configure
are all optional. If you are running pmcmd or pmrep in interactive mode, you must exit from
the command line program and then reconnect to use changed environment variables.
On Windows, you can configure these environment variables as either user or system
variables. For information about setting environment variables on Windows, consult the
Windows documentation.
Table 2-1 describes environment variables you can configure to use with the command line
programs:
Table 2-1. Environment Variables
Command
Environment Variable Line Description
Programs
INFA_CLIENT_RESILIENCE_TIMEOUT infacmd Limits the number of seconds you want the command
pmcmd line programs to spend establishing a connection to the
pmrep domain or service. For more information, see
“INFA_CLIENT_RESILIENCE_TIMEOUT” on page 8.
INFA_CODEPAGENAME pmcmd Configures the character set pmcmd and pmrep use.
pmrep For more information, see “INFA_CODEPAGENAME”
on page 9.
INFA_DEFAULT_DATABASE_PASSWORD infasetup Stores the default user name password for the domain
configuration database. For more information, see
“INFA_DEFAULT_DATABASE_PASSWORD” on
page 10.
INFA_DEFAULT_DOMAIN infacmd Stores the default domain name. For more information,
pmcmd see “INFA_DEFAULT_DOMAIN” on page 11.
pmrep
INFA_DEFAULT_DOMAIN_PASSWORD infacmd Stores the default user name password for the domain.
For more information, see
“INFA_DEFAULT_DOMAIN_PASSWORD” on page 12.
INFA_DEFAULT_DOMAIN_USER infacmd Stores the default user name for the domain. For more
information, see “INFA_DEFAULT_DOMAIN_USER” on
page 13.
INFA_REPCNX_INFO pmrep Stores the name of the repository connection file. For
more information, see “INFA_REPCNX_INFO” on
page 14.
INFATOOL_DATEFORMAT pmcmd Configures the way pmcmd displays the date and time.
For more information, see “INFATOOL_DATEFORMAT”
on page 15.
6 Chapter 2: Configuring Environment Variables
31. Table 2-1. Environment Variables
Command
Environment Variable Line Description
Programs
<Password_Environment_Variable> pmcmd Encrypts and stores the password. For more
pmrep information, see “Encrypting Passwords” on page 16.
<User_Name_Environment_Variable> pmcmd Stores the user name. For more information, see
pmrep “Setting the User Name” on page 18.
Overview 7
32. INFA_CLIENT_RESILIENCE_TIMEOUT
Command Line Programs:
infacmd
pmcmd
pmrep
You can set the environment variable INFA_CLIENT_RESILIENCE_TIMEOUT to limit
the number of seconds the command line programs spend establishing connections to the
domain or service. The default time is 180 seconds if you do not set this environment
variable.
To configure INFA_CLIENT_RESILIENCE_TIMEOUT on UNIX:
In a UNIX C shell environment, type:
setenv INFA_CLIENT_RESILIENCE_TIMEOUT <number of seconds>
In a UNIX Bourne shell environment, type:
INFA_CLIENT_RESILIENCE_TIMEOUT = <number of seconds>
export INFA_CLIENT_RESILIENCE_TIMEOUT
To configure INFA_CLIENT_RESILIENCE_TIMEOUT on Windows:
Enter the environment variable INFA_CLIENT_RESILIENCE_TIMEOUT, and set the
value to the number of seconds you want the command line programs to spend
establishing a connection to the domain or service.
For information about setting environment variables on Windows, consult the Windows
documentation.
8 Chapter 2: Configuring Environment Variables