Ts 671sp1 CLT Win v01 en

TeamSite ®
Command-Line Tools
Release 6.7.1
Service Pack 1
Windows®
© 1999-2007 Interwoven, Inc. All rights reserved.
No part of this publication (hardcopy or electronic form) may be reproduced or transmitted, in any form
or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior
written consent of Interwoven. Information in this manual is furnished under license by Interwoven, Inc.
and may only be used in accordance with the terms of the license agreement. If this software or
documentation directs you to copy materials, you must first have permission from the copyright owner
of the materials to avoid violating the law which could result in damages or other remedies.
Interwoven, ConfirmSite, ContentServices, ControlHub, DataDeploy, DeskSite, FileSite, iManage,

LiveSite, MediaBin, MetaCode, MetaTagger, OffSite, OpenDeploy, Primera, Scrittura, TeamPortal,
TeamSite, VisualAnnotate, WorkDocs, WorkPortal, WorkRoute, WorkSite, WorkTeam, the respective
taglines, logos and service marks are trademarks of Interwoven, Inc., which may be registered in certain
jurisdictions. All other trademarks are owned by their respective owners. Some or all of the information
contained herein may be protected by patent numbers: US # 6,505,212, GBRI # 1053523, US #
6,480,944, US# 5,845,270, US #5,430,812, US #5,754,704, US #5,347,600, AUS #735365, AU
7830068, GB #GB2333619, US #5,845,067, US #6,675,299, US #5,835,037, AUS #632333, CAN
#2,062,965, FRAN / GRBI / SPAI / SWED #480941, GERM #69020564.3, KORS 10-0576487, JAPA
#2968582, MX #219522, NZ #516340, SING #109524, SG #89006, SG #89086, SG #74973, SG
#85502 US #5,065,447, US #6,609,184, US #6,141,017, US #5,990,950, US #5,821,999, US
#5,805,217, US #5,838,832, US #5,867,221, US #5,923,376, US #6,434,273, US #5,867,603, US
#4,941,193, US #5,822,721, US #5,923,785, US #5,982,938, US #5,790,131, US #5,721,543, US
#5,982,441, US #5,857,036, US #6,697,532, US #6,792, 454, US #6,928,149, US #7,092,969 or other
patents pending application for Interwoven, Inc.
Interwoven, Inc.
160 East Tasman Drive
San Jose, CA 95134
http://www.interwoven.com
Printed in the United States of America
TeamSite Command-Line Tools

Part 01-008-01-EN
August 2007
Table of Contents
About This Book 9
How This Manual is Organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Notation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Chapter 1: Overview of CLTs and Command Triggers 11
CLTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Administration Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
Development Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
Command Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Before Using CLTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Version Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Relative vpaths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
Directory Paths. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Executing CLTs Remotely . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Object IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Class IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Specifying Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
CLT Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Chapter 2: Administration Tools 19
System Information Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
System Services Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Content Store Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
iwabort.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
iwaccess.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
iwaccessmigrate.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
iwadduser.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
iwancestor.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
iwchgrp.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
iwconfig.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
iwconfigtsreport.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
iwconvertserver.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
iwfreeze.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
iwfsck.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
iwfsfix.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
iwfsshrink.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
iwgetelog.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
iwgetfilejobs.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
iwgethome.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
iwgetlocation.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
iwgetmount.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
iwgetstore.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
iwgettrace.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
iwgroup.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
TeamSite Command-Line Tools 3

Contents
iwidmap.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
iwmigrate.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
iwprefconv.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67
iwproxy.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
iwrecentusers.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
iwreset.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
iwrmuser.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
iwroleadm.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
iwsi.ipl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
iwstat.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
iwstoreadm.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
iwteamsite.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
iwtestcfg.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
iwtock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
iwuser.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
iwuseradm.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
iwutildreset.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
iwutildstat.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
iwversion.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Chapter 3: Development Tools 95
General Development Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
Branch Operation Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Edition Operation Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
Workarea Operation Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
Version Management Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
Workflow and Job Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
Search and Index Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
iwaddtaskfile.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
iwaddtaskgroup.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
iwaddtaskuser.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
iwattrib.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
iwauthen.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
iwcallback.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
iwcat.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
iwckrole.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
iwcmp.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
iwcp.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
iwdecode.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
iwdeltaskfile.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
iwencode.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
iwevents.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
iwextattr.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
iwfilestate.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
iwgeteventcomments.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
iwgeteventfiles.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133
iwgettaskbyname.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134
iwgetwfobj.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
iwinvokejob.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136
iwjobc.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
Interwoven, Inc. 4
Contents
iwjobvariable.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
iwlasted.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
iwldapmigrate.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140
iwldapsearch.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142
iwldapsync.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
iwlist.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
iwlistlocks.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
iwlistmod.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150
iwlock.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151
iwlockinfo.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152
iwmerge.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153
iwmkbr.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154
iwmkwa.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155
iwmvtaskfile.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156
iwndxaddbr.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157
iwndxfreezebr.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
iwndxlistbr.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
iwndxmgrfreeze.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
iwndxmgrstatus.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161
iwndxmgrstop.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162
iwndxpurgebr.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
iwndxrefreshbr.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
iwndxrmbr.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
iwndxstatus.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
iwndxwamodificationsbr.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
iwnexted.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
iwprop.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170
iwprv.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172
iwpublish.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
iwqueryjobs.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
iwquerytasks.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175
iwrename.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
iwretryjobop.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178
iwrevert.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179
iwrlog.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
iwrmbr.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
iwrmed.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
iwrmjob.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .184
iwrmtaskfile.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
iwrmtaskgroup.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186
iwrmtaskuser.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187
iwrmwa.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188
iwsetjobdescription.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
iwsetjobowner.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190
iwsettaskattrib.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191
iwsettaskcomment.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192
iwsettaskdescription.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193
iwsettaskfilecomment.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194
iwsettaskownerandarea.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195
iwsettasktimeout.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196

Contents
iwsrchattrib.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197
iwsrchgethome.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
iwsrchgetpage.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
iwsrchmgrping.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
iwsrchmgrstop.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204
iwsrchndxstatus.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
iwsrchndxstatuschg.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
iwsrchquery.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
iwsubmit.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
iwtaketask.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
iwtaskselect.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
iwtaskvariable.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
iwundochoice.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
iwunlock.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
iwuntaketask.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
iwupdate.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218
iwvpath.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219
Chapter 4: Command Triggers 221
Starting Command Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222
Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
iwat.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226
iwatcreate.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
iwatlock.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
iwatmkbr.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
iwatmkwa.ipl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
iwatpub.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231
iwatrmbr.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232
iwatrmed.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
iwatrmwa.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
iwatserver.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235
iwatsub.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236
iwatunlock.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
iwatupdate.ipl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
iwlsat.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
iwrmat.exe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .240
Appendix A: Master List 241
Appendix B: Sample Command Trigger Scripts 249
Email Notification Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
Replication Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254
Appendix C: Error Codes 259
Appendix D: Search Query Schemas 269
BaseQueryLanguage.xsd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269
FullTextQueryElements.xsd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274
TeamSiteSearch.xsd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .278
Index 281
Interwoven, Inc. 6
List of Tables
Table 1 Notation conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Table 2 System information tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Table 3 System services tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Table 4 Content Store tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Table 5 General development tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Table 6 Branch operation tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Table 7 Edition operation tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Table 8 Workarea operation tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Table 9 Version management tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Table 10 Workflow and job tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Table 11 Search and index tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Table 12 Server attribute values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Table 13 Archive attribute values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Table 14 Branch attribute values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Table 15 Edition attribute values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Table 16 Workarea attribute values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Table 17 Submit event attribute values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Table 18 Update event attribute values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Table 19 Staging area attribute values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Table 20 File and directory attribute values . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Table 21 Query expressions and elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Table 22 Command trigger tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Table 23 Command triggers and TeamSite events . . . . . . . . . . . . . . . . . . . . . . . 224
Table 24 CLT alphabetized master list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Table 25 CLT error codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

List of Tables
Interwoven, Inc. 8
About This Book
TeamSite Command-Line Tools describes each TeamSite command-line tool (CLT) and
®
command trigger, including syntax and usage examples. It is intended primarily for
TeamSite Administrators and Master users, and for Web server administrators and
system administrators. Users of this manual should be familiar with either IIS or
Netscape web servers, and with basic Windows NT operations such as adding users and
modifying ACLs.
How This Manual is Organized

This manual is organized as follows:
Chapter 1, “Overview of CLTs and Command Triggers.” Describes the types of
operations you can perform with CLTs and command triggers, how CLTs and
command triggers are grouped into functional categories, and the general syntax
you must use when entering information (for example, vpaths and object IDs)
common to many CLTs.
Chapter 2, “Administration Tools.” Contains man pages for the System Information,
System Services, and Content Store CLTs. All man pages in the chapter are
presented as one group, arranged alphabetically.
Chapter 3, “Development Tools.” Contains man pages for CLTs in the following
categories: General Development, Deployment, Branch Operation, Edition
Operation, Workarea Operation, Version Management, Workflow/Job, Templating,
and Search/Index. All man pages in the chapter are presented as one group, arranged
alphabetically.
Chapter 4, “Command Triggers.” Contains man pages for command triggers from
the following groups: General Events, File and Directory Events, Branch Events,
Edition Events, and Workarea Events. All man pages in the chapter are presented as
one group, arranged alphabetically.
Appendix A, “Master List.” Contains a single alphabetized list of all CLTs and
command triggers described in this manual.
Appendix B, “Sample Command Trigger Scripts.” Contains examples of scripts that
can be triggered by command triggers.
Appendix C, “Error Codes.” Lists the error codes that can be returned by CLTs.
Appendix D, “Search Query Schemas.” Contains the XML schemas used by the
TeamSite search feature.
ContentCenter Professional User’s Guide 9

About This Book
Notation Conventions
This manual uses the following notation conventions:
Table 1 Notation conventions

Convention Definition and Usage
Bold Text that appears in a GUI element (for example, a menu item,
button, or element of a dialog box) and command names are shown
in bold. For example:
Click Edit File in the Button Bar.
Italics Book titles appear in italics.
Terms are italicized the first time they are introduced.
Valuable information may be italicized for emphasis.
Monospace Commands, command-line output, and file names are in
monospace type. For example:
The iwextattr command-line tool allows you to set and look up
extended attributes on a file.
Monospaced Monospaced italics are used for command-line variables.The most
italic common example of this is iw-home, which refers to the directory
where TeamSite is installed. For example:
iw-home\etc\iw.cfg
is the path to the main TeamSite configuration file, iw.cfg, which
is located in the etc directory under the TeamSite installation
directory.
iwckrole role user
means that you must insert the values of role and user yourself.
Monospaced bold Monospaced bold represents information you enter in response to
system prompts. The character that appears before a line of user
input represents the command prompt, and should not be typed.
The> character that appears before a line of user input represents
the command prompt, and should not be typed. For example:
>iwextattr -s project=proj1
//IWSERVER/default/main/dev/WORKAREA/andre/products/inde
x.html
Monospaced bold Used to indicate a variable in response to a system prompt.
italics
[] Square brackets surrounding a command-line argument mean that
the argument is optional.
{} Curly braces surrounding a command-line argument mean that the
argument is required.
| Vertical bars separating command-line arguments mean that only
one of the arguments can be used.
Interwoven, Inc. 10
Chapter 1
Overview of CLTs and

Command Triggers
CLTs enable you to use the command line instead of the browser or file system interface
to perform most TeamSite administration and development tasks. For example,
TeamSite provides CLTs for creating and deleting branches and workareas, publishing,
deploying, assigning files, invoking the proxy server, interacting with jobs, and dozens
of other tasks. CLTs are designed for users and administrators who are comfortable
using a command-line interface, and who cannot or prefer not to use the browser or file
system interface.
In addition to CLTs, TeamSite also supports a set of command triggers that let you
configure TeamSite to execute custom scripts whenever certain events occur. For
example, you can use command triggers to execute an email notification script
whenever a file is assigned, or whenever a new branch is created, or when any of several
other supported events occur. The scripts that are triggered can be simple or complex
and typically are created by an administrator for a specific site or installation.
You should use CLTs and command triggers only if you have a good understanding of
TeamSite structure, roles, and concepts. When learning CLTs, it is often helpful to
monitor your activities using the GUI. If you choose to monitor from the GUI, be sure to
refresh your view often. In some cases, it might be helpful to run multiple TeamSite
sessions using the GUI.
The following sections briefly describe the default set of TeamSite CLTs and command
triggers.
CLTs
CLTs are organized into two main categories: administration tools and development
tools.

Chapter 1: Overview of CLTs and Command Triggers
Administration Tools
Administration tools are divided into the following categories:
System Information. Returns system-wide information or information about a
file’s location.They do not provide information about the data in a file (the
development tool CLTs provide that type of information).
System Services. Enable you to manipulate files or objects that affect the entire
TeamSite system. Typical tasks include, but are not limited to, editing configuration
files, performing system backups, and starting the proxy server.
Content Store. Enables you to perform various tasks on the Content Store,
including checking for and fixing problems, converting to and from a multiple file
system Content Store, and merging metadata files.
See Chapter 2, “Administration Tools,” for details about the CLTs in each category.
Development Tools
Development tools are divided into the following categories:
General Tools. Enable you to perform operations on, or retrieve information about,
the data in a specific file or TeamSite object.
Deployment. Enable you to you deploy a TeamSite edition to a production server.
Branch Operations. Enable you to you create and manipulate TeamSite branches.
Edition Operations. Enable you to you create and manipulate TeamSite editions.
Workarea Operations. Enable you to create and manipulate TeamSite workareas.
Version Management. Return information about file revisions and versions, and let
you manipulate specific versions of files and directories.
Workflow/Job. Enable you to control workflow and job elements such as file locks,
assignments to authors, and file approval/rejection.
Templating. Enable you to update, insert data into, and otherwise manipulate
template-based files.
Search and Index. Enable you to administer the index manager and search server,
control indexing operations on a per-branch basis, and perform various search
operations (including queries).
See Chapter 3, “Development Tools,” for details about the CLTs in each category.
Interwoven, Inc. 12
Command Triggers
All command triggers are described in Chapter 4, “Command Triggers”. Two sample
command trigger perl scripts—one that sends email notification and one that replicates
files—are shown in Appendix B, “Sample Command Trigger Scripts”.
Before Using CLTs

Most CLTs require that you specify some type of information when you invoke the
command. For example, you might have to specify an object ID or the location of a
TeamSite object, or provide some other type of information. The following sections
describe how to provide this information.
Additionally, you can enter the name of the CLT followed by -h to obtain “help” on that
CLT. The help provides a brief description of the CLT and lists the flags and options for
that CLT. You can enter the CLT name followed by -v to display version information. If
-h or -v are specified, any other flags or options entered at the same time are ignored.
Version Paths
Most CLTs require that you use a version path (vpath) to specify the location of a
branch, workarea, staging area, edition, file, or directory in TeamSite. Vpaths are used
only for items within TeamSite; all other files (for example, configuration files) must be
specified with a directory path (see “Directory Paths” on page 15). Vpaths have the
following form:
To specify a server:
//servername
For example, the default vpath for the TeamSite server is:
//IWSERVER
To specify a Content Store:

//servername/storename
For example, the default vpath for the TeamSite Content Store is:
//IWSERVER/default
To specify a branch or subbranch:

//servername/archivename{[/branchname]+}
//servername/archivename{[/branchname]+}/subbranchname
For example, the default vpath for the main branch is:
//IWSERVER/default/main

The vpath for a subbranch named dev off of the main branch would be:
//IWSERVER/default/main/dev
To specify an edition:
//servername/archivename{[/branchname]+}/EDITION/editionname
For example, the default vpath for the initial edition on the main branch is:
//IWSERVER/default/main/EDITION/INITIAL
The name of an edition on the subbranch dev would be:

//IWSERVER/default/main/dev/EDITION/ed_0001
To specify a workarea:
//servername/archivename{[/branchname]+}/WORKAREA/workareaname
For example, the vpath for a workarea named eng on the main branch would be:
//IWSERVER/default/main/WORKAREA/eng
The vpath for a workarea named qa on the subbranch dev would be:
//IWSERVER/default/main/dev/WORKAREA/qa
To specify an individual file within a workarea:

//servername/archivename{[/branchname]+}/WORKAREA/workareaname/directory-
pathname/filename
For example, the vpath for a file named logo.gif in the directory /htdocs/gifs in
workarea eng on subbranch dev would be:
//IWSERVER/default/main/dev/WORKAREA/eng/htdocs/gifs/logo.gif
Relative vpaths
Most TeamSite CLTs only require you to specify relative vpaths. For example, instead
of specifying //IWSERVER/default/main you would only need to specify main. In the
following example, if you are already in the default directory, instead of specifying:
you would only need to specify:

main/dev/WORKAREA/eng/htdocs/gifs/logo.gif
If you are in the htdocs directory of workarea eng on the main branch, you only need to
specify:
gifs/logo.gif
Interwoven, Inc. 14
Directory Paths
Some CLTs require you to specify directory paths. These are the full file system mount
directory paths of a file in TeamSite, starting from the server’s root directory. When you
use a CLT, be sure to check whether it requires a directory path or a vpath.
For example, a file whose vpath is:

would have the directory path of:

Y:\default\main\dev\WORKAREA\eng\htdocs\gifs\logo.gif
NOTE
Vpaths can use forward or back slashes, whereas directory paths use back slashes.
Executing CLTs Remotely

If the iw-home directory is visible from the client machine you can run the CLTs from
iw-home/bin without copying them into another location. The CLTs look for the
libraries relative to the directory that contains the program file. For example, if the CLTs
are in the default location (iw-home\bin), they require the NLS libraries to be located
iniw-home\lib\locale.
To run CLTs from a remote system complete the following procedure:

1. Set the environmental variables as described in the previous section.
2. Map a drive to the iw-home directory on the system where the TeamSite server is
installed.
3. Create the following string registry entry on your remote machine:
\\HKLM\Software\Interwoven\TeamSite\iw-home = iw-home
Where iw-home is the absolute path to the mapped iw-home directory. For example:
G:\Program Files\Interwoven\iw-home.
Object IDs
Some CLTs require that you specify object IDs (objids). Objids are identifiers for each
object (file, directory, workarea, staging area, edition, tag, and others) in the TeamSite
system. To find the objid for an item, use the iwattrib command (see “iwattrib.exe” on
page 105). CLTs that require an objid also require further information about the objid,
such as what type of object it describes or the area in which it resides.
Object IDs are 24-digit hexadecimal numbers, such as:

0x0000225800000000000006bb

Class IDs
Each type of object has its own class ID. Class IDs are 8-digit hexadecimal numbers,
whose values for each class are as follows.
NOTE
This is only a partial list; additional classes are included with TeamSite.
server 0x00000051
archive 0x00002020
branch 0x00002250
workarea 0x00002100
staging area 0x00002255
submit event 0x00002258
update event 0x0000225A
edition 0x00002010
file or directory 0x00001008
Specifying Comments
CLTs that use comments require them to be specified in one of two ways:
As a command option
As a required field
For example, a CLT could require a comment to be specified using an option:

iwsubmit [flags] [-c global_comment] [-i info_comment]
{vpath file_comment}+
Specify the comment using the -c option. If you do not use the -c option, the change
comment will be read from stdin. After typing the comment, type Ctrl-Z to exit.
NOTE
If you do not specify a comment, you must still type Ctrl-Z to exit.
The second way of specifying a comment is as a required field:

iwmkwa //server/archive{[/branch]+} workarea comment base_ed
[ownername [groupname]]
This method requires you to type a comment in the Comment field. If you do not want to
attach a comment, type two single quotes ( '' ) in the Comment field. If the comment
includes spaces, enclose it in a set of single quotes, for example, 'Please edit this
file.'
Interwoven, Inc. 16
CLT Location
CLTs reside in the bin subdirectory of the directory returned by the iwgethome
command. Note that not everything contained in this directory is a CLT.

Interwoven, Inc. 18
Chapter 2
Administration Tools
This chapter describes the administration CLTs from the following groups:
System Information Tools
System Services Tools
Content Store Tools
The CLTs are grouped and summarized in the following sections. Each CLT is then
presented in detail, arranged alphabetically.
System Information Tools

System Information CLTs return system-wide information or information about a file’s
location. They do not provide information about the data in a file (the Development Tool
CLTs provide that type of information). CLTs in this category are:
Table 2 System information tools

CLT Description See...
iwancestor.exe Displays the vpath of the common ancestor of the page 35
specified files.
iwgetelog.exe Displays the location of the TeamSite events log. page 48
iwgethome.exe Displays the location of TeamSite program files. page 50
iwgetlocation.exe Displays the locations of various TeamSite log and page 51
configuration files.
iwgetmount.exe Displays the location of the TeamSite mount point page 53
iwgetstore.exe Displays the location of the TeamSite Content Store. page 54
iwgettrace.exe Displays the location of TeamSite trace logs. page 55
iwrecentusers.exe Displays a list of everyone who has used TeamSite page 69
since the last time the TeamSite server was started,
and a timestamp of each user’s most recent TeamSite
operation.
iwstat.exe Displays current system activity. page 78
iwutildstat.exe Displays active iwutild server operation statistics. page 93
iwversion.exe Displays current TeamSite release information. page 94

Chapter 2: Administration Tools
System Services Tools

System Services CLTs enable you to manipulate files or objects that affect the entire
TeamSite system. Typical System Services tasks include, but are not limited to, editing
configuration files, performing system backups, setting permissions, and starting the
proxy server. CLTs in this category are:
Table 3 System services tools

iwaccess.exe Controls TeamSite user permissions. page 23
iwaccessmigrate.exe Applies user and group permission settings for page 31
configurable roles and delegated administration.
iwabort.exe Stops a current operation. page 22
iwadduser.ipl Adds a user to TeamSite role files. page 34
iwchgrp.exe Changes the group of a TeamSite workarea, branch, page 36
or FSE.
iwconfig.exe Reads or writes to the main TeamSite configuration page 37
file.
iwconfigtsreport.ipl Sets TeamSite Reporting parameters in the page 38
tsreport.xml file. Parameters include database
type, port, server, user, password, license key, and
other items.
iwfreeze.exe Freezes and unfreezes all system write operations. page 41
iwgroup.exe Administers TeamSite groups (list groups, add and page 56
delete groups or members within a group, modify
group names, and other operations).
iwprefconv.exe Copies existing homepage information from the page 67
iwprofiles directory to the entity database.
iwreset.exe Rereads TeamSite configuration files. page 70
iwrmuser.ipl Removes a user from TeamSite. page 71
iwroleadm.exe Lets you view, create, delete, and otherwise page 72
administer roles.
iwsi.ipl Collects system state data. page 72
iwteamsite.exe Installs or uninstalls the iwtock watchdog daemon. page 82
iwtestcfg.exe Displays the operation that is performed when a page 83
file is submitted.
iwtock Manipulates and displays data about the TeamSite page 84
watchdog daemon.
iwuser Lets you manipulate TeamSite user information. page 85
iwuseradm.exe Lets you add and remove TeamSite users, change page 88
user attributes, view and set user roles, and manage
some aspects of authentication.
iwutildreset.exe Resets iwutild configuration settings. page 92
Interwoven, Inc. 20
Content Store Tools

Content Store CLTs enable you to perform various tasks on the Content Store. CLTs in
this category are:
Table 4 Content Store tools

iwconvertserver.exe Supports the conversion GUI by communicating page 40
with remote TeamSite servers. You must run the
iwconvertserver process manually for the GUI to
function properly.
iwfsck.exe Diagnoses Content Store problems. page 43
iwfsfix.exe Fixes problems found by iwfsck. page 45
iwfsshrink.exe Finds and removes duplicate data in the Content page 46
Store.
iwidmap.exe Changes the mapping between the SID and the page 63
token. Can also be used to refresh the mapping
when the same names are used, but the SID has
changed.
iwmigrate.exe Similar to iwconvert except that it accepts release page 65
6.x and later Content Stores as its source. It can be
used to split a Content Store into multiple Content
Stores, or move the contents of a store to another
location without losing the history of submit events
for the editions.
iwstoreadm.exe Enables you to create, activate, and deactivate page 81
new-format Content Stores.

iwabort.exe
Provides a method for terminating a long-running server operation. The command
works on operations including submit, update, create branch, delete
branch/workarea/edition, and freeze. Before issuing iwabort, use iwstat to obtain the
identifier for the operation.
Use with submit and update operations. There are occasionally some places in
submit and update where they cannot be terminated by using iwabort. After issuing
iwabort, you may end up with some but not all the files submitted or updated.
Use with create and delete operations. The branch will not be created and may or
may not be deleted.
Man Page Group
System Services.
Usage
iwabort operation_id
operation_id The operation_id displayed by iwstat.
Example
Use iwstat to obtain the server status. Then, using the ID shown in the first column,
abort the submit operation.
>iwstat
Status: Server running
ID Thread User Duration Operation

0x24caee4b 0x13 andre 560.006 SubmitFSE 0xef70087ced505b40
0x24caee58 0xf - 0.000 RunFastVacuum
0x24caee57 0x15 chris 0.000 GetArchiveStatus
>iwabort 0x24caee4b
Interwoven, Inc. 22
iwaccess.exe
Controls TeamSite user permissions for access to files, directories, areas, branches,
Content Stores, servers, jobs, and tasks. Defines which roles one user can delegate to
another. Defines whether branches and workareas are public or private.
Man Page Group
System Services.
Usage
iwaccess -h [command] | -v
iwaccess add-permission-entry vpath -user user -role role

iwaccess add-permission-entry vpath -group group -role role
iwaccess add-windows-permission vpath -user user -perm perm [-mode

folder-mode]
iwaccess add-windows-permission vpath -group group -perm perm [-mode
folder-mode]
iwaccess add-windows-permission vpath -user user -mask advanced-perm
[-mode folder-mode]
iwaccess add-windows-permission vpath -group group -mask advanced-perm
[-mode folder-mode]
iwaccess all-operations-of-user user
iwaccess all-permission-entries
iwaccess all-permission-entries-of-user user [-verbose]
iwaccess all-roles-of-user user
iwaccess check-job-permission jobid -user user -op op
iwaccess check-permission vpath -user user -op op

iwaccess check-permission vpath -taskcontext taskid -user user -op op
iwaccess check-permission vpath -jobcontext jobid -user user -op op
iwaccess check-permission vpath -targetvpath vpath2 -user user -op op
iwaccess check-task-permission taskid -user user -op op
iwaccess clear-permission-entries vpath
iwaccess delegable-roles-of-user vpath -user user
iwaccess export-permission-entries file

iwaccess group vpath
iwaccess import-permission-entries file [-clear]
iwaccess inheritance vpath
iwaccess owner vpath
iwaccess permission-entries vpath [-modinfo] [-inherited]

[-expand-groups]
iwaccess private vpath
iwaccess remove-permission-entry vpath -user user -role role

iwaccess remove-permission-entry vpath -group group -role role
iwaccess remove-windows-permission vpath -user user -perm perm [-mode

folder-mode]
iwaccess remove-windows-permission vpath -group group -perm perm [-mode
folder-mode]
iwaccess remove-windows-permission vpath -user user -mask advanced-perm
[-mode folder-mode]
iwaccess remove-windows-permission vpath -group group -mask advanced- perm
[-mode folder-mode]
iwaccess replace-windows-permission vpath
iwaccess roles-of-user vpath -user user
iwaccess set-group vpath user
iwaccess set-inheritance vpath true|false
iwaccess set-owner vpath user
iwaccess set-private vpath true|false
iwaccess set-windows-inheritance vpath true

iwaccess set-windows-inheritance vpath false [-copy]
iwaccess windows-inheritance vpath
iwaccess windows-permission vpath -advanced
-h command Displays iwaccess usage information for

command, or general iwaccess usage information
if command is omitted.
-v Displays version.
Interwoven, Inc. 24
add-permission-e vpath Adds a permission entry to the branch, store, or

ntry -user user server specified by vpath, granting user the
-role role permission to perform the operations associated
with role.
-group group Grants permission to a group specified by group.
add-windows- vpath Adds a Windows ACL entry, specified by a
permission combination of the following arguments, to the
specified vpath.
-user user Specifies the user to receive the permission
setting.
-group group Specifies the group to receive the permission
setting.
-perm perm Specifies basic permissions. The value of perm is
either R, M, or F:
• R: Read
• M: Modify
• F: Full control
-mode Applies only to folders; specifies how
folder-mode permissions are applied to folders. The value of
folder-mode is a whole number from 1 through
7:
• 1: This folder only.
• 2: This folder, subfolders, and files. This is the
default value.
• 3: This folder and subfolders.
• 4: This folder and files.
• 5: Subfolders and files.
• 6: Subfolders only.
• 7: Files only.
-mask Specifies advanced permissions. advanced-perm
advanced- is a comma-separated list containing any of the
perm following:
TraverseFolderOrExecuteFile
ListFolderOrReadData
ReadAttributes
ReadExtendedAttributes
CreateFilesOrWriteData
CreateFoldersOrAppendData
WriteAttributes
WriteExtendedAttributes
DeleteSubfoldersAndFiles
Delete
ReadPermissions
WritePermissions
TakeOwnership

all-operations- user Displays all roles that user is allowed to perform

of-user on the branch, store, or server.
all-permission- Displays all permission entries on the server, and
entries on branches and stores in the server.
all-permission- user Displays all permissions that user has on the
entries-of-user -verbose branch, store, or server. If specified, verbose
provides extended information.
all-roles-of- user Displays all roles that user has on the branch,
user store, or server.
check-job- jobid Determines whether user is allowed to perform
permission -user user the operation specified by op on the job specified
by jobid. See iwroleadm for a list of valid job
-op op operation names.
check- vpath Determines whether user is allowed to perform
permission -user user the operation specified by op on the object
specified by vpath. Execute iwroleadm -all
-op op operations for a list of valid operation names.
-taskcontext Specifies a task that the operation is attached to.
taskid
-jobcontext Specifies a job that the operation is attached to.
jobid
-targetvpath Specifies an object when the operation (such as
vpath2 RenameFile) applies to multiple objects.
check-task- taskid Determines whether user is allowed to perform
permission -user user the operation specified by op on the task specified
by taskid. See iwroleadm for a list of valid task
-op op operation names.
clear- vpath Clears a permission entry to the branch, store, or
permission- server specified by vpath, resetting its inherit
entries flag to true and private flag to false.
delegable- vpath Displays the roles that user can delegate to other
roles-of-user -user user users in the context of the specified vpath.
export- file Writes all branch, store, and server permission

permission- entries to the specified file, which must have an
entries absolute path.
group vpath Displays the owning group of the object specified

by vpath.
import- file Applies all branch, store, and server permission
permission- -clear entries in the specified file, which must have an
entries absolute path, to the server. If clear is specified,
any existing permission entries in the server for
the vpaths specified in file (only) are cleared
before applying the permission entries.
inheritance vpath Determines whether the branch or store specified
by vpath is set to inherit permission entries from
its parent container.
Interwoven, Inc. 26
owner vpath Displays the owner of the object specified by

vpath.
permission- vpath Displays the permission entries for the branch,
entries store, or server specified by vpath.
-modinfo If specified, includes last modification
information.
-inherited If specified, included entries inherited from the
parent container.
-expand- If specified, groups are expanded recursively to
groups list only users.
private vpath Determines whether the branch or workarea
specified by vpath is private (readable only by
members of the branch or workarea) or public
(readable by everyone).
remove- vpath Removes a permission entry from the branch,
permission-entry -user user store, or server specified by vpath, revoking from
-role role user the permission to perform the operations
associated with role.
-group group Removes permission from a group specified by
group.
remove- vpath Removes a Windows ACL entry from the file
windows- specified by vpath.
permission
-user user Specifies the user having the permission setting.
-group group Specifies the group having the permission setting.
either R, M, or F:
R: Read
M: Modify
F: Full control
-mode Applies only to folders; specifies basic folder
folder-mode permission settings. The value of folder-mode is
a whole number from 1 through 7:
1: This folder only.
2: This folder, subfolders, and files. This is the
default value.
3: This folder and subfolders.
4: This folder and files.
5: Subfolders and files.
6: Subfolders only.
7: Files only.


perm following:
ReadAttributes
WriteAttributes
Delete
ReadPermissions
WritePermissions
TakeOwnership
replace-windows- vpath Replaces all permission entries of the specified
permission vpath with one or more Windows ACL entries
read from standard input.
Each such Windows ACL entry is specified as
described under add-windows-permission, using
a combination of the following arguments:
-user user Specifies the user having the permission setting.
-group group Specifies the group having the permission setting.
either R, M, or F:
R: Read
M: Modify
F: Full control
-mode Applies only to folders; specifies basic folder
folder-mode permission settings. The value of folder-mode is
a whole number from 1 through 7:
1: This folder only.
2: This folder, subfolders, and files. This is the
default value.
3: This folder and subfolders.
4: This folder and files.
5: Subfolders and files.
6: Subfolders only.
7: Files only.
Interwoven, Inc. 28

perm following:
ReadAttributes
WriteAttributes
Delete
ReadPermissions
WritePermissions
TakeOwnership
roles-of-user vpath Displays the roles that user has in the context of
-user user the specified vpath.
set-group vpath group Changes the owning group of the object specified
by vpath to the group specified by group.
set-inheritance vpath Specifies whether the branch or store specified by
true|false vpath inherits permissions from its parent
container.
set-owner vpath user Changes the owner of the object specified by
vpath to the user specified by user.
set-private vpath Marks the branch or workarea specified by vpath
true|false as private (readable only by members of the
branch or workarea) or public (readable by
everyone).
set-windows- vpath true Specifies that Windows inheritable permissions
inheritance from the parent directory are allowed to
propagate to the file or folder specified by vpath.
false -copy Specifies that Windows inheritable permissions
from the parent directory are not allowed to
propagate to the file or folder specified by vpath.
If copy is specified, local copies of the inherited
permissions are saved.
windows- vpath Determines whether Windows inheritable
inheritance permissions from the parent directory are allowed
to propagate to the file or folder specified by
vpath.
windows- vpath Displays Windows ACL information for the file
permission -advanced specified by vpath. If specified, advanced
displays detailed information.

Examples
The following command displays whether the user dinesh is allowed to edit files in the
workarea \default\main\Workarea\andre :
>iwaccess check-permission \default\main\WORKAREA\andre -user dinesh -op
Edit
The following command displays whether the user dinesh is allowed to modify the
properties of task 1234 in the workarea \default\main\Workarea\andre:
>iwaccess check-task-permission 1234 -user dinesh -op ModifyTaskProperties
The following command grants to the user dinesh the permission to perform the
operations associated with the role dbadmin on the branch \default\main. This
example assumes that the TeamSite role dbadmin is already defined:
>iwaccess add-permission-entry \default\main -user dinesh -role dbadmin
The following command makes the user dinesh the owner of the branch
\default\main:
>iwaccess set-owner \default\main dinesh
NOTE
Execute iwroleadm -all-operations for a list of valid operation names.
Interwoven, Inc. 30
iwaccessmigrate.exe
Migrates the old access model from a pre-6.7 TeamSite release to the new access model.
Can instead generate an XML manifest file of permission, group, and role settings for
use before or after an upgrade from a pre-6.7 TeamSite release. To use this CLT, you
must have read permission across all stores on the content server.
The migration consists of the following steps:

1. On a per branch basis, the highest role of the owner of each branch is examined. If
this role is master or administrator, the owner is assigned an owner permission
entry with the administrator role (unless a different role is specified with the -b
option). Otherwise, ownership of the branch is transferred to the root user, who is
assigned an owner permission entry with the adminstrator role, and the original
owner, if their highest role was editor or author, is assigned an user permission
entry with that role.
2. If the -bg option is specified, its group-for-sharing is examined for each branch. If
the highest role of all TeamSite users in this group is either master or
administrator, a group permission entry is assigned with the administrator role
(unless a different role is specified with the -b option). Otherwise, unless either the
-n option is specified or no TeamSite users are in the branch’s group-for-sharing, a
TeamSite group is created for all users in this group-for-sharing with a highest role
of either master or administrator. The new group’s name is derived from the
branch’s vpath (unless a prefix is specified with the -p option) and a group
permission entry is assigned with the administrator role (unless a different role is
specified with the -b option). If the -n option was specified, then user permission
entries, with the administrator role, are created for these users instead. Finally, in
all cases, an additional group permission entry is assigned for the group-for-sharing
with the reviewer role.
3. On a per workgroup basis, the highest role of the owner of the workarea is
examined. If this role is either master, administrator, or editor, then the owner is
assigned a user permission entry with the editor role. If the owner’s highest role is
author, then the owner is assigned a user permission entry with the author role. (If
the owner has no role, then no permission entry is assigned.)
4. On a per workarea basis, each group-for-sharing is examined. If the highest role of
all TeamSite users in this group is either master, administrator, or editor, then a
group permission entry is assigned with the editor role. Otherwise, unless either
the -n option is specified or no TeamSite users are in the workarea’s
group-for-sharing, two TeamSite groups are created: one for all users in this
group-for-sharing with a highest role of either master, administrator, or editor,
and one for all users in this group-for-sharing with a highest role of author. The
new groups’ names are derived from the workarea’s vpath (unless a prefix is
specified with the -p option) and a group permission entry is assigned for the first
group with the editor role and for the second group with the author role. If the -n
option was specified, then user permission entries, with the appropriate roles, are
created for all TeamSite users in this group-for-sharing instead.

5. At the server level, a group permission entry with the iwEveryone TeamSite group
and reviewer role is assigned.
6. On a per branch basis, if the branch’s “other” bits are 0 (that is, 770 or 750) and the
-i option is not specified, then the inherit-from-parent flag on the branch is set
to false. If the -i option is specified, the inherit-from-parent flag is always set
to true.
Man Page Group
System Services.
Usage
iwaccessmigrate [-h] [-v]
iwaccessmigrate [-o] [-bg] [-n] [-i] [-m] [-g] [-b role]
iwaccessmigrate [-o] [-bg] [-p group-prefix] [-i] [-m] [-g] [-b role]
iwaccessmigrate [-o] [-f file]
-h Prints usage message.

-v Prints version string.
-o Overrides store active check.
-bg Uses each branch’s group-for-sharing to construct the branch
permission entries.
-n Does not create new TeamSite groups when either members of a
branch’s group-for-sharing include some users who are editors
or authors or members of a workarea’s group-for-sharing
include some users who are authors.
-p group-prefix When creating new TeamSite groups (when members of a
branch’s group-for-sharing include some users who are editors
or authors or members of a workarea’s group-for-sharing
include some users who are authors), names them by prepending
the specified group-prefix, instead of the branch or workarea’s
vpath (the default behavior), to an internally generated number.
-i Sets the inherit-from-parent flag on each branch to always be
true.
-m Generates an accessresults.xml manifest file in the logging
directory showing permission, group, and role entries for all
TeamSite users. Does not migrate permissions.
-g Turns on logging.
-b role Specifies the role instead of administrator to be assigned to the
branch owner’s user permission entry and branch’s group
permission entry.
-f file Uses the specified manifest file (see -m option) to migrate
permissions.
Interwoven, Inc. 32
Examples
The following command migrates the entire content server to the new access model.
Permissions are based on the existing TeamSite groups-for-sharing for each branch.
>iwaccessmigrate -bg
The following command accomplishes the same as the preceding command, except that
no new TeamSite groups will be created.
>iwaccessmigrate -bg -n
The following command generates a permissions manifest file, accessresults.xml, in

the logging directory. The content server is not migrated to the new access model.
>iwaccessmigrate -m
The following command applies permissions from a previously generated manifest file,
iw-home\etc\accessresults.xml.
>iwaccessmigrate -f iw-home\etc\accessresults.xml

iwadduser.ipl
Adds a TeamSite user to the specified role files in iw-home\conf\roles and the entity
database.
Man Page Group
System services.
Usage
iwadduser.ipl [-h|-V] -user domain\user -roles roleList
-h Displays usage message.

-V Verbose mode.
-user domain\user The name of the user to be created.
-roles roleList Comma-separated list of roles to which this user is
assigned.
Example
>iwadduser -V -user factotum\jerome -roles master,admin
Adds the user jerome to TeamSite master and admin roles files.
Interwoven, Inc. 34
iwancestor.exe
Prints the vpath of the common ancestor of the specified files.
Man Page Group
System Information.
Usage
iwancestor [-i] vpath1 vpath2
-i Prints the ID of the ancestor instead of the vpath.

-v Prints the version string.

iwchgrp.exe
iwchgrp is equivalent to the UNIX chgrp command. Because TeamSite retains the
concept of group ownership of branches and workareas, iwchgrp allows you to change
the group of a file, directory, branch, workarea, or file system entity such as a link. To
change the group of a branch, workarea, or FSE, you must be the owner.
Man Page Group
System Services.
Usage
iwchgrp [-h|-v] group path

group Specifies the new domain and group name. Can be a TeamSite
group or an operating system group.
path Specifies the directory path (including the drive) to the
workarea.
Examples
>iwchgrp Administrators Y:\default\main\dev\Workarea\andre
changes the group of workarea andre on the dev branch to the local group of
administrators.
>iwchgrp WEBSTER\Marketing Y:\default\main\dev\Workarea\andre
changes the group of workarea andre on the dev branch to the Marketing group in the
WEBSTER domain.
Interwoven, Inc. 36
iwconfig.exe
A command line interface to TeamSite’s main configuration file, iw.cfg. Allows you to
read the configuration file, list the names of all the sections in the configuration file, or
write to the configuration file. For information on configuring iw.cfg, see the TeamSite
Administration Guide.
Man Page Group
System Services.
Usage
iwconfig [options] section varname [value]
-show Displays the entire configuration file.

-l Lists section names only.
-w Writes value into /etc/iw.cfg (creates new section and
variable if necessary).
-d Delete a name, value pair from a specified section.
section Section of iw.cfg to read or write to.
varname Variable name within section to read or configure.
value Value to assign to varname (use only with -w).
Example
>iwconfig -l
returns:
main
iwcgi
iwproxy
iwproxy_remap
global_default_map
iwproxy_external_remap
iwserver

iwconfigtsreport.ipl
A command line interface to the TeamSite Reporting configuration file
iw-home/tsreport/conf/tsreport.xml. Allows you to reset all parameters in the
configuration file. For information about file syntax, supported events, and other
reporting features, see the TeamSite Administration Guide.
Man Page Group
System Services.
Usage
iwconfigtsreport.ipl [-db*]
iwconfigtsreport.ipl -dbuser username -dbpasswd password
iwconfigtsreport.ipl -licensekey
iwconfigtsreport.ipl -jndiport
When specifying db* command line options (such as dbtype, dbserver, and so on), you
must use one of the following combinations:
All of the db* options (dbtype, dbserver, dbport, dbname, dbuser, and dbpasswd)
must be used together on the same command line, or
The dbuser and dbpasswd options must be used together on the same command line.
Specifying all db* options on the same command line sets the database type and
configures the schema. Specifying just dbuser and dbpasswd configures the database
user and password without creating the schema.
The db* options are as follows:
-dbtype mssql|oracle|mysql|db2 Specifies the reporting database type. Specifying

oracle applies to all supported Oracle databases.
Must be used together with all other -db* options.
-dbserver servername Specifies the reporting database server;
servername can be the name or IP address of the
database server. Must be used together with all
other -db* options.
-dbport portnumber Specifies the port used by the reporting database
on the database server. Must be used together
with all other -db* options.
-dbname databasename Specifies the reporting database name as defined
by the database administrator when the database
was created. This is also the database instance in
which the TeamSite reporting schema is created.
Must be used together with all other -db* options.
-dbuser username Adds a user to the list of reporting database user.
-dbpasswd password Resets the reporting database password;
password must meet the password criteria for the
reporting database type.
Interwoven, Inc. 38
Additional options are as follows:
-license licensekey Installs a reporting license key.

-jndiport jndiportnumber Specifies the port number where the event
subsystem is running.
Examples
>iwconfigtsreport -dbtype mssql -dbname db1 -dbserver server1 -dbport 8085
-dbuser shashi -dbpasswd asdfjkl
sets the reporting database type to MS SQL Server 2000 and configures the schema.
>iwconfigtsreport -dbuser shashi -dbpasswd asdfjkl
sets the database user name and password.
>iwconfigtsreport -license akdjk23039al
sets the license key.

iwconvertserver.exe
The iwconvertserver process supports the Content Store conversion GUI by
communicating with remote TeamSite servers. You must run the iwconvertserver
process manually for the GUI to function properly.
Man Page Group
Content Store.
Usage
iwconvertserver -S [-h|-v|-V level|-is|-us]
Server Mode Options
-S Server mode
-is Install NT Service
-us Uninstall NT Service
General Options
-h Print this message

-v Print version
-V level Specify verbose logging level (1-5, default is 1)
Procedure
1. Change to the iw-home/bin directory, for example:
>cd C:\Program Files\Interwoven\TeamSite\bin
2. Either:
Run the iwconvertserver utility directly from the command line:
iwconvertserver -S
Install it as a service, and then start the service using the Service Control
Manager: iwconvertserver -is
Interwoven, Inc. 40
iwfreeze.exe
Freezes and unfreezes all system writes. Unlike a full server stop, users can still log into
the system and read data.
To determine whether the TeamSite server is currently frozen, use the iwstat (page 78)
command-line tool.
Man Page Group
System Services.
Usage
iwfreeze [-h|-v|+N|-j|--] [backing_store]

+N Freeze for N seconds.
-j Freeze or unfreeze only batch jobs, not the entire Content
Store. As currently supported, batch jobs result from a Delete
Area operation and accomplish the following: clean up
destroyed workareas, editions, and branches.
-- Unfreeze archive immediately.
backing_store Perform operation only on specified Content Store. If this
option is not specified, perform operation on all active backing
stores.
Examples
>iwfreeze +30
returns:
Freeze archive default for 30 seconds...
and freezes the TeamSite archive for thirty seconds.
>iwfreeze --
returns:
Archive default unfrozen.
and unfreezes the archive.

Notes
When iwfreeze is issued, the system performs the following activities:
Blocks new operations.
Completes all current operations.
Flushes the cache.
Issues a message telling users an iwfreeze has occurred.
Returns write operations with a failure status message.
Performs read-only operations.
Interwoven, Inc. 42
iwfsck.exe
Diagnoses Content Store problems and enables repair of some of the problems found.
Man Page Group
Content Store.
Usage
iwfsck [-h] [-v] [-xxx] [-l] [-a] [-b path] [-c size] [vpath]
[-nofmtchk] [-z] [-d [-f] [-s] [-m] [-p] [-r]]

-x Requests extra output and increments verbosity level. Prints
additional information about what iwfsck is doing as it
operates. Each x increments the verbosity level by 1. The
highest level of verbosity is level 3 (-xxx). In the higher levels
of verbosity, an extremely large quantity of output may be
produced.
-c size Sets internal cache size (for debugging iwfsck only).
-w size Sets nominal fastwalk memory limit (default is unlimited, size
greater than 192 recommended if this option is used).
-l Prints output as HTML. This option is used by the
iwfsckcgi.cgi program.
-a Checks areas within all branches.
-b path Uses path as the Content Store location. The default is the
configured Content Store location returned by iwgetstore for
the TeamSite server.
-nofmtchk Inhibits validation of FORMAT files.
-z Checks events in branches.
-d Checks directories and files in addition to the normal checking
of branches and areas. All directories and files from the vpath
are walked. If a vpath is not specified on the command line,
the walk begins at the / vpath.

The following options are only allowed when -d is specified:
-unpub Checks directories and files in unpublished editions. This is

very memory intensive and is not recommended. If you do use
this option, using -s also will reduce memory usage, but will
be very slow.
-f Provides a fast reference check (not allowed with -p, -m, or
-s). All references from the root are walked aggressively
looking for missing references. If a missing reference is found,
that part of the tree is marked suspect, and a more expensive
walk with vpaths is done on that part of the tree to determine
the directories and files affected by the problem.
-s Provides a stack walk, which is slower but uses less memory
than the default (not allowed with -f). This mode uses the least
amount of memory, but it is the least efficient for walking the
entire tree of files and directories from the root.
-m Checks ModLists for directories. A ModList is a data structure
that is a shadow tree to the directory structure within a
workarea. This shadow tree allows the modified files within a
workarea to be determined quickly without having to traverse
every file and directory within a workarea.
-p Checks protopaths. A protopaths is a data structure that allows
file names and history information to be determined without
the expense of walking up to the root of an area through
directories; however, it can be expensive.
-r Checks parents. Parents and anti-parents are the reference
counting mechanism used by the TeamSite server. If zero
parents are found for a file, it indicates a problem. It can be
expensive.
Examples
To check areas and branches, issue the command:
>iwfsck
To check directories and files in addition to branches and areas, issue the command:
>iwfsck -d
Use the following command to check protopaths and parents in addition to branches,
areas, directories, and files. This command can be very resource intensive.
>iwfsck -d -p -r
Interwoven, Inc. 44
iwfsfix.exe
The iwfsfix command repairs certain problems. If iwfsck (see page 43) finds problems
when the Content Store is diagnosed, it outputs lines in the format:
FIX iwfsfix repair args
The repairs and their arguments are shown below. The content of these lines, following
the word FIX, are iwfsfix command lines. To perform repairs, copy the FIX line issued
by iwfsck and paste it on the command line, with the word FIX removed.
There are also repairs for ModLists that must be performed when the TeamSite server is
running. These lines are in the format:
FIX echo x > junkfile; del /f junkfile
where junkfile is a uniquely named file that is created and removed from an affected
directory.
The repairs that can be performed with iwfsfix are:

delete_tag branch_id tag_id
Removes the reference to a tag (lock) from a branch. This is done when the tag point
itself is missing.
delete_tag_and_point branch_id tag_id
Deletes the reference to a tag (lock) from a branch and removes the tag point itself.
This is done when a tag duplicates or conflicts with another tag within a branch.
delete_direntry directory_id diritems_index filename
Deletes the directory entry for a damaged or missing file.

replace_direntry directory_id diritems_index filename new_standin_id
Repairs a directory entry to point to a correct standin ID.

delete_area area_id
Deletes the point for an area.

delete_area_from_branch branch_id area_id workarea | edition
Deletes the reference to an area (workarea or edition) from a branch. This cannot be
done on a staging area because a branch by definition always contains a staging
area.
null_previous point_id
Sets to null (-1) the PreviousPoint reference within a point. This is done when the
PreviousPoint reference for a point is incorrect.
clone_diritems directory_id diritems_index new_gen_id new_dot_dot
Clones a set of directory items within a directory to create a new set. This is done
when a set of directory items is shared between areas, but it should not be shared.

iwfsshrink.exe
Invokes a batch job in the server to find and remove duplicate file contents in the
Content Store. This command is used to improve space usage in an existing Content
Store. It can be used as a maintenance tool on a regular, perhaps quarterly, basis. This
operation results in no user-visible changes to the TeamSite virtual file system; for
example, file histories are unchanged.
Man Page Group
Content Store.
Usage
iwfsshrink [-h|-v] [run|pause|abort|status] [store]

run Starts the iwfsshrink process.
pause Temporarily stops the iwfsshrink process. It can be restarted
with the run option. Because iwfsshrink takes a long time to
run and it increases system load, you may want to start it
during off-hours. When activity increases, you can pause it
until the next period of inactivity.
abort Terminates the iwfsshrink process.
status Shows information about the iwfsshrink process.
store The name of the Content Store to shrink. If no store is
specified, the default store is assumed.
Examples
Issuing iwfsshrink status when iwfsshrink has finished running results in status
similar to:
Not currently running.

Last started Mon Jun 26 15:47:53 2000
Last completed Tue Jun 27 00:40:04 2000
Files examined: 317974
Bytes examined: 75936814830
Files found to be duplicates: 233430
Files converted: 198352
Bytes removed: 23455046531
Interwoven, Inc. 46
Issuing the iwfsshrink run command, followed by the iwfsshrink status command,
results in status similar to:
Current run started Tue Jul 11 14:19:20 2000
Not yet completed
In phase 1
Files examined: 980
Files converted: 0
Bytes removed: 0
Issuing the iwfsshrink pause command, followed by the iwfsshrink status

command, results in status similar to:
Current run started Tue Jul 11 14:19:20 2000
Paused
In phase 1
Files examined: 5694
Files converted: 0
Bytes removed: 0

iwgetelog.exe
Displays the contents of /etc/defaultiwelog (the TeamSite events log) or exits with a
nonzero error code. The TeamSite events log includes the time an operation was
performed, the username and role of the user, the type of operation, the area or file
affected, and additional information according to the type of operation performed (for
example, objids and comments attached to files and operations).
Man Page Group
System Information.
Usage
iwgetelog [-h|-v|-o]

-o Returns original factory setting value.
Example
>iwgetelog
returns:
C:\Program Files\Interwoven\TeamSite\local\logs\iwevents.log
Interwoven, Inc. 48
iwgetfilejobs.exe
Displays a list of associated workflow job and task IDs for a file.
Man Page Group
System Information.
Usage
iwgetfilejobs [-h] [-v] [-s servername] path

-s Specifies the TeamSite server where the file resides.
path Path to look up (including the file name).
Example
>iwgetfilejobs -s factotum \default\main\WORKAREA\kconnor\foo.txt
returns:
job=125998 task=125999
You can use the returned job or task ID with a command like iwgetwfobj as described
on page 135.

iwgethome.exe
Displays the location of the TeamSite program files (the contents of
/etc/defaultiwhome).
Man Page Group
System Information.
Usage
iwgethome [-h|-v]

Example
>iwgethome
returns
C:\Program Files\Interwoven\TeamSite
Interwoven, Inc. 50
iwgetlocation.exe
Displays the location of various TeamSite configuration or log files.
Man Page Group
System Information.
Usage
iwgetlocation [-h|-v] [-a|-l|-c configfilekey|-g logfilekey|filekey
[filekey...]]

-a Returns all locations of all configuration and log files.
-l Lists all filekeys.
-c configfilekey Specifies a configuration file.
-g logfilekey Specifies a log file.
filekey Specifies a particular configuration or log file.
Examples
>iwgetlocation -l
returns:
iwhome
iwbin
iwconfig
iwstore
iwmount
iwcgimount
iwroles
iwlogs
iwconfigs
iweventlog
iwtracelog
iwdeploylog
>iwgetlocation -a
returns:
iwhome=C:\Program Files\Interwoven\TeamSite
iwbin=C:\Program Files\Interwoven\TeamSite\bin
iwconfig=C:\Program Files\Interwoven\TeamSite\etc\iw.cfg
iwstore=C:\iw-store
iwmount=Y:

iwcgimount=Y:
iwroles=C:\Program Files\Interwoven\TeamSite\conf\roles
iwlogs=C:\Program Files\Interwoven\TeamSite\local\logs
iwconfigs=C:\Program Files\Interwoven\TeamSite\local\config
iweventlog=C:\Program Files\Interwoven\TeamSite\local\logs\iwevents.log
iwtracelog=C:\Program Files\Interwoven\TeamSite\local\logs\iwtrace.log
iwdeploylog=C:\Program Files\Interwoven\TeamSite\local\logs\iwdeploy.log
>iwgetlocation iwmount
returns:
Y:
>iwgetlocation -c iwconfig
returns:
C:\Program Files\Interwoven\TeamSite\etc\iw.cfg
>iwgetlocation iwmount iwconfig iweventlog
returns:
Y:
C:\Program Files\Interwoven\TeamSite\etc\iw.cfg
C:\Program Files\Interwoven\TeamSite\local\logs\iwevents.log
Interwoven, Inc. 52
iwgetmount.exe
Displays the location of TeamSite mount point (the contents of /etc/defaultiwmount).
Man Page Group
System Information.
Usage
iwgetmount [-h|-v|-o]
Displays the contents of /etc/defaultiwmount or exits with a non-zero error code.

-o Returns original factory setting value.
Example
>iwgetmount
returns:
Y:

iwgetstore.exe
Displays the contents of /etc/defaultiwstore (the location of the TeamSite Content
Store) or exits with a non-zero error code.
Man Page Group
System Information.
Usage
iwgetstore [-h|-v|-o]

-o Returns the original default value.
Example
>iwgetstore
returns:
C:\iw-store
Interwoven, Inc. 54
iwgettrace.exe
Displays the contents of /etc/defaultiwtrace (the location of the TeamSite trace logs)
or exits with a nonzero error code. The trace log contains debug information for
TeamSite.
Man Page Group
System Information.
Usage
iwgettrace [-h|-v|-o]

-o Returns the original default value.
Example
>iwgettrace
returns:
C:\Program Files\Interwoven\TeamSite\local\logs\iwtrace.log

iwgroup.exe
Administers TeamSite groups.
Man Page Group
System Services.
Usage
iwgroup -h [command]|-v
iwgroup add-admins groupname [user+]
iwgroup add-included-groups groupname [include_group+]
iwgroup add-member -u user groupname

iwgroup add-member -g group groupname
iwgroup add-member -if inputfile [-of outputfile]
iwgroup add-users groupname [user+]
iwgroup create groupname [-id idnumber]

iwgroup create -if inputfile
iwgroup delete groupname

iwgroup delete -if inputfile
iwgroup description groupname
iwgroup display-name groupname
iwgroup id groupname
iwgroup list-admin-groups-of-user user
iwgroup list-admins groupname [- recurse]
iwgroup list-groups -u user

iwgroup list-groups -a
iwgroup list-groups -o
iwgroup list-groups-of-user user [- recurse]
iwgroup list-included-groups groupname [-recurse]
iwgroup list-members groupname
iwgroup list-users groupname [-recurse]
Interwoven, Inc. 56
iwgroup mod -id idnumber groupname

iwgroup mod -n name groupname
iwgroup remove-admins groupname [user+]
iwgroup remove-included-groups groupname [include_group+]
iwgroup remove-member -u user groupname

iwgroup remove-member -g group groupname
iwgroup remove-member -if inputfile [-of outputfile]
iwgroup remove-users groupname [user+]
iwgroup set-description groupname description
iwgroup set-display-name groupname display_name
iwgroup set-id groupname idnumber
-h command Displays iwgroup usage information for command, or

general iwgroup usage information if command is
omitted.
add-admins groupname Adds one or more users as administrators for the
group specified by groupname.
user+ Specifies the name(s) of the user(s) to add as
administrators of the group. If no users are specified
on the command line, standard input is read.
add-included- groupname Adds one or more included groups to the TeamSite
groups group specified by groupname in
iw-home/conf/tsgroups.xml
include_ Specifies the name(s) of the included group(s) to
group+ add to the group. If no included groups are specified
add-member Adds a user, an OS group, or a TeamSite group to an
existing TeamSite group. Additions are made to
iw-home/conf/tsgroups.xml (if -of is not used) or
to a file that you specify with the -of option.
-u user Adds the specified user ID to the group named by
groupname groupname.
-g group Adds the specified TeamSite or OS group ID to the
groupname group named by groupname.
-of Specifies the path of a file to which the member is
outputfile added.
-if Specifies the path of a file containing a list of users
inputfile or groups to add. See page 61 for file syntax.

add-users groupname Adds one or more users to the group specified by

groupname.
user+ Specifies the name(s) of the user(s) to add to the
group. If no users are specified on the command
line, standard input is read.
create groupname Creates a new TeamSite group named groupname.
The new group is added to the
iw-home/conf/tsgroups.xml file. Also use create to
create the initial version of
iw-home/conf/tsgroups.xml.
-id Assigns the ID specified by idnumber to the group.
idnumber An ID number can be any integer from 1 to infinity.
An error message is displayed if you attempt to give
an invalid number. If the number that you specify is
already taken, the next available number is assigned.
-if Specifies the path of a file containing a list of
inputfile groups or users to add. See page 61 for file syntax.
delete groupname Deletes the TeamSite group specified by groupname
from iw-home/conf/tsgroups.xml.
-if Specifies the path of a file containing a list of
inputfile groups to delete. See page 61 for file syntax.
description groupname Displays the value of the description attribute for
the group specified by groupname.
display-name groupname Displays the value of the display-name attribute for
groupname.
id groupname Displays the id number of groupname. An ID
number can be any integer from 1 to infinity.
list-admin- user Displays a list of groups for which user has
groups-of-user administrator permission.
list-admins groupname Displays a list of users in the group specified by
groupname who have the administrator role.
-recurse If specified, displays a list of administrators from
recursively included groups.
list-groups Displays a list of TeamSite groups. To display
information about the default TeamSite group file
iw-home/conf/tsgroups.xml, do not use the -if
option.
-u user Displays all groups to which the specified user
belongs.
-a Displays the name, display name, description, and
iwgid of all TeamSite groups.
-o Displays the name and display name of all OS
groups.
list-groups-of- user Displays all groups to which the specified user
user directly belongs.
-recurse If specified, displays groups to which user
indirectly belongs through nesting.
Interwoven, Inc. 58
list-included- groupname Displays a list of groups included in groupname.

groups
-recurse If specified, displays a list of groups from
recursively included groups.
list-members groupname Displays information about the TeamSite group
specified by groupname in the default TeamSite
group file
list-users groupname Displays a list of the users included in groupname.
-recurse If specified, displays a list of users from recursively
included groups.
mod Modifies the name or ID of a TeamSite group in the
default TeamSite group file
-id Changes the id to the number specified by
idnumber idnumber.
groupname Specifies the TeamSite group on which to perform
the modification.
-n name Changes the group name to the string specified by
name.
remove- groupname Removes administrator permissions for one or more
admins users in the group specified by groupname.
user+ Specifies the name(s) of the user(s) to remove as
administrators of the group. If no users are specified
remove- groupname Removes one or more included groups from the
included- TeamSite group specified by groupname in
groups iw-home/conf/tsgroups.xml
include_ Specifies the name(s) of the included group(s) to

group+ remove from the group. If no included groups are
specified on the command line, standard input is
read.
remove- Removes a user, an OS group, or a TeamSite group
member from an existing TeamSite group. Removals are
made from
iw-home/conf/tsgroups.xml (if -of is not used) or
from a file that you specify with the -of option.
-u user Deletes the specified user ID from the group named
groupname by groupname.
-g group Deletes the specified TeamSite or OS group ID from
groupname the group named by groupname.
-of Specifies the path of a file from which the member
outputfile is deleted.
-if Specifies the path of a file containing a list of users
inputfile or groups to delete. See page 61 for file syntax.
remove-users groupname Deletes one or more users from the group specified
by groupname.

user+ Specifies the name(s) of the user(s) to delete from

the group. If no users are specified on the command
line, standard input is read.
set- groupname Changes the value of the description attribute of
description groupname.
description Specifies the string used for the value of the
description attribute.
set-display-name groupname Changes the value of the display-name attribute of
groupname.
display_ Specifies the string used for the value of the
name display-name attribute.
set-id groupname Changes the id number for groupname. An ID
number can be any integer from 1 to infinity. An
error message is displayed if you attempt to give an
invalid number. If the number that you specify is
already taken, the next available number is assigned.
idnumber Specifies the new value of the id.
Examples
>iwgroup create headquarters -77
adds the empty TeamSite group headquarters with an ID of 77 to the default TeamSite
group file iw-home/conf/iwov.grp.
>iwgroup create -if /usr/dinesh/engr.xml -of /usr/eng/master.xml
adds all TeamSite groups contained in engr.xml (as defined by the iwgroup elements) to
the TeamSite group file master.xml.
>iwgroup delete headquarters
deletes the TeamSite group headquarters from the default TeamSite group file
iw-home/conf/iwov.grp.
>iwgroup delete -if /usr/dinesh/engr.xml -of /usr/eng/master.xml
Deletes all TeamSite groups contained in engr.xml (as defined by the iwgroup
elements) from the TeamSite group file master.xml.
>iwgroup add-member -u dinesh headquarters
Adds the user dinesh to the TeamSite group headquarters in the default TeamSite
>iwgroup add-member -g sveng -of /usr/eng/master.xml
Adds the OS group sveng to the TeamSite group file master.xml.
Interwoven, Inc. 60
>iwgroup add-member -if /usr/dinesh/engr.xml -of /usr/eng/master.xml
Adds all TeamSite users and groups contained in engr.xml (as defined by the user and
group elements) to the TeamSite group file master.xml.
>iwgroup list-groups -a
Displays a list of all TeamSite groups in the default TeamSite group file
>iwgroup list-members sveng
Displays a list of all members of the TeamSite group sveng in the default TeamSite
>iwgroup list-members -if /usr/dinesh/engr.xml sveng
Displays a list of all members of the TeamSite group sveng in the TeamSite group file
engr.xml.
>iwgroup mod -id 3 sveng
Changes the ID of the TeamSite group sveng to 3 in the default TeamSite group file
>iwgroup mod -n svengnew -if /usr/dinesh/engr.xml sveng
Changes the name of the TeamSite group sveng to svengnew in the TeamSite group file
engr.xml.
NOTE
The following files show the formats used by TeamSite group files as specified by
inputfile.
Format for inputfile when used with the create option:
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>

<iwgroups>
<iwgroup name="newgroup1" id="1"/>
<iwgroup name="newgroup2" id="2"/>

</iwgroups>

Format for inputfile when used with the delete option:

<iwgroups>
<iwgroup name="newgroup1"/>
<iwgroup name="newgroup2"/>
</iwgroups>
Format for inputfile when used with the add-member option:

<iwgroups>
<iwgroup name="newgroup1">
<user name="newuser1"/>
<group name="newgroup2"/>
</iwgroup>
</iwgroup>
</iwgroups>
Format for inputfile when used with the remove-member option:

<iwgroups>
<group name="newgroup1"/>
</iwgroup>
</iwgroup>
</iwgroups>
Interwoven, Inc. 62
iwidmap.exe
The iwidmap CLT changes the mapping between the SID and the token. It can also be
used to refresh the mapping when the same names are used, and the SID has changed.
For more information about SID mapping, see the TeamSite Administration Guide.
Man Page Group
Content Store.
Usage
iwidmap [-v] [-h] (-u | -g) [-a][-c user1 user2] -s servername
[-x file | -i file] backing-store
-v Displays the version of this program.

-h Displays the usage message.
-u Update userid mapping.
-g Update groupid mapping.
-a Update all entries in the ID map.
-c user1 user2 Update user1 to user2.
-s servername Name of the source server. This is required
if the source server machine name changed
(such as if the Content Store was moved to
a different machine). It ensures proper
translation of local users on the source
server
-x file Extract to file.
-i file Import from file.
backing-store Location of the Content Store.
NOTES
When OS users or groups are imported or exported, only the OS IDs (“ID” for both
users and groups) are imported/exported.
When non-OS users or groups are imported or exported, only the TeamSite IDs
(“IWUID” or “IWGID”) are imported/exported.IWUID is the tsid attribute set in
tsusers.xml while IWGID is the id attribute set in tsgroups.xml.
Examples
To change the mapping for a single user:

>iwidmap -u -c jgarcia rhunter c:\iw-store\NewReleases

To change the mapping for multiple users (assuming that the source server name
changed):
>iwidmap -u -x c:\idmap.xml -s server1 c:\iw-store\NewReleases
To change the mapping for multiple users and edit idmap.xml so that old names are
replaced with new names (assuming that the source server name did not change):
>iwidmap -u -i c:\idmap.xml -a c:\iw-store\NewReleases
Interwoven, Inc. 64
iwmigrate.exe
The iwmigrate CLT accepts TeamSite 6.x Content Stores as its source. It can be used to
split a single Content Store into multiple Content Stores, or to move the contents of a
store to another location without losing the history of submit events for the editions.
Man Page Group
Content Store.
Usage
iwmigrate [-h] [-v] [-x] [-m mount_location] -o new_backing_location
[-b branch_vpath] [-s starting_ed] [-e ending_ed] [-t timeout] [-c] [-d]
[-f] [-l] [-a cache_size] [-w [only] [-file path | workarea_name]
-h Display this message.

-v Display version number.
-b branch Specify source branch for migration.
-x Increase verbosity level. Maximum verbosity is level
3, expressed as:
-x -x -x.
-m mount_location Specify mount location of Content Store, for example:
Y:\default
-o new_backing_location Specify new Content Store location.
-d Do not recursively convert subbranches.
-s starting_ed Specify starting edition for migration. Default is the
INITIAL edition (this option can only be used with -d).
-e ending_ed Specify ending edition for migration. Default is the
most recent edition (this option can only be used with
-d).
-t timeout Time in minutes for the process to run.
-f Full clone of every edition (does not preserve history).
-c Clean up history information (use on the final pass).
-l locale Specify the native locale of the Content Store being
migrated (if different from LC_LOCALE for this system).
-a cache_size Number of objects kept in the cache. The default is
30,000 objects.
-w Migrate workareas within branches specified by the -b
option using a file containing a list of workareas or by
specifying the workareas.
Example
>iwmigrate -m Y:\default -o d:\iw-store\safari_on_line
-b \default\main\examples

For the branch specified by -b option, migrate all the workareas using -w by itself:
>iwmigrate -m /iwmnt/default -b /default/main -o /local/new-store/default
-w
For the branch specified by -b option, migrate the workareas named

workarea_name0,…..workarea_nameN using the -w workarea_name format:
-w wa1,wa2
For the branch specified by -b option, migrate all the workareas listed in the file using
the -w -file file_name format:
-w -file filename
NOTE
file_name is a file containing a list of workarea names.
For the branch specified by -b option, migrate only named workareas or the workareas
listed in the file using the -w -only [[-f file_name] | [workarea_name]] format:
-w -only
-w -only wa1,wa2
-w -only -file file_name
Using the -only option means that editions will not be migrated.
Interwoven, Inc. 66
iwprefconv.exe
The SetHomePage functionality stores the home page information in the entity database
instead of the iwprofiles directory.
If you are upgrading from a pre-5.5.1 release of TeamSite, you must run the iwprefconv
CLT once to copy any existing home page information from the iwprofiles directory
(iw-home/local/iwprofiles) to the entity database (iw-home/local/entities/data).
If you are installing TeamSite without upgrading from a previous TeamSite release, the
home page information is stored in the entity database by default.
To run the iwprefconv CLT, iwserver must be running.
Man Page Group
System Services.
Usage
iwprefconv.exe
(The CLT does not accept any parameters.)

iwproxy.exe
Invokes and debugs the proxy server. The proxy server is automatically invoked at
startup time.
Man Page Group
System Services.
Usage
iwproxy [-h|-v|-d|-x]

-d Debug mode (outputs client and server headers).
-x Extended debug mode (verbose output).
Example
>iwproxy -d
returns:
Using tickets for authentication
Using newfangled blobs
[iwproxy] max_connections (default): 100
[iwproxy: using gethostname() for local hostname: factotum]
[iwproxy: changed local hostname to result of gethostbyname(factotum):
factotum.interwoven.com]
[iwproxy] listening at http://factotum.interwoven.com:1080
[iwproxy] using customer web server at http://factotum.interwoven.com:81
[iwproxy] using servlet engine at http://localhost:8080/iw-ts
[iwproxy] using iwwebd at http://fully.qualified.hostname.com:80
[external remap configuration]
[name not set]
key: 0
docroot: [no docroot specified]
[local remap configuration]
/
key: 0
docroot: [no docroot specified]
Interwoven, Inc. 68
iwrecentusers.exe
Displays a list of everyone who has used TeamSite since the last time the TeamSite
server was started. The list also contains a timestamp of each user’s most recent
TeamSite operation.
Man Page Group
System Information.
Usage
iwrecentusers [-h|-v|-Gn]

-v Displays version information.
-G0 Output is tab-separated. If a field is longer than the tab, then
alignment will be erratic.
-G1 Output is neatly formatted (default). Field width is adjusted for
the longest value in the column and is aligned.
Example
>iwrecentusers
returns:
bgunn Mon Sep 16 16:17:08 2004
umaster Fri Sep 13 14:07:59 2004
jgarcia Fri Sep 13 14:05:12 2004
nobody Wed Sep 11 15:34:55 2004

iwreset.exe
Tells the TeamSite server to reread the TeamSite configuration files (iw.cfg,
submit.cfg, autoprivate.cfg, and the roles files) and resets iwserver based on the
values in the configuration files.
This CLT must be run on the TeamSite server host system.
Man Page Group
System Services.
Usage
iwreset [-a|-h|-ui|-v]
-a Reread configuration and then reset iwserver and restart ui

services (as if both the iwreset and iwreset -ui commands
had been issued).
-ui Restart (stopping if necessary) the following ui services:
iwwebd, iwproxy, iwservletd.
Example
>iwreset
Tells the TeamSite server to read the TeamSite configuration files and reset iwserver.
Notes
Exits with 0 on success, non-zero on failure.
All except the following iw.cfg settings are reset when iwreset executes. You must
restart TeamSite for the following settings to reset.
Cache size (set in [iwserver])
File system thread count (set in [iwserver])
File system active area cache (set in [iwserver])
File locations (set in [locations])
Interwoven, Inc. 70
iwrmuser.ipl
Removes a TeamSite user from all role files in iw-home\conf\roles and the entity
database.
Man Page Group
System Services.
Usage
iwrmuser.ipl -h|-v [-V] domain\user
Example
>iwrmuser.ipl factotum\jerome
Removes the user jerome from TeamSite. Note that unlike iwadduser, you cannot
selectively remove users from specific role files.

iwroleadm.exe
Administer roles for TeamSite users and groups.
Man Page Group
System Services.
Usage
iwroleadm -h [command]|-v
iwroleadm add-delegable-roles role [delegable_role+]
iwroleadm add-operations role [operation+]
iwroleadm all-operation-categories [-verbose]
iwroleadm all-operations [-verbose]
iwroleadm all-roles
iwroleadm create role
iwroleadm create-custom-operation name display_name description category
iwroleadm delegable-roles role
iwroleadm delete role
iwroleadm description role
iwroleadm display-name role
iwroleadm locking-model role
iwroleadm operations role
iwroleadm remove-custom-operations opname [opname...]
iwroleadm remove-delegable-roles role [delegable_role+]
iwroleadm remove-operations role [operation+]
iwroleadm replace-delegable-roles role [delegable_role+]
iwroleadm replace-operations role [operation+]
iwroleadm set-description role description
Interwoven, Inc. 72
iwroleadm set-display-name role display_name
iwroleadm set-locking-model role S | O | M | U
iwroleadm set-workarea-permission-override role true|false
iwroleadm set-workflow-permission-override role true|false
iwroleadm workarea-permission-override role
iwroleadm workflow-permission-override role
-h command Displays iwroleadm usage information for command, or

general iwroleadm usage information if command is
omitted.
add- role Adds one or more delegable roles to role. Standard
delegable- input is read if no delegable roles are specified on the
roles command line.
delegable_ Specifies the delegable role(s) to add.
role+
add- role Adds one or more operations to the list of operations
operations that role is allowed to perform. Standard input is read
if no operations are specified on the command line.
operation+ Specifies the operation(s) to add.
all- -verbose Displays all operation categories. If specified,
operation- -verbose provides additional information about each
categories category.
all- -verbose Displays all operations that a role can be configured to
operations perform. If specified, -verbose provides additional
information about each operation.
all-roles Displays all currently defined roles.
create role Creates a new empty role named role. The role name
must consist of a letter followed by one or more letters,
digits, or underscores.
create- opname Creates a new custom operation called opname in the
custom- userops_ui.xml or userops.xml file. See the “Notes”
operation section for file locations.
display_name Specifies the display-name attribute for the operation.
description Specifies the description attribute for the operation.
category Specifies the category for the operation. This must be
an existing category as defined by the
operation-category attribute in userops_ui.xml or
userops.xml.
delegable- role Displays the roles that role can delegate.
roles

delete role Deletes the role.

description role Displays the description attribute of role.
display-name role Displays the display-name attribute of role.
locking- role Displays the value of the locking-model attribute of
model role.
operations role Displays the operations that role is allowed to
perform.
remove- opname Removes the specified custom operations from
custom- opname... userops_ui.xml. Operations defined in other files
operations cannot be removed.
remove- role Removes one or more delegable roles from role.
delegable- Standard input is read if no delegable roles are
roles specified on the command line.
delegable_ Specifies the delegable role(s) to remove.
role+
remove- role Removes one or more operations from the list of
operations operations that role is allowed to perform. Standard
input is read if no operations are specified on the
command line.
operation+ Specifies the operation(s) to remove.
replace- role Replaces all existing delegable roles pertaining to role
delegable- with one or more new delegable roles. Standard input is
roles read if no operations are specified on the command
line.
delegable_ Specifies the new delegable role(s).
role+
replace- role Replaces all existing operations that role is allowed to
operations perform with one or more new operations. Standard
input is read if no operations are specified on the
command line.
operation+ Specifies the new operation(s).
set- role Changes the value of the description attribute of role
description description to the value specified by description.
set-display- role Changes the value of the display-name attribute of role
name display_name to the value specified by display_name.
set-locking- role Specifies the locking model for role.
model
S Submit locking.
O Optional write locking.
M Mandatory write locking.
U User mandatory write locking.
set-workarea role Changes the value of the workarea-permission-override
-permission- true|false attribute of role. A value of true enables override
override capability for role; false disables override capability
for role.
Interwoven, Inc. 74
set-workflow role Changes the value of the

-permission- true|false workflow-permission-override attribute of role. A
override value of true enables override capability for role;
false disables override capability for role.
workarea- role Displays the value of the workarea-permission-override
permission- attribute of role.
override
workflow- role Displays the value of the
permission- workflow-permission-override attribute of role.
override
Notes
Depending on your system configuration, user operations are defined in one or more
of the following files:
iw-home/private/etc/userops.xml
iw-home/private/etc/userops_ui.xml
iw-home/private/etc/userops_*.xml
If you edit any of these files manually (as opposed to using a command-line tool
such as iwroleadm), you must run iwreset to pass the changes to the TeamSite
server.
Examples
The following command displays all possible operations that a role can be configured to
perform.
>iwroleadm all-operations
The following command creates an empty role called db_admin.

>iwroleadm create db_admin
The following command adds to the db_admin role the ability to lock and merge files.
>iwroleadm add-operations db_admin LockFile MergeFile
The following command displays the roles that db_admin can delegate.
>iwroleadm delegable-roles db_admin
The following command adds the eng_db role to the list of roles that db_admin can
delegate. This command assumes that the eng_db role already exists.
>iwroleadm add-delegable-roles db_admin eng_db

iwsi.ipl
Available only if the service monitor option of TeamSite is installed. Collects TeamSite
state data about the local environment, including core and configuration files. Files
collected are not deleted from their original locations. Data is stored and compressed in
an archive file named si.timestamp in either iw-home or a specified alternate location.
The command exits after executing; it does not run as a daemon.
Man Page Group
System Services.
Usage
iwsi.ipl [-h|-v] [file]

-v Displays version. Has highest precedence if multiple options
are specified.
file Specifies the full directory path of an alternate archive
location. Each archive file name is given a timestamp suffix to
distinguish it from others with similar names.
Exit Status
The following exit values are returned:
0 Successful options processing.

-1 Invalid options; could not properly set the path; could not find
all the necessary binaries.
>1 Other processes returned an error.
NOTES
The value of timestamp in the archive file name has the format yymmdd.hhmmss.
The archive contains the following files:

Log Files:
iwevents.log
iwserver.log
iwtrace.log
iwdeploy.log
Configuration Files:
iw.cfg
$IW_HOME/local/config/submit.cfg
$IW_HOME/local/config/autoprivate.cfg
Interwoven, Inc. 76
Core Files:
system.dmp
memory.dmp
Server and Process Output Files:
iwserver
informationprocessid (a file containing output from iwversion command)

iwstat.exe
Returns current system activity and displays information about whether the Content
Store is running, frozen (with iwfreeze), flushing, out of space (disklow), or has
experienced an I/O error (diskfail). Throughput information is displayed only if the
thruputmonitoring parameter is set to on in iw.cfg (by default it is set to off). Also
displays statistics about completed operations on the TeamSite server
Man Page Group
System Information.
Usage
iwstat -h|-v
iwstat [-c] [-Gn] [-i sleep_interval] [-m] [-mm] [-mresettime]
[-mstarttime] [-mz] [-n iterations]

-c Displays cache statistics.
-G0 Output is tab-separated.
-G1 Output is neatly formatted (default).
-i sleep_interval Runs the command in a loop every number of seconds
specified by sleep_interval.
-m Displays statistics about completed operations on the TeamSite
server since the last time the server was started. Statistics are
displayed for each Content Store. Information includes total
number of invocations; average, minimum, and maximum
duration of each operation; percentage of total invocations that
each operation accounts for; and percentage of total invocation
time that each operation accounts for.
-mm Displays statistics about completed operations on the TeamSite
server since the last time the -mz option was issued (to reset
information gathering). Statistics are displayed for each
Content Store. Information includes total number of
invocations; average, minimum, and maximum duration of
each operation; percentage of total invocations that each
operation accounts for; and percentage of total invocation time
that each operation accounts for. If -mz was not issued since
the TeamSite server was last started, output is identical to that
of the -m option.
-mresettime Displays the time when the -mz option was last issued. If -mz
was not issued since the TeamSite server was last started,
output is identical to that of the -mstarttime option. The -mm
option returns information about completed operations on the
TeamSite server since this time.
Interwoven, Inc. 78
-mstarttime Displays the time when information gathering on the TeamSite

server was first started during the current run of the server. The
-m option returns information about completed operations on
the TeamSite server since this time.
-mz Displays statistics about completed operations on the TeamSite
server since the last time the server was started (output is
identical to that of the -mm option), and then resets all
information gathering.
-n iterations Runs the command the number of times specified by
iterations. If -i is not also set, the interval between
iterations defaults to 1 second.
Examples
While a Submit operation is underway:
iwstat
While the TeamSite server is frozen as the result of iwfreeze:

iwstat
*** SERVER FROZEN: 55 SECONDS REMAINING ***

0x9d 0xf root 0.000 GetArchiveStatus
The following output from iwstat was obtained while the Content Stores default and
workflow were running.
iwstat
Store Status
defalut Running
workflow Running
ID Thread User Duration Store Operation

0x3f4e 0x17 interwoven\mroot 0.000 - GetArchiveStatus
Minutes Thruput Avg op Load

1 27 0.0189 0.51
15 14 0.0219 0.30
29 9 0.0233 0.20
The preceding example shows that in the most recent complete one-minute time
duration, the TeamSite server handled 27 operations per second. Each operation took an
average of 0.0189 seconds per operation (19 ms/operation). The average load over this
one minute was 51%. By comparison, a two-cpu server is fully loaded at 200% load, a
four-cpu server is fully loaded at 400% load, and so on. Similarly, for a recent complete

15-minute duration, TeamSite handled 14 operations per second, with an average

operation time of 22 ms. Over this time, the server was occupied at 30% load.
Comparing the short and long duration figures shows the load trends. For example, a
high one-minute load, compared with a lower 60-minute load, tells you that there was a
burst of activity. You can also observe that this is not a fast server, because 27 operations
per second at 50% load is not much throughput. A fast server with fast disks can achieve
operation throughput in the 200-500 operations per second range, with operation times
in the 1-5 ms/operation range.
Finally, a load that is near or exceeds the number of CPUs on the server over a sustained
number of hours may indicate an overloaded server. It may also indicate a need to obtain
a more powerful server or a faster Content Store volume.
The following partial output from iwstat -m was obtained while the Content Stores
default and workflow were running.
iwstat -m
Store Status
default Running
workflow Running
ID Thread User Duration Store Operation

0x11066c6 0x13f0 INT\ashanbha 0.000 - GetServerStatus
Store Operation Invocations %(Invocations) %(Time) Avg duration Min

duration Max duration
default BatchJobs 1 0.0 0.0 0.023 0.023

0.023
workflow GetRoles 6 8 39.3 0.011 0.000

0.020
Interwoven, Inc. 80
iwstoreadm.exe
Content Store administration involves creating, activating, and deactivating Content
Stores by using the iwstoreadm CLT. When the iwstoreadm -a storename command is
issued, the following sequence is triggered:
The iw.cfg file is checked to see if a store_directory_storename or
store_comment_storename entry exists. If either does, its definitions are used to
create the Content Store. If these entries do not exist, the Content Store is created as
described in the next bullet.
The Content Store directory is automatically created in C:\iw-store\ and
populated with a minimal Content Store containing a branch named main. The store
remains active until explicitly deactivated by using iwstoreadm -d (even if the
server is stopped and restarted).
Deactivating a store does not delete it. A store can be deactivated, moved to a new
location, and reactivated using original name (though it will be assigned a new store
ID).
Man Page Group
Content Store.
Usage
iwstoreadm [-h|-v] [-a store_name] [-d store_name] [-l]

-a store_name Activates an existing store, or creates and activates a new
store. You must have the Master role enabled in
iw-home\conf\roles\tsusers.xml to execute this option.
-d store_name Deactivates an existing store. You must have the Master
role enabled in iw-home\conf\roles\tsusers.xml to
execute this option.
-l Lists active stores.
Example
>iwstoreadm -l
Displays the active Content Stores:

Name Store Directory ID Comment
---- --------------- -- -------
default C:\iw-store\default 0x64
store2 C:\iw-store\store2 0x65

iwteamsite.exe
Available only if the service monitor feature of TeamSite is installed. Displays
information about the TeamSite iwtock watchdog daemon and lets you install or
uninstall iwtock as a service.
Man Page Group
System Services.
Usage
iwteamsite [-h|-v|-install|-uninstall|-d]

are specified.
-install Installs iwtock as a service. Fails if iwtock is already installed
as a service.
-uninstall Uninstalls iwtock as a service. Fails if iwtock is not already
installed as a service.
-d Execute iwtock as a command line process (useful for
debugging).
Exit Status

127 Exit was requested.
Notes
When you execute iwteamsite with an option, it exits upon completion (as opposed
to running as a daemon).
See TeamSite Administration Guide for more information about the service monitor
feature of TeamSite.
Interwoven, Inc. 82
iwtestcfg.exe
Returns the submit filtering operation that will be performed upon a file at submission
time. For more information about submit filtering, see the TeamSite Administration
Guide.
Man Page Group
System Services.
Usage
iwtestcfg [-h|-v] vpath

vpath Specifies a vpath to a file or directory (see page 13).
Example
>iwtestcfg /default/main/WORKAREA/andre/cgi/test.sh
returns:
Matched area "^/default/main/WORKAREA/.*$"
Matched fse ".*\.sh$"
Actions to do are:
omask=0111
which means that TeamSite is configured to set execute permissions on the specified file
at the time that the file is submitted.

iwtock
Available only if the service monitor feature of TeamSite is installed. Displays
information about the TeamSite iwtock watchdog daemon and lets you specify iw-home
and Content Store locations used by iwtock.
Man Page Group
System Services.
Usage
iwtock [-h|-v|] -H iwhomedirpath -s bckstoredirpath

are specified.
-H iwhomedirpath Specifies the location of iw-home used by iwtock. Must be a
full directory path name.
-s bckstoredirpath Specifies the location of the Content Store used by iwtock.
Must be a full directory path name.
Exit Status

127 Exit was requested.
Example
> iwtock -H “C:\Program Files\Interwoven\TeamSite” -s D:\iw-store\
Interwoven, Inc. 84
iwuser.exe
Enables you to manipulate TeamSite user information.
Man Page Group
System Information.
Usage
iwuser action ident [options]
where action is one of:
-create or -c Creates a new entry.

-delete or -d Deletes an existing entry.
-modify or -m Modifies an existing entry.
-query or -q Queries an entry only (default).
where ident is one of:
[-name] nm Works with entry whose name is nm.

-id eid Works with entry whose ID is eid.
-group Entry refers to an OS group.
-loc el Works with entry whose locator is el.
-role Entry refers to a TeamSite role.
-session s Extracts user name from session string s.
-user Entry refers to an OS user (default).
-tsuser Entry refers to a non-OS TeamSite user. Only valid for query
and delete operations.
Notes for ident

-user and -group are mutually exclusive.
Windows does not distinguish between -user and -group.
-session is mutually exclusive with -name and implies -user.
The syntax of an entry ID is T::SID: where : characters are significant. T should be
U for a user entry or G for a group. SID is a Windows SID (in hex).

Options Available for All Actions
-a Automatically creates user, group, or role if it does not already

exist.
-h Displays this help information and exit.
-v Displays version information and exit.
-D Use the local user database directly.
-F path Specifies the path of the local user database.
Options Available for Create Actions Only
-l nm[,nm...] Sets the list of aliases to nm,nm...

-g nm[,nm...] Sets the list of related groups to nm,nm...
Options Available for Modify Actions Only
-l nm[,nm...] Sets the list of aliases to nm,nm...

-la nm Adds name nm to list of aliases.
-ld nm Deletes name nm from list of aliases.
-g nm[,n...] Sets or replaces the list of related groups.
-ga nm Appends name nm to list of related groups.
-gd nm Deletes name nm from list of related groups.
-gi nm posnm Inserts nm before posnm in list of related groups.
-gp nm Prefixes name nm to list of related groups.
Notes to options for modify actions

-l and -g cannot be specified more than once; all others in this list may.
Options are processed in the order they are specified.
If nm contains a : then it is assumed to be an entity locator, otherwise it is treated as
a user or group name as appropriate.
Interwoven, Inc. 86
Options Available for All Actions Except Delete
-n Suppress inheritance from relatives.

-qa Show all user/group information (default).
-qg Print names of related groups (one per line).
-qi Print entry ID.
-qn Print local name alias.
-qr nm Print RELATED if group nm is related, print UNRELATED if
not.
Notes for all actions except delete

One or more of these may be specified. If more than one is present, the results are
printed in the same order, separated with blank lines.
Queries are done after create or modify actions.

iwuseradm.exe
Add and remove TeamSite users, change user attributes, manage authentication, view
and set user roles, specify default user interfaces.
Man Page Group
System Services.
Usage
iwuseradm -h [command]|-v
iwuseradm add-user user

iwuseradm add-user user -db user_db_id
iwuseradm administrable-branches-of-user user
iwuseradm all-roles-of-user user
iwuseradm description user
iwuseradm display-name user
iwuseradm email user
iwuseradm encrypt-userdatabase-pwd [-v]
iwuseradm id user
iwuseradm list-masters
iwuseradm list-userdatabases -l|-e|-a [-v]
iwuseradm list-users -t|-o|-a|-to|-tn|-l|-lo|-ln|-e
iwuseradm master user
iwuseradm modifiable-attributes-by-db user_db_id
iwuseradm modifiable-attributes-by-user user
iwuseradm preferred-ui user
iwuseradm remove-user user
iwuseradm set-email user email
iwuseradm set-id user id
Interwoven, Inc. 88
iwuseradm set-master user true|false
iwuseradm set-preferred-ui user ccpro|ccpro_only|ccstd|ccstd_only|none
-h command Displays iwuseradm usage information for command,

or general iwuseradm usage information if command is
omitted.
add-user user Creates a new TeamSite user named user who is an
OS user.
user -db Creates a new LDAP TeamSite user if user_db_id
user_db_id refers to an LDAP user database. Creates a new
external user if user_db_id refers to an external user
database.
administrable user Displays the administrable branches of user.
-branches-of-
user
all-roles-of- user Displays all the roles user has anywhere on the
user system.
description user Displays the value of the description attribute for
user.
display-name user Displays the value of the display-name attribute for
user.
email user Displays the value of the email attribute for user.
encrypt-userd -v Generates the encrypted version of a password for
atabase-pwd LDAP server login. If specified, -v verifies an
encrypted password. The password is passed to this
CLT through the environment variable
IWCLT_PASSWORD.
id user Displays the ID of user as defined by the tsid
attribute for non-OS users in tsusers.xml. This is the
ID used to represent a non-OS user in iwserver. Each
non-OS user must have a unique tsid setting.
list-masters Displays all master user names.
list-userdata -l Displays all LDAP servers.
bases
-e Displays all external user sources.
-a Displays all user sources.
-v Specifies verbose mode.
list-users -t Displays all TeamSite user names.
-O Displays all OS user names.
-a Displays all TeamSite user names and OS user names.
-to Displays all TeamSite OS user names.
-tn Displays all TeamSite non-OS user names.
-l Displays all TeamSite LDAP user names.

-lo Displays all TeamSite LDAP OS user names.

-ln Displays all TeamSite LDAP non-OS user names.
-e Displays all TeamSite external user names.
master user Displays the value of the master attribute for user,
indicating whether user is a master user.
modifiable-at user_db_id Displays attributes that can be modified by users
tributes-by-d defined in the LDAP user database user_db_id.
b
modifiable-at user Displays attributes that can be modified by user.
tributes-by-u
ser
preferred-ui user Displays the value of the preferred-ui attribute for
user.
remove-user user Deletes user from TeamSite.
set-email user email Sets the value of the email attribute of user to the
value specified by email.
set-id user id Sets the ID of user by setting the tsid attribute in
tsusers.xml. Only applies to existing non-OS users.
The value of id is used to represent a non-OS user in
iwserver, and must be greater than or equal to the
value of nextid in tsusers.xml to ensure that each
non-OS user has a unique tsid setting.
set-master user Sets the value of the master attribute for user to true
true|false or false, which determines the master user status of
user.
set-preferred user Sets the value of the preferred-ui attribute of user to
-ui ccpro, ccpro_only, ccstd, ccstd_only, or none.
ccpro Sets the preferred-ui attribute to ccpro, which makes
ContentCenter Professional the default interface for
the user.
ccpro_only Sets the preferred-ui attribute to ccpro_only, which
limits the user’s allowed interface to ContentCenter
Professional only.
ccstd Sets the preferred-ui attribute to ccstd, which makes
ContentCenter Standard the default interface for the
user
ccstd_only Sets the preferred-ui attribute to ccstd_only, which
limits the user’s allowed interface to ContentCenter
Standard only.
none Sets the preferred-ui attribute to none.
Examples
The following command lists all TeamSite and OS users.

>iwuseradm list-users -a
Interwoven, Inc. 90
The following command creates a TeamSite user dinesh who is also an OS user. The
password for dinesh is the same as that for his OS user account.
>iwuseradm add-user dinesh
The following command creates a TeamSite user dinesh who is not an OS user. The
password for dinesh is xyz123.
>iwuseradm add-user dinesh -n -p xyz123
The following command specifies ContentCenter Professional as the default user

interface for the user dinesh.
>iwuseradm set-preferred-ui dinesh ccpro
The following command displays whether the user dinesh is a master user.
>iwuseradm master dinesh
The following command specifies that the user dinesh is a master user.
>iwuseradm set-master dinesh true

iwutildreset.exe
Resets utility daemon configuration settings. Does not return any output when
successfully executed. For more information about the utility daemon, see the TeamSite
Administration Guide.
Man Page Group
System Services.
Usage
iwutildreset [-h host_name] [-p port_number] [-d ssl_dir]
-h host_name Configures the utility daemon to run on the specified host. If

-h is not specified, localhost is used.
-p port_number Configures the utility daemon to run on the specified port. If
-p is not specified, the default port is used (6689 unless it was
changed during installation or in iwutild.cfg).
-d ssl_dir Configures the utility daemon to use the specified secure
socket layer directory. If -d is not specified, the default SSL
directory (iw-home/local/config/ssl/iwutild_clt) is used.
Interwoven, Inc. 92
iwutildstat.exe
Displays active utility daemon operation statistics. For more information about the
utility daemon, see the TeamSite Administration Guide.
Man Page Group
System Services.
Usage
iwutildstat [-h host_name] [-p port_number] [-d ssl_dir] [-a]
-h host_name Displays information about the utility daemon running on the

specified host. If -h is not specified, localhost is used.
-p port_number Displays information about the utility daemon running on the
specified port. If -p is not specified, the default port is used
(6689 unless it was changed during installation or in
iwutild.cfg).
-d ssl_dir Displays information about the utility daemon using the
specified secure socket layer directory. If -d is not specified,
the default SSL directory is used.
-a Displays statistics for both active and completed operations.
Example
>iwutildstat -a
Returns:
Active operations:
ID Name Arg Duration
38 GetServerStats 0.000
Completed operations:
Name Count AvgDuration MinDuration MaxDuration
Connect 19 0.000 0.000 0.000
ExecuteCommandAsync 4 0.003 0.000 0.015
ResetConfig 2 0.007 0.000 0.015
GetServerStats 12 0.000 0.000 0.000

iwversion.exe
Returns the current TeamSite release information. It is often used as a test to see if the
TeamSite server is running. Executing iwversion makes a call to iwserver and reads
the version string from iwserver.
Man Page Group
System Information.
Usage
iwversion [-h|-v]

-v Displays the version string.
NOTE
When iwserver is running, iwversion displays the same result as iwserver -v.
iwversion -v displays the version string that is embedded into the iwversion CLT. If
you have installed patches, the two version strings may not be the same.
Example
>iwversion
returns:
iwserver: 6.7.0 Build 41235 Interwoven 20060328
Interwoven, Inc. 94
Chapter 3
Development Tools
This chapter describes the development CLTs from the following groups:
General Development Tools
Branch Operation Tools
Edition Operation Tools
Workarea Operation Tools
Version Management Tools
Workflow and Job Tools
Search and Index Tools
The CLTs are grouped and summarized in the following sections. Each CLT is then
presented in detail, arranged alphabetically.
General Development Tools

General development CLTs enable you to perform operations on, or retrieve information
about, the data in a specific file or TeamSite object. CLTs in this category are as follows:
Table 5 General development tools

iwattrib.exe Displays metadata information about any page 105
object in the TeamSite server, including all
branches, workareas, editions, staging areas,
files, directories, and symlinks.
iwauthen.exe Authenticates the user (by username) by page 113
checking the corresponding password.
iwckrole.exe Checks whether a user can log in with a page 117
particular role.
iwcp.exe Copies files. page 120
iwdecode.exe Decodes HTML-encoded %xx lines to ASCII page 121
lines.
iwencode.exe Encodes ASCII lines to HTML-encoded %xx page 123
lines.
iwextattr.exe Sets extended attributes on a file. page 127

Chapter 3: Development Tools
Table 5 General development tools

iwfilestate.exe Displays details about a file in a TeamSite page 129
workarea, edition or staging area.
iwldapmigrate.exe Creates a new version of tsusers.xml page 140
containing LDAP OS user information
previously stored in tsldapuserscache.xml.
Configures the LDAP server in
user_databases.xml.
iwldapsync.exe Synchronizes information about TeamSite page 146
users from one or more LDAP servers.
Modifies entries in tsusers.xml based on
configuration settings in user_databases.xml
and information obtained from LDAP servers.
iwlist.exe Displays a list of all subcomponents in a page 146
container. For example, iwlist displays all
servers, Content Stores, directories, editions,
workareas, and branches in a container.
iwmerge.ipl Merges files from one area into another. page 153
iwprop.exe Manipulates TeamSite user properties. page 170
iwrename.exe Renames a file, directory, workarea, edition, or page 177
branch.
iwvpath.exe Displays all or parts of the version path of a page 219
specified object.
Branch Operation Tools

Branch operation CLTs enable you to create and manipulate TeamSite branches. CLTs in
this category are as follows:
Table 6 Branch operation tools

iwmkbr.exe Creates a new TeamSite branch. page 154
iwrmbr.exe Deletes a TeamSite branch and all contained areas page 182
(workareas, staging areas, and editions).
Interwoven, Inc. 96
Edition Operation Tools

Edition operation CLTs enable you to create and manipulate TeamSite editions. CLTs in
this category are as follows:
Table 7 Edition operation tools

iwlasted.exe Displays the name of the last published edition on a page 139
branch.
iwnexted.exe Displays the name that would be autogenerated for the
next edition on a branch. page 169
iwpublish.exe Publishes the staging area. page 173
iwrmed.exe Deletes an edition. page 183
Workarea Operation Tools

Workarea operation CLTs enable you to create and manipulate TeamSite workareas.
CLTs in this category are as follows:
Table 8 Workarea operation tools

iwevents.exe Displays a history of submissions or updates of a page 124
workarea.
iwlistlocks.exe Lists the locks and assignments in a workarea and its page 149
parent branch.
iwlistmod.exe Lists all modified files and directories in a specified area. page 150
iwlock.exe Locks any file or directory in a specified area. page 151
iwlockinfo.exe Provides detailed information about any lock. page 152
iwmkwa.exe Creates a new TeamSite workarea. page 155
iwprv.exe Allows users to identify whether any file or directory in page 172
any workarea is marked private and automatically mark
any file as either private or public.
iwrmwa.exe Deletes a TeamSite workarea. page 188
iwsubmit.exe Submits a file, directory, or entire workarea to the page 211
staging area.
iwunlock.exe Unlocks any file or directory. page 216
iwupdate.exe Updates a TeamSite workarea with the version of a file page 218
or directory from another TeamSite area.

Version Management Tools

Version management CLTs return information about file revisions and versions, and
enable you to manipulate specific versions of files and directories. CLTs in this category
are as follows:
Table 9 Version management tools

iwcat.exe Displays any version of a (text) file in TeamSite. page 116
iwcmp.exe Compares any two TeamSite areas and displays a list page 118
of differences.
iwrevert.exe Reverts to a previous version of a file. page 179
iwrlog.exe Shows a revision log for a TeamSite file. page 180
Workflow and Job Tools

Workflow and job CLTs enable you to instantiate or destroy jobs, view the state of any
object in the workflow system, add files to a particular task, and otherwise interact with
running jobs. CLTs in this category are as follows:
Table 10 Workflow and job tools

iwaddtaskfile.exe Adds a file to a job task that is part of a job page 102
instance already created on the TeamSite
server.
iwaddtaskgroup.exe Adds groups to group tasks. page 103
iwaddtaskuser.exe Adds users to tasks. page 104
iwcallback.exe Tells the TeamSite server that the program page 115
corresponding to an external or cgi task is
finished. Passes a return code to the server.
iwdeltaskfile.exe Deletes a file that is attached to a TeamSite page 122
task.
iwgeteventcomments.exe Displays comments associated with a page 132
TeamSite workflow event.
iwgeteventfiles.exe Displays a list of files associated with a page 133
iwgettaskbyname.exe Writes the task ID to stdout for a task page 134
specified by name.
iwgetwfobj.exe Displays the state of any part of the server page 135
workflow subsystem in XML.
iwinvokejob.exe Starts a job whose instance has already been page 136
created on the TeamSite server.
Interwoven, Inc. 98
Table 10 Workflow and job tools (Continued)

iwjobc.exe Creates a job instance (based on a job page 137
specification file) on the TeamSite server.
iwjobvariable.exe Manipulates workflow variables. page 138
iwmvtaskfile.exe Renames a file that is attached to a TeamSite page 156
task.
iwqueryjobs.exe Displays a list of overall job information page 174
based on a query from stdin.
iwquerytasks.exe Displays a list of job task information based page 175
on a query from stdin.
iwretryjobop.exe Retries submission or task update after page 178
resolution of conflicts that originally
prevented those operations.
iwrmjob.exe Unconditionally removes an entire job page 184
instance from the TeamSite server.
iwrmtaskfile.exe Removes a file from a job task. page 185
iwrmtaskgroup.exe Removes groups from group tasks. page 186
iwrmtaskuser.exe Removes users from group tasks. page 187
iwsetjobdescription.exe Changes the description of a job. page 189
iwsetjobowner.exe Changes the owner of a job. page 190
iwsettaskattrib.exe Sets a new value for task attributes that have page 191
true or false values.
iwsettaskcomment.exe Assigns a comment to a TeamSite task. page 192
iwsettaskdescription.exe Assigns a description to a TeamSite task. page 193
iwsettaskfilecomment.exe Assigns a comment to a file associated with page 194
a TeamSite task.
iwsettaskownerandarea.exe Assigns an owner and workarea to a page 195
TeamSite task.
iwsettasktimeout.exe Changes the timeout value on an inactive page 196
task that already has a timeout.
iwtaketask.exe Assigns a shared task to a single user. page 212
iwtaskselect.exe Marks a usertask finished and selects a page 213
successor task.
iwtaskvariable.exe Creates, deletes, sets, and retrieves values of page 214
variables on a TeamSite task.
iwundochoice.exe Reverses a user-chosen transition from a user page 215
task or group task.
iwuntaketask.exe Removes the ownership of an active group
task. page 217

Search and Index Tools

Search and index CLTs enable you to administer the search manager and index manager,
control indexing operations on a per-branch basis, and perform various search
operations (including queries).
NOTE
Within CLTs and examples, you may find references to index server or search server.
These terms are used interchangeably with index manager and search manager,
respectively.
CLTs in this category are as follows:
Table 11 Search and index tools

iwldapsearch.exe Queries an LDAP directory. Also reports page 142
configuration information from iw.cfg on
TeamSite systems.
iwndxaddbr.exe Adds a branch to be indexed. page 157
iwndxfreezebr.exe Freezes or unfreezes the indexing of a branch. page 158
iwndxlistbr.exe Displays a list of indexed branches. page 159
iwndxmgrfreeze.exe Freezes or unfreezes the index manager. page 160
iwndxmgrstatus.exe Displays the current status of the index manager. page 161
iwndxmgrstop.exe Shuts down the index manager. page 162
iwndxpurgebr.exe Deletes the index collections associated with a page 163
branch.
iwndxrefreshbr.exe Reindexes a branch by putting it in the bulk or page 164
incremental queue.
iwndxrmbr.exe Removes indexing information for an indexed page 165
branch.
iwndxstatus.exe Displays the current index status for a list of page 166
specified branches from the index manager.
iwndxwamodificationsbr Enables or disables the indexing of workareas of page 168
.exe a specified branch (which is indexed by the
index server).
iwsrchattrib.exe Displays a list of indexed extended attributes or page 197
templating attributes.
iwsrchgethome.exe Displays the location of the search home page 200
directory.
iwsrchgetpage.exe Displays the results page of a search query. page 201
iwsrchmgrping.exe Pings the search manager. page 203
iwsrchmgrstop.exe Shuts down the search manager. page 204
Interwoven, Inc. 100

Table 11 Search and index tools (Continued)

iwsrchndxstatus.exe Displays the current index status for a list of page 205
specified branches from the search manager.
iwsrchndxstatuschg.exe Instructs the search manager to get the latest page 207
status of all indexed branches from the index
manager.
iwsrchquery.exe Queries the search manager. page 208

iwaddtaskfile.exe
Adds a file to a specified task in an instantiated job.
Man Page Group
Workflow/Job.
Usage
iwaddtaskfile [-h|-v] [-s servername] taskID path+ comment

-s servername Specifies the server on which the job is instantiated. Server
names can be specified by name or IP address.
taskID Specifies the task to which the file will be added. Task IDs are
represented as integers.
path Path, including name of the file to add, relative to area root.
comment Comment attached to the file.
Example
The following command adds the file /default/main/WORKAREA/eng/content.txt to

job 7734 on the server production.example.com (assuming the command is issued
from the eng directory):
>iwaddtaskfile -s production.example.com 7734 content.txt “This needs to
be reviewed”

iwaddtaskgroup.exe
Adds groups to group tasks.
Man Page Group
Workflow/Job.
Usage
iwaddtaskgroup [-h] [-v] [-s servername] taskID group
-h Print this message.

-v Print version.
-s servername Use servername as TeamSite server.
taskID ID of task to change.
group OS or TeamSite group to share task.
Example
>iwaddtaskgroup 343 graphics

iwaddtaskuser.exe
Adds users to tasks.
Man Page Group
Workflow/Job.
Usage
iwaddtaskuser [-h] [-v] [-s servername] taskID user

-v Print version.
user User to share task.
Example
>iwaddtaskuser -s eaglesmith 105 fred

iwattrib.exe
Displays metadata information about any object in the TeamSite server, including all
branches, workareas, editions, staging areas, files, directories, and symlinks.
Man Page Group
General Development.
Usage
To return information on a specific attribute of an object:

iwattrib objectvpath attribute
iwattrib -o objid [containervpath] attribute
To list available attributes for an object:

iwattrib -l objectvpath
iwattrib -l -o objid [containervpath]

objectvpath Vpath of the object (see page 13).
containervpath Vpath of the content store that contains the objid (Note: the
containervpath must start with /). Defaults to the store named
default.
-o objid Object ID of the object.
attribute Attribute to return information about.
-l Lists the attributes available for the specified object.
One possible returned attribute is flags. Typical returned iwattrib -o flag values
would look similar to:
0x00010000—directory
0x00100000—symlink
0x00000002—deleted
0x00040000—private
The iwattrib CLT can also return a value that is the result of a bitwise OR operation.
For example, for a file that is a directory and private, iwattrib returns the value:
0x00050000
which is the result of 0x0001000 | 0x0004000.

For a file that is a private XML document, iwattrib returns:

0x00440000
which is the result of 0x0040000 | 0x0004000.
Examples
>iwattrib -l main
returns the names of all the attributes available for the main branch:
cid
objid
crdate
creator
owner
group
name
label
moddate
busy
rootedition
firstedition
lastedition
parentbranch
archive
branchcount
editioncount
workareacount
>iwattrib main objid
returns the objid of the main branch:

0x00002250
>iwattrib main archive
returns the objid of the TeamSite archive containing the main branch:
0x000020200000000000000064
The values of attribute available for each type of object are:
Server
Table 12 Server attribute values

Name Example Description
cid 0x00000051 Class ID
objid 0x0000000000000000000000a Object ID
crdate Thu Aug 24 13:13:30 2004 Creation date
creator smtp Uid of the creator
owner smtp Uid of the owner

Table 12 Server attribute values (Continued)

group root Gid of the group for sharing
name IWSERVER Name
hostname chocolate Host name of the TeamSite server
ipaddress 0.0.0.0 IP address of the TeamSite server
verstring iwserver: 6.5.0 Build Version of TeamSite running on the
42325 Interwoven 200713 TeamSite server
Archive
Table 13 Archive attribute values

objid 0x00002025 Object ID
name default Name
label Default archive Comment attached at time of
creation
storage_path C:\Interwoven\Teamsite\iw- Path to the location of the Content
store Store
comment Marketing content. Description comment for the store
Branch
Table 14 Branch attribute values

objid 0x00002250000000000000006d Object ID
crdate Tue Aug 22 18:11:41 2004 Creation date
creator andre Uid of the creator
owner andre Uid of the owner
group marketing Gid of the group for sharing
name dev Name
label Main branch Comment attached at time of
creation
lockmodel submitlock The locking model chosen for the
branch
moddate Tue Aug 22 18:11:41 2004 Date modified
busy TRUE or FALSE Tells whether the branch is busy or
not

Table 14 Branch attribute values (Continued)

rootedition 0x000020100000000000000077 Object ID of the edition that the
or INITIAL branch is based on (-n returns the
name of the edition)
firstedition 0x00002010000000000000051e Object ID of the first edition on the
or INITIAL branch (-n returns the name of the
edition)
lastedition 0x000020100000000000000722 Object ID of the latest edition on the
or ed_0001 branch (-n returns the name of the
edition)
parentbranch 0x00002250000000000000006d Object ID of the parent branch (-n
or main returns the name of the branch)
archive 0x000020200000000000000001 Object ID of the archive (-n returns
or default the name of the archive)
branchcount 1 Number of subbranches present on
the branch (does not recurse to
sub-sub branches)
editioncount 2 Number of editions on the branch
workareacount 4 Number of workareas on the branch
Edition
Table 15 Edition attribute values

objid 0x000020100000000000000722 Object ID
crdate Mon Aug 28 13:45:57 2004 Creation date
name ed_0001 Name
label baseline edition Comment attached at time of creation
busy TRUE or FALSE Tells whether the edition is busy or not
rootdir 0x000010080000011a00000121 Object ID of the root directory of the
or \ edition (-n returns the name of the
directory)
nextedition 0x000020100000000000000722 Object ID of the edition after the
or ed_0002 specified edition (-n returns the name
of the edition)
prevedition 0x00002010000000000000051e Object ID of the edition before
or INITIAL the specified edition (-n returns the

Table 15 Edition attribute values (Continued)

publishdate Mon Aug 28 13:45:57 2004 The date on which the edition was
published
branch 0x000022500000000000000514 Object ID of the edition’s branch (-n
or dev returns the name of the branch)
sequenceno 1 Sequence number
Workarea
Table 16 Workarea attribute values

objid 0x000021000000000000000522 Object ID
name andre Name
label Andre’s workarea Comment attached at time of creation
moddate Thu Aug 24 13:13:30 2004 Date modified
modified TRUE or FALSE Tells whether the object has been
modified or not
busy TRUE or FALSE Tells whether the workarea is busy or
not
rootdir 0x000005220000000000000520 Object ID of the root directory of the
or / workarea (-n returns the name of the
directory)
baseedition 0x00002010000000000000051e Object ID of the edition that the
or INITIAL workarea is based on (-n returns the
branch 0x000022500000000000000514 Object ID of the workarea’s branch (-n
or dev returns the name of the branch)

Submit Event
Table 17 Submit event attribute values

edition 0x000020100000000000000140 Object ID of the edition associated with
the submit event
objid 0x0000225800000000000006bb Object ID of the submit event
workarea 0x000021000000000000000522 Object ID of the submitting workarea
submitter andre Uid of the user who submitted
sdate Mon Aug 28 13:45:43 2004 Date of submission
entries 5 Number of files and directories
submitted
submit_cmt first submit to staging Submit-level comment
area
submit_info keyword Info field
Update Event
Table 18 Update event attribute values

cid 0x0000225a Class ID
objid 0x0000225a0000000000000a9a Object ID of the update event
workarea 0x000021000000000000000522 Object ID of the updated workarea
updater andre Uid of the user who updated the
workarea
udate Mon Oct 2 16:57:12 2004 Date the workarea was updated
entries 59 Number of files and directories updated
Staging Area
Table 19 Staging area attribute values

objid 0x000022550000000000000521 Object ID
name STAGING Name

Table 19 Staging area attribute values (Continued)

label Comment attached at time of creation
moddate Thu Aug 24 13:13:06 2004 Date modified
modified
busy TRUE or FALSE Tells whether the staging area is busy
rootdir 0x000005210000000000000520 Object ID of the root directory of the
or / staging area (-n returns the name of the
directory)
branch 0x000022500000000000000514 Object ID of the staging area’s branch
or dev (-n returns the name of the branch)
File and Directory
Table 20 File and directory attribute values

objid 0x0000100842263b2340000005 Object ID
crdate Fri Sep 1 15:55:51 2004 Creation date
name index.html Name of the file or directory
label first submit Latest comment attached
moddate Fri Sep 1 16:24:13 2004 Date modified
modified
currdirectory 0x00001008422615e240000001 Object ID of the directory
containing the specified item (-n
returns the name of the directory)
area 0x000021000000000000000522 Object ID of the area containing the
specified item (-n returns the name
of the area)
areacid 0x00002100 Class ID of the area containing the
specified item
branch 0x000022500000000000000514 Object ID of the branch containing
the specified item (-n returns the
name of the branch)
archive 0x000020200000000000000001 Object ID of the archive containing
the specified item (-n returns the
name of the archive)
flags 0x00080000 Additional file information

Table 20 File and directory attribute values (Continued)

size 1949 Size of the file or directory (in
bytes)
lastuser andre User who last submitted the file
istagged TRUE or FALSE True if the file is locked
nfsmode 0x000001ff NFS permission bits
isdir TRUE or FALSE TRUE if the specified item is a
directory, FALSE if it is not
taglabel Locked by launching edit Comment attached to tag (for
example, a lock or assignment)
revisionnumber 3 Ordinal representing the version of
the file submitted on a branch
revisionbranch 0x000022500000000000000514 Object ID of the branch on which
this version of the file has been
submitted
submitevent 0x000022580000000000000ab8 Object ID of the submit event for
the most recent submission of this
file
history first submit Comments associated with file at
time of submission (includes both
submission comment and individual
file comment)
prevversion 0x0000052100000aea00000815 Object ID of the previous version
permissions interwoven\user1:Full Permissions for the file or directory
Control
(All),INTERWOVEN\Domain
Users:Special Access
(RWX),Everyone:Special
Access (RWX)
attrmoddate Fri Sep 1 15:55:51 2004 Timestamp when a file or directory
attribute was modified
fsmoddate Fri Sep 1 15:55:51 2004 Timestamp when file system was
modified

iwauthen.exe
Authenticates the user (by username) by checking the corresponding password. To
prevent the password from being displayed on the command line, the password is passed
to this CLT by the environment variable IWCLT_PASSWORD.
Man Page Group
General Development
Usage
iwauthen [-c|-d domain|-h|-v] user
-c Only checks if the username exists (does not use the password
for authentication).
-d domain Specifies the domain against which to authenticate the user
(when logging in to TeamSite on Windows servers).
user Specifies the user to authenticate.
Examples
>iwauthen -d sales bgunn
Returns:
0 and prints YES if the password is correct.
1 and prints NO if the password is not correct.
Returns a number greater than 1 if an error occurred while authenticating.
>iwauthen -c -d sales nyoung
Returns:
0 and prints YES if the username exists.
1 and prints NO if the username does not exist.
Returns a number greater than 1 if an error occurred while checking.
Notes
The iwauthen CLT is often used in conjunction with the iwckrole CLT as described in
the following scenario:

After installing TeamSite, a user cannot log into TeamSite. To find out why:
1. Run iwckrole.
The results will confirm whether or not the user is configured with the role with
which he or she is trying to log in. If iwckrole fails, there is a problem with the
user’s role, otherwise, continue to step 2.
2. Run iwauthen -c username to determine if the user is known to the system.
If it fails, then the user account is missing, otherwise, continue to step 3.
3. Run iwauthen username.
If it fails, the password being used for authentication is wrong.
For detailed information about the iwckrole CLT, see page 117.

iwcallback.exe
Notifies the server that the program corresponding to an <externaltask/> or
<cgitask/> is finished and passes the server a return code.
Man Page Group
Workflow/Job.
Usage
iwcallback [-h|-v] [-s servername] taskID returnCode [comment]

taskID Specifies the task to which the file will be added. Task IDs are
returnCode Specifies the notification given to the server upon program
completion. Represented as an integer from 0 to n.
comment An optional comment.
Example
The following command sends the return code 2 to the server production.example.com
when the program named in task 7734 finishes running:
>iwcallback -s production.example.com 7734 2

iwcat.exe
iwcat is cat for TeamSite files. If you specify a vpath to the file, you will see the
current version of the file in the area you specify. You can view any previous version of
a file by specifying the objid for that version.
Man Page Group
Version Management.
Usage
iwcat [-h|-v] filevpath
iwcat -o fileobjid directoryvpath

filevpath Vpath of the file to display (used to display the current version in
an area) (see page 13).
-o fileobjid Objid of the file to display (used to display any version).
directoryvpath Location of the file object.
Examples
>iwcat main/WORKAREA/andre/htdocs/about2.html
displays the version of about2.html in workarea andre.
>iwcat -o 0x0000007b0000007d000000bb main/STAGING
displays the version of the file that has the objid 0x0000007b0000007d000000bb (in this
case, the second most recent version of about2.html). directoryvpath can point to any
area containing the file.

iwckrole.exe
Checks whether the specified user has the specified role.
Man Page Group
Usage
iwckrole [-h|-v] role user

role author, editor, admin or master.
user Username of the person whose role you are checking.
Exits with 0 on successful authorization, non-zero on failure.
Example
>iwckrole admin andre
Returns:
YES

iwcmp.exe
Compares any two TeamSite areas and reports an exhaustive list of all modifications.
Man Page Group
Version Management.
Usage
iwcmp [-h|-v][-z] area1vpath area2vpath

-z Include submitted deletion/null comparisons and submitted
deletion/submitted deletion comparisons.
area1vpath Vpath of area1 (see page 13).
area2vpath Vpath of area2 (see page 13).
The output is in the form:

status-in-area1 status-in-area2 path-to-file-or-directory
where status is indicated by a combination of the following symbols:
- File or directory does not exist in this area.

f File exists.
d Directory exists.
s Symlink exists.
+ Item has been modified.
x File or directory has been deleted.
p File or directory is marked private.
Example
>iwcmp main/branch1/WORKAREA/wa1 main/branch1/WORKAREA/wa2
Returns:
x+ f htdocs/about.html
f+ - htdocs/about2.html
d+ - htdocs/support/
f+ - htdocs/main.html
f fp+ htdocs/products.html
showing that the file about.html has been renamed to about2.html in the first area, so
about.html appears as deleted and about2.html appears as new in the first workarea. A

directory named support has been created in the first area and does not exist in the
second. The file main.html only exists in the first area specified and has never existed
in the second area, and the file products.html exists in both areas, but in the second
area it has been marked private and modified.

iwcp.exe
Copies files from one location to another.
The iwcp CLT is different from iwupdate in that a file’s version history from the source
is not propagated to the destination. A new (modified) file is created regardless of the
source. Extended Attributes are preserved.
Man Page Group
Usage
iwcp [-h] [-v] [-r [-k]] [-s] src dst

-r Copy directories recursively.
-k Keep going when some files cannot be copied.
-s preserve symlinks while copying.
src File to be copied.
dest Destination for the file to be copied. Must be within a
workarea.
The source and destination can use a relative path (such as file_name) or an absolute
vpath (such as /default/main/WORKAREA/wa/file_name). Both source and destination
must be on the same store.
Example
Using absolute vpaths:

iwcp -r /myStore/main/WORKAREA/wa1/dir1 /myStore/main/WORKAREA/wa2
Using relative vpath of /iwmnt/default/myStore/WORKAREA/wa1/:

iwcp –r dir1 main/WORKAREA/wa2
Copy a specific directory from an edition to a workarea:

iwcp -r main/EDITION/ed_0001/dir main/myBranch/WORKAREA/wa1

iwdecode.exe
Decodes HTML-encoded %xx lines to ASCII lines. Receives HTML-encoded lines
through stdin.
Man Page Group
Usage
iwdecode [-h|-v]

Example
>iwdecode
Locked%20by%20launching%20edit
^D
Returns:
Locked by launching edit

iwdeltaskfile.exe
Deletes the file that is attached to a TeamSite task and updates the task by removing the
reference to that file. To remove only the file reference from the task (without deleting
the file), use the iwrmtaskfile CLT (page 185).
Man Page Group
Workflow/Job.
Usage
iwdeltaskfile [-h] [-v] [-s servername] taskid path

taskID ID of the task.
path Area relative path to delete from task and TeamSite.
Example
>iwdeltaskfile 1200 content/images/goingGoingGone.gif
where 1200 is the task ID and content/images/goingGoingGone.gif is a file to be

deleted from TeamSite.

iwencode.exe
Encodes ASCII lines to HTML-encoded %xx lines. Takes input from stdin.
Man Page Group
Usage
iwencode [-h|-v]

Example
>iwencode
Locked by launching edit
^D
Returns:

iwevents.exe
Displays a history of submissions or updates of a workarea, staging area, or edition.
Man Page Group
Workarea Operation.
Usage
iwevents [-h|-v] -s[ubmit]|-u[pdate] [-n[oheader]] [-i[ds]] [-a] vpath
latest|all
iwevents [-n[oheader]] id [store]

-s Gets a history of Submit operations.
-u Gets a history of update operations for a workarea.
-n Specifies not to generate header line.
-i Displays only the objids of the Submit or Get Latest events.
-a Excludes submit entries of anonymous editions with the
specified edition or staging area. Applicable only if all is
specified and vpath refers to an edition or staging area.
vpath Specifies a vpath to a workarea, edition, or staging area (see
page 13).
latest Gets only the latest submit or update.
all Gets all currently logged submits or updates.
id Specifies the objid for the event.
store Name of the backing store that contains the object; defaults to the
store named default.
When -s is specified, each entry has the following fields:
TIME time of submission

UPDATE type of update: ADD, MODIFY, DELETE, FORCEDELETE, or
FORCEMODIFY
TYPE DIRECTORY or FILE
PATH path of the file or directory submitted
USER user who submitted the file or directory
COMMENT comment attached to the file at time of submission
APPROVE TRUE or FALSE
EVENTID objid of the submit event

FILEID objid of the file

WORKAREAID objid of the workarea
REVISION Revision string of the file
When -u is specified, each entry will have the following fields:
TIME time of update

UPDATE type of update: ADD, MODIFY, DELETE
TYPE DIRECTORY or FILE
PATH path of the file or directory updated
USER user who performed the update
EVENTID objid of the update event
FILEID objid of the file
SOURCEAREAID objid of the area files were updated from
REVISION
Examples
>iwevents -s main/WORKAREA/andre all
Returns a history of all the submissions from workarea “andre” and includes the headers
for each entry:
TIME UPDATE TYPE PATH USER COMMENT
APPROVE EVENTID FILEID
WORKAREAID REVISION
[Fri Apr 21 11:49:13 2004] ADD DIRECTORY /htdocs/ andre <none>

FALSE 0x0001025800000000000000e2 0x0000007a00000079000000e3
0x00010100000000000000007b \main\1
[Fri Apr 21 11:59:37 2004] ADD FILE /htdocs/CorpGuide2.pdf andre <none>

FALSE 0x00010258000000000000011f 0x0000007b000000e400000117
0x00010100000000000000007b \main\1
[Fri Apr 21 11:59:37 2004] ADD FILE /htdocs/logo.PSD andre <none>

FALSE 0x00010258000000000000011f 0x0000007b000000e400000119
0x00010100000000000000007b \main\1
>iwevents -s -n main/WORKAREA/andre latest
Returns only the files submitted in the most recent Submit operation and strips the
headers:
[Fri Apr 21 11:59:37 2004] ADD FILE /htdocs/CorpGuide2.pdf andre <none>
FALSE 0x00010258000000000000011f 0x0000007b000000e400000117
x00010100000000000000007b
[Fri Apr 21 11:59:37 2004] ADD FILE /htdocs/logo.PSD andre <none>

FALSE 0x00010258000000000000011f 0x0000007b000000e400000119

0x00010100000000000000007b
>iwevents -u main/WORKAREA/andre all
displays a list of all files copied in to the workarea during all Get Latest operations and
includes the headers:
TIME UPDATE TYPE PATH USER
EVENTID FILEID
SOURCEAREAID
[Fri Apr 21 13:34:30 2004] MODIFY FILE /htdocs/index.html andre

0x0001025a000000000000013b 0x000001300000007d00000136
0x00010256000000000000007a

iwextattr.exe
Enables you to set, delete, and look up extended attributes of a file or directory. The file
or directory is specified with a vpath, including the server name. Extended attributes can
use any naming scheme, but one common method is to name attributes by general class,
then by their specific description. For example:
description/language=English
description/keywords=marketing, software, enterprise
The attributes mentioned above both fall into the descriptive category, but one stores
language information and the other stores keywords. You might also have attributes that
describe the file’s relationships to other files, such as its document of origin or the files
it links to, for example:
/relationships/source
/relationships/links/outbound
/description/keywords
/description/language
Man Page Group
Usage
iwextattr [-h|-v] [-s attribute=value|-g attribute|-d attribute|-l]
[-f] [-u] [-c] [-e] [-r regex] [-x] vpath

-s attribute=value Sets attribute to value.
-s attribute Sets attribute by reading a value from
stdin.
-g attribute Gets the value of attribute.
-d attribute Deletes attribute.
-l Lists attributes and values.
-f Reads/writes attribute value from
stdin/stout for -s and -g options.
-u UTF8 encode extended attribute values on
input, and decode on output.
-c Clears (deletes) all extended attributes for the
specified file.
-e Enumerates attribute names.
-r regex Uses regex to filter attribute names (requires
-l or -e).

-x Reads and writes XML with -s and -l

options.
vpath Full path to a file. Uses the form:
[//server]/archive{[/branch]+}
/{EDITION,WORKAREA}/dirpath
If no option is specified, attributes are listed as with -l.
When attribute values are printed, unprintable (non-ASCII) characters are outputted as *.
Examples
>iwextattr -s /description/language=English
Y:\default\main\dev\WORKAREA\andre\products\index.html
sets the /description/language attribute on the file products\index.html in

workarea andre.
>iwextattr -l Y:\default\main\dev\WORKAREA\andre\products\index.html
Displays a list of all the attributes on products\index.html, for example:

/relationships/source=products.doc
/relationships/links/outbound=/test.html;/mktg/index.html;/eng/index.html
/description/keywords=marketing,software,enterprise
/description/description=Overview of our suite of examples
/description/launch_date=March 19th, 1999
/description/expire_date=May 21st, 1999
/description/language=English
/description/contributors=Bob, Jerry, Phil
/description/audience=Marketing
>iwextattr -g /description/language
Y:\default\main\dev\WORKAREA\andre\products\index.html
Returns the value of the /description/language attribute on products\index.html,

for example:
English

iwfilestate.exe
Displays state information about a file in a TeamSite workarea (it also works for files in
an edition or staging).
NOTE
Unlike most CLTs, iwfilestate must be issued on the TeamSite server host.
Man Page Group
Usage
iwfilestate [-h|-v] [-f format] vpath [vpath...]
-h Displays help information.

-v Displays version information.
-f format Specifies output format. Where format is either:
• text. Human-readable text output (default)
• script. Terse text output, suitable for parsing
-i Includes user information in output (primarily for use with the
-session option).
vpath Full path to a file (multiple vpaths are supported). Uses the form:
/archive{[/branch]+}
/{EDITION,STAGING,WORKAREA}/dirpath
Example
>iwfilestate -f text /dev/main/dev/WORKAREA/bgunn/Makefile
Returns:
/dev/main/dev/WORKAREA/bgunn/Makefile
Conflict: No
Current: Yes
Modified: No
Editable: Yes
Not locked
Not assigned
If the script format is specified (instead of text), it would return the following:
conflict=no
current=yes
modified=no
editable=yes
locked=no
assigned=no

While the information returned for the text and script formats are the similar, the
script format is easier for CGIs and other programs to parse.
Notes
The conflict item states whether the file is in conflict with the staging area.
If vpath specifies a file in an edition or staging area, conflict is always no. It is
also no for workarea files that are not in conflict with the corresponding file in the
staging area. However, if a file has been modified in the workarea and a new version
was submitted to the staging area since the last Get Latest operation in the workarea,
then a conflict exists and the conflict item will be yes.
The current item states whether a file in a workarea is the same as the version in
the staging area.
If vpath specifies a file in a workarea and a more recent version of the file has been
submitted to the staging area since the last time a Get Latest operation was done in
the workarea, then current will be no. In all other cases, including files in an
edition or the staging area, current will be yes.
You can think of current as stating whether or not Get Latest will bring a more
recent version of the file into the workarea.
The modified item is yes for a file in a workarea that has been modified in some
way and is therefore eligible for Submit. It is no for files in a workarea that have not
been modified since the last Get Latest operation (and also for all files in editions or
staging areas).
The editable item states if the Edit functionality (buttons or menu items) for a file
is activated in the TeamSite GUI. It is yes if all of the following conditions have
been met:
The file is in a workarea
The user is allowed to modify the workarea
The user is allowed to write to the file
The file is not locked by another user or in a different workarea
Unless:
The Submit Locking model is in use for the branch, and:
The user’s role is not Author
The locked item states whether or not a file in a workarea has been locked in that
workarea’s branch. It is always no for files in editions or staging areas.
If the file is locked by the user invoking iwfilestate, the script format
returns:
locked=self
and the text format returns:

Locked by self

If the file is locked by a user other than the user invoking iwfilestate, the
script format returns:
locked=yes
owner=user_who_locked_the_file
workarea=name_of_workarea_that_holds_the_lock
and the text format returns:
Locked by user username in workarea workareaname
The assigned item is always no or Not Assigned (this item is not used currently
and will be removed in a future release).

iwgeteventcomments.exe
Displays comments associated with a TeamSite workflow event. For information about
supported workflow events, see the TeamSite Administration Guide.
Man Page Group
Workflow/Job.
Usage
iwgeteventcomments [-h|-v] [-s servername] jobID taskID time eventname

-s servername Specifies the TeamSite server to which to connect. It can be
specified by name or IP address. The default value is the current
TeamSite server.
jobID Specifies the job to report information about. Job IDs are
taskID Specifies the number of the task to report information about.
time The timestamp of the event (in seconds since epoch).
eventname Specifies the name of the event. For information about supported
workflow events, see the TeamSite Administration Guide.
Example
>iwgeteventcomments 1000 15 1093048309 TaskAddFile
Displays all comments associated with the TaskAddFile event from task 15 in job 1000
and having a timestamp of 1093048309.

iwgeteventfiles.exe
Displays a list of files associated with a TeamSite workflow event. For information
about supported workflow events, see the TeamSite Administration Guide.
Man Page Group
Workflow/Job.
Usage
iwgeteventfiles [-h|-v] [-s servername] jobID taskID time eventname

TeamSite server.
taskID Specifies the number of the task to report information about.
time The timestamp of the event (in seconds since epoch).
eventname Specifies the name of the event. For information about supported
workflow events, see the TeamSite Administration Guide.
Example
>iwgeteventfiles 1000 15 1093048309 TaskAddFile
Displays a list of files associated with the TaskAddFile event from task 15 in job 1000
and having a timestamp of 1093048309.

iwgettaskbyname.exe
Writes the task ID to stdout for a task specified by name.A non-zero exit status
indicates a non-normal command execution, such as no task was found with the
specified name.
Man Page Group
Workflow/Job.
Usage
iwgettaskbyname [-h] [-v] [-s servername] workflowID taskName

workflowID Job in which to look up task.
taskName Name of task to look up.
Example
>iwgettaskbyname 1000 My_Approval_Task
where 1000 is a job ID.

iwgetwfobj.exe
Displays the state of any part of the server workflow subsystem in XML. It can be called
in the following ways:
By passing no arguments, in which case it displays the workflow registry.
By passing a single job ID for a job that is still running, in which case it displays the
state of that job.
By a task ID, in which case it displays the state of that particular task.
By setting the -c option, in which case it displays all completed jobs that are
archived for TeamSite Reporting purposes.
Output format is described below in the “DTDs” section.
Man Page Group
Workflow/Job.
Usage
iwgetwfobj [-h|-v] [-r] [-c] [-s servername] [jobID|taskID]

-r Prints all objects below the specified object recursively.
-c Displays a list of all completed jobs that are archived for
reporting purposes.
TeamSite server.
taskID Specifies the task to report information about. Task IDs are
Example
The following command generates information about task 7734:
>iwgetwfobj 7734
DTDs
Output from iwgetwfobj conforms to the DTDs described in the “Job Specification
Files” chapter of the Workflow Developer’s Guide.

iwinvokejob.exe
Turns on or runs a job that has been instantiated in the server.
Man Page Group
Workflow/Job.
Usage
iwinvokejob [-h|-v] [-s servername] jobID

TeamSite server.
jobID Specifies which job to run. Job IDs are represented as integers.
Example
The following command starts job 7734 on the server production.example.com:

>iwinvokejob -s production.example.com 7734

iwjobc.exe
Instantiates a job into the server based on a specified job specification file and prints (in
decimal) the ID of the job.
Man Page Group
Workflow/Job.
Usage
iwjobc [-h|-v] [-i] [-s servername] workflowfile

-i Invoke job after compilation.
TeamSite server.
workflowfile Specifies the area-relative path name of the workflow
specification file.
Example
The following command instantiates the job defined in config.xml:

>iwjobc config.xml

iwjobvariable.exe
Manipulates workflow variables.
Man Page Group
Workflow/Job.
Usage
iwjobvariable [-h|-v] [-s servername]
[-g key|-c key value|-t key value|-d key] [-q] workflowid
-h Print help.
-v Print version.
TeamSite server.
-g key Get value of workflow variable key. Prints value to standard
output.
-c key value Create variable key with value value. It is an error if key already
exists.
-t key value Set variable key to value value. If variable key does not exist,
create it.
-d key Delete variable key.
-q Suppress all error messages.
workflowid Specifies the identifier of the workflow.
Example
>iwjobvariable -g foo
gets the value of the foo job variable.

iwlasted.exe
Displays the name of the most recent edition on a branch.
Man Page Group
Edition Operation.
Usage
iwlasted [-h|-v] [-k] branchvpath

-k Displays the name of the most recent edition on a branch which
may be published or unpublished.
Without this flag, the most recent edition that has been
published is returned.
branchvpath Vpath of a branch (see page 13).
Example
>iwlasted main
Returns:
ed_0001

iwldapmigrate.exe
Creates a new version of tsusers.xml containing LDAP OS user information
previously stored in tsldapuserscache.xml (which is not supported starting with
TeamSite 6.7.1 SP1). Also reads LDAP configuration information from iw.cfg and
uses it to configure the LDAP server in user_databases.xml. Runs automatically when
TeamSite 6.7.1 SP1 or later is installed on a system already hosting TeamSite and
configured to use an LDAP server. Can also be run from the command line. The
database created in user_databases.xml is named LDAP_USER_DB by default.
Man Page Group
Usage
iwldapmigrate [-h|-v|-i ldap_db_id]

-i ldap_db_id Specifies that the LDAP database defined in
user_databases.xml be named ldap_db_id rather than the
default name LDAP_USER_DB. If a database having the name
specified by ldap_db_id already exists, the database is instead
named by adding a numeric suffix to LDAP_USER_DB (for
example LDAP_USER_DB_1, LDAP_USER_DB_2, and so on).
Notes
The TeamSite server (iwserver) must not be running when this CLT is executed.
The original tsusers.xml file, if present, is renamed
tsusers.xml.backup_ldapmigrate_1. If that file name already exists, the next
available whole number is used for the file name suffix (for example,
tsusers.xml.backup_ldapmigrate_2).
When LDAP OS user information is migrated from tsldapuserscache.xml to

tsusers.xml, the value of userdbid in tsusers.xml is set to the ID of the LDAP
server.
If any user definitions exist in tsusers.xml prior to the execution of this CLT, they
are not automatically merged into the new version of tsusers.xml that is created
when the CLT is executed. If there are user definitions in the old version of
tsusers.xml (renamed tsusers.xml.backup_ldapmigrate_1) that you want to
retain, you must merge them manually into tsusers.xml after executing this CLT.
When this CLT executes, the only files that are modified are user_databases.xml
and tsusers.xml. All other configuration files (iw.cfg, tsldapuserscache.xml,
and so on) are left as-is in case a previous version of TeamSite needs to be restored.

A log file, /local/logs/iwldapmigration.log, is generated when this CLT is

executed.
If you install TeamSite 6.7.1 SP1 on a system hosting a previous version of
TeamSite, but that system was not configured to use an LDAP server, this CLT does
not execute during the TeamSite installation.
Example
>iwldapmigrate -i corp_ldap

iwldapsearch.exe
A search program to query an LDAP user database. Works similarly to the ldapsearch
utilities supplied by various LDAP vendors, but understands how to read TeamSite
configuration information from iw.cfg and user_databases.xml. Accepts similar
arguments to most ldapsearch utilities, but will read TeamSite configuration
information when available. Unlike most LDAP search utilities, iwldapsearch can also
use SSL for its queries. See the TeamSite Administration Guide for details about iw.cfg
and user_databases.xml.
Man Page Group
Usage
iwldapsearch [options] filter [attributes]
options See next table.

filter An RFC-1588 compliant LDAP search filter.
attributes A whitespace-separated list of attributes to retrieve. If no
attribute list is given, all are retrieved.
Options:
-b baseDn Distinguished name (DN) base location. Default is

o=interwoven,c=us.
-h hostName Name of the server where the LDAP database to be searched
resides. Default is localhost.
-p portNumber Port number of the server where the LDAP database to be
searched resides. Defaults are 389 for normal queries, 636 for
SSL.
-s scope Scope of the LDAP database to search. Legal values: base,
one, and sub. Default is sub.
-t user_db_id TeamSite ID of the LDAP database to search (the value of the
id attribute in the iwldap element in user_databases.xml). If
-t is specified, the parameters defined for user_db_id in
user_databases.xml are used for the search. If -t is not
specified, and if iwldapsearch is used on a system where a
TeamSite release prior to 6.7.1 SP1 is installed, the default
values for various parameters are replaced with values from
iw.cfg. See “Replacement Values” on page 143 for details.
-v Display informational messages. Default is OFF.
-w password Authentication password. Default is NULL.
-A Retrieve attribute names only (no values).
-D bindDN DN to bind with. Default is NULL.

-F separator Display the string separator instead of = between attribute

names and values.
-nodn Omit DN from the display for each record.
-nonewline Omit newline following each record.
-P path Name of the directory containing containing the SSL
Certificate Authority file. Default is the current directory.
-Z Enable SSL. Default is no SSL.
Replacement Values
When iwldapsearch is used on a system where TeamSite is installed, and if the -t

option is not specified, the default values for various parameters are replaced with
values from iw.cfg. The following parameters from the [authentication] section of
iw.cfg are used:
ldap_dnbase DN of search base; same as the -b option.

ldap_server LDAP host; same as the -h option.
ldap_port Port for non-SSL use; same as the -p option when SSL is not
used.
ldap_ssl_port Port for SSL use; same as the -p option when SSL is used.
ldap_ca_file Certificate Authority file to use for SSL. Same as the -P option.
ldap_account Bind account; same as the -D option.
ldap_pwd Bind password; same as the -w option.
Example
The configuration for LDAP database serverlab2w2k3-adam is as follows:

<iwldap id="serverlab2w2k3-adam" display_name="serverlab2w2k3-adam"
os="f">
<server value="serverlab2w2k3.tech.iwov">
</server>
<port value="389">
</port>
<search_key value="uid">
</search_key>
<dnBase value="(DC=interwoven,DC=com)">
</dnBase>
<account value="CN=Mary Baker,OU=ADAM users,DC=interwoven,DC=com">
</account>
<password
value="52616e646f6d4956c82bafa0f007058503dd695e09c991707efae0898fe54517">
</password>
<attr_email value="mail">
</attr_email>
<attr_display_name value="cn">

</attr_display_name>
<attr_sync name="businessCategory" value="admin,master,author,editor,
tsusers,ccpro,ccstd,ccpro_only,ccstd_only">
</attr_sync>
</iwldap>
Both of these queries give the same result when searching this database. The following
query uses the -t option so the search uses parameters specified for
serverlab2w2k3-adam in the userdatabases.xml file:
C:\Interwoven\cc2.1.1\output\nti86.DEV\src\clt>iwldapsearch -t
serverlab2w2k3-adam (businessCategory=master)
This query specifies the search parameters explicitly from the command line:
C:\Interwoven\cc2.1.1\output\nti86.DEV\src\clt>iwldapsearch -h
serverlab2w2k3.tech.iwov -b "DC=interwoven,DC=com" -s sub -D "CN=Mary
Baker,OU=ADAM users,DC=interwoven,DC=com" -w mbakerr
(businessCategory=master)
The output of either query is:

CN=Mary Baker,OU=ADAM users,DC=interwoven,DC=com
objectClass = top
objectClass = person
objectClass = organizationalPerson
objectClass = user
cn = Mary Baker
businessCategory = master
businessCategory = ccpro
distinguishedName = CN=Mary Baker,OU=ADAM users,DC=interwoven,DC=com
instanceType = 4
whenCreated = 20070313211643.0Z
whenChanged = 20070510181652.0Z
uSNCreated = 12423
memberOf = CN=Readers,CN=Roles,DC=interwoven,DC=com
memberOf = CN=Users,CN=Roles,DC=interwoven,DC=com
memberOf = CN=Administrators,CN=Roles,DC=interwoven,DC=com
uSNChanged = 86026
name = Mary Baker
badPwdCount = 0
badPasswordTime = 128233945717479133
pwdLastSet = 128221818245971619
objectSid =
lockoutTime = 0
objectCategory =
CN=Person,CN=Schema,CN=Configuration,CN={FCBD6315-491A-44B1-AC99-7F6699A7
9F98}
lastLogonTimestamp = 128232946127509645
uid = mbaker
mail = mbaker@interwoven.com
CN=Bob Brinker,OU=ADAM users,DC=interwoven,DC=com

objectClass = top
objectClass = person

objectClass = organizationalPerson
objectClass = user
cn = Bob Brinker
businessCategory = ccpro
businessCategory = master
distinguishedName = CN=Bob Brinker,OU=ADAM users,DC=interwoven,DC=com
instanceType = 4
whenCreated = 20070319220732.0Z
whenChanged = 20070319220732.0Z
uSNCreated = 73763
uSNChanged = 73763
name = Bob Brinker
badPwdCount = 0
badPasswordTime = 0
pwdLastSet = 128188156525309548
objectSid =
lockoutTime = 0
objectCategory =
CN=Person,CN=Schema,CN=Configuration,CN={FCBD6315-491A-44B1-AC99-7F6699A7
9F98}
uid = bbrinker
mail = bbrinker@interwoven.com

iwldapsync.exe
Synchronizes information about TeamSite users from one or more LDAP servers.
Modifies entries in tsusers.xml based on configuration settings in
user_databases.xml and information obtained from LDAP servers. Invoked when
iwserver is first started and periodically afterwards as specified by ldap_thread_delay
in the [authentication] section of iw.cfg. Can also be run manually from the
command line. Output is written to iw-home\local\logs\iwldapsync.log unless the
-t option is specified. See the TeamSite Administration Guide for details about editing
iw.cfg and user_databases.xml to configure what action is taken when
iwldapsync.exe is run.
Man Page Group
Usage
iwldapsync.exe [-h|-v|-t]

-t Test mode. When specified, no changes are made to
tsusers.xml, output is written to stdout, and no entries are
made in iwldapsync.log.

iwlist.exe
Displays list of all subcomponents in a container.
Man Page Group
Usage
iwlist [-h|-v] [-a|-l|-s] [-m [-u user]] [-i] [-k] vpath

-a Lists all the components of a branch.
-l Long listing.
-s Short listing.
-m Displays all files modifiable by user.
-u user Specifies the username of a TeamSite user (defaults to the current
user).
-i Displays branch name in UTF-8 format.
-k Displays all editions (published and implicit).
vpath Specifies the vpath of the parent area (see page 13).
Examples
>iwlist main
Returns:
branch1
branch2
Use the -a tag to include all editions and workareas on the branch.
>iwlist -a main
Returns:
wa1
wa2
INITIAL
ed_001
branch1
branch2

>iwlist -a -l main
Returns a full list of objids, comments, and base editions for all subbranches, workareas,
and editions on the branch:
wa1
andre’s workarea
2205
INITIAL
----------------------------------------------
wa2
chris’s workarea
2205
ed_0001
----------------------------------------------
----------------------------------------------
INITIAL
Initial empty edition
0
0
----------------------------------------------
ed_001
2205
INITIAL
1
----------------------------------------------
----------------------------------------------
branch1
test branch
2205
ed_002
----------------------------------------------
branch2
redesign branch
31001
INITIAL
----------------------------------------------

iwlistlocks.exe
Lists the locks and assignments in a workarea or branch. Displays the following
information: lock date, file path, workarea, state, creator/assigner, owner/assignee,
comments. To see if a file is locked, see the istagged attribute of iwattrib (page 112).
Man Page Group
Workarea Operation.
Usage
iwlistlocks [-h|-v] vpath

vpath Vpath to workarea or branch (see page 13).
Example
>iwlistlocks main
Returns a list of all the locks (including assignments) in all workareas on the main
branch. The information is in columns—date, path to the file relative to the workarea,
workarea containing the lock, status, user who locked the file, owner of the lock,
comments—as follows:
[Tue Aug 22 10:31:32 2000] /htdocs/about2.html wa1 LOCKED andre andre
[Tue Aug 22 10:34:15 2000] /htdocs/banner.gif wa1 ASSIGNED andre pat
add%20support%20section
[Tue Aug 22 10:34:40 2000] /htdocs/index.html wa1 DONE andre pat
added%20new%20links
[Tue Aug 22 10:36:29 2000] /htdocs/products.html wa2 LOCKED chris chris
<none>

iwlistmod.exe
Displays a list of all modified files and directories in the specified workarea or workarea
directory.
Man Page Group
Workarea Operation.
Usage
iwlistmod [-h|-v] vpath

vpath Vpath to a workarea or directory (see page 13).
In the output of iwlistmod:
x+ indicates a deleted file or directory
f+ indicates a modified or new file
d indicates a new directory
Examples
>iwlistmod /default/main/WORKAREA/andre
Returns:
x+ assets/images/iwhead60.gif
x+ assets/images/iwlogo49.gif
f+ html/support/testing_form.html
f+ html/support/index.html
f+ html/support/instructions.html
d html/newdir/
f+ index.html
>iwlistmod /default/main/WORKAREA/andre/html/support
Returns:
f+ testing_form.html
f+ index.html
f+ instructions.html

iwlock.exe
Locks any file in any TeamSite workarea. For a description of TeamSite locking, see the
ContentCenter online help.
Man Page Group
Workarea Operation.
Usage
iwlock [-h|-v] [-f|-s] vpath comment [ownerid]

-f Force update.
-s Suppress update.
vpath Specifies the file to lock.
comment Comment attached to the file.
ownerid Username of the lock owner.
Example
>iwlock branch1/WORKAREA/wa1/test.html 'need to use this for a while'
Locks the file test.html in the workarea wa1 on the subbranch branch1. The comment
attached is “need to use this for a while”. Because no owner is specified, the lock owner
is the user who locked it.
Forcing an update will take the version in the staging area to edit, regardless of whether
it is the newer version. Suppressing an update will take the version in the workarea,
regardless of whether it is newer than the version in the staging area.

iwlockinfo.exe
Provides detailed information on any lock held in TeamSite, such as who holds the lock
and in what workarea.
Man Page Group
Workarea Operation.
Usage
iwlockinfo [-h|-v] vpath

vpath Specifies a vpath to a file.
Example
>iwlockinfo main/branch1/WORKAREA/wa1/test.html
Returns:
Name: test.html
Area: wa1
Time Stamp: [Wed Mar 02 15:52:44 2005]
Assignor: andre
Assignee: andre
State: Locked
Comments: fixing some links
NOTE
test.html is locked in workarea wa1 by Andre, with the comment “fixing some links”
attached.
iwlockinfo main/branch1/WORKAREA/wa1/htdocs/index.html
Returns:
Name: index.html
Area: wa1
Time Stamp: [Wed Mar 02 15:52:44 2005]
Assignor: andre
Assignee: pat
State: Done
Comments: fix the marketing link.
fixed!
showing index.html in workarea wa1 has been assigned by Andre to Pat, and that Pat
has marked it Done. Comments attached to the file are “fix the marketing link. fixed!”

iwmerge.ipl
Merges files from one area into another.
Man Page Group
Usage
iwmerge [-h|-v] [-n] [-p] [-m|-c] [-a area] [files...]

-n Displays changes without updating files.
-p Writes merges to stdout.
-m Resolves non-overlapping merges.
-c Leaves annotated overlapping merge conflicts in file.
-a area Area to merge from. Defaults to STAGING.
files Specifies files to merge.

iwmkbr.exe
Creates a new TeamSite branch. For more information on creating TeamSite branches,
see the ContentCenter online help.
Man Page Group
Branch Operation.
Usage
iwmkbr [flags] parent brname comment rooted [ownerid [groupid]]
parent Vpath of the parent branch of the new branch (see page 13).
brname Name of the new branch.
comment Description of the new branch.
rooted Name of edition in the parent branch to serve as a basis for the
new branch.
ownerid Username of the owner of the new branch.
groupid OS or TeamSite group name of the group of Administrators that
has Administrator-level access to the new branch.
Flags

-ls Create branch with submit locking [default].
-lo Create branch with optional write locking.
-lm Create branch with mandatory write locking.
Example
>iwmkbr //IWSERVER/default/main branch1 'test branch' INITIAL andre
creates a subbranch called branch1 off of the main branch. The comment attached to
this branch is “test branch”. It is based on the initial edition of the main branch, and it is
owned by user andre. There is no group of Administrators for this branch (only andre
has Administrator-level privileges for the branch), and the locking model used is the
default, submit locking.

iwmkwa.exe
Creates a new TeamSite workarea on a branch. For more information on creating
TeamSite workareas, see the ContentCenter online help.
Man Page Group
Workarea Operation.
Usage
iwmkwa [-h|-v] branchvpath waname comment base_ed [ownerid [groupid]]

branchvpath Vpath of the branch to create the new workarea on (see page 13).
waname Name of the new workarea.
comment Comment attached to the workarea.
base_ed Specifies which edition on the branch to base the workarea on.
ownerid Specifies who owns the workarea.
groupid Specifies the OS or TeamSite group that has access to the
workarea.
Example
>iwmkwa main/branch1 wa1 '' INITIAL chrisc
This creates a workarea named wa1 on the subbranch branch1. No comment has been
attached to this workarea, and it is based on the initial edition of the branch and owned
by chrisc. This is a private workarea because no group has access to it.

iwmvtaskfile.exe
Renames a file that is attached to a TeamSite task.
Man Page Group
Workflow/Job.
Usage
iwmvtaskfile [-h] [-v] [-s servername] taskid src dest

taskid Task in which to move file.
src Source path (relative to area).
dst Destination path (relative to area).
Example
>iwmvtaskfile 1200 content/images/tobemoved.gif images/tobemoved.gif
where 1200 is a task ID and content/images/tobemoved.gif is a file to be moved to

images/tobemoved.gif.

iwndxaddbr.exe
Adds a branch to the index manager to be indexed. The branch might not be indexed
immediately by the index manager, depending on the current server load and the size of
the branch. Use iwndxstatus to verify whether the branch was indexed.
Man Page Group
Search and Index.
Usage
iwndxaddbr [-h|-v]
iwndxaddbr branchpath

branchpath Specifies the path of the branch to index.
Example
>iwndxaddbr /default/main
Returns:
Success.

iwndxfreezebr.exe
Freezes or unfreezes a branch to be indexed by the index manager. Freezing suspends all
indexing activity on that branch. Unfreeze resumes the indexing of the branch. Any
existing indexes for the branch are still available for query operations even if the branch
is frozen.
Man Page Group
Search and Index.
Usage
iwndxfreezebr [-h|-v|-u branchpath]
iwndxfreezebr branchpath

-u Unfreezes the specified branch.
branchpath Specifies the path of the branch to freeze or unfreeze.
Example
>iwndxfreezebr /default/main
freezes indexing on the /default/main branch and returns:

Success.
>iwndxfreezebr -u /default/main
unfreezes indexing on the /default/main branch and returns:

Success.

iwndxlistbr.exe
Displays a list of the paths of all fully and partially indexed branches.
Man Page Group
Search and Index.
Usage
iwndxlistbr [-h|-v]

Example
>iwndxlistbr
Returns a list similar to the following:

Indexed branches:
\\server1\default\main
\\server1\default\main\testBranch

iwndxmgrfreeze.exe
Freezes and unfreezes the index manager. Freezing suspends all indexing activities.
Unfreezing resumes all indexing activities.
Man Page Group
Search and Index.
Usage
iwndxmgrfreeze [-h|-v|-u]

-u Unfreezes the index manager.
Example
>iwndxmgrfreeze
Freezes the index manager and returns:

Success.
Notes
Once frozen, the index manager remains so until an unfreeze command is issued.
Use iwndxmgrstatus prior to iwndxmgrfreeze to determine whether the index
manager is already frozen.
You can perform search queries even if the index manager is frozen.

iwndxmgrstatus.exe
Displays whether the index manager is frozen.
Man Page Group
Search and Index.
Usage
iwndxmgrstatus [-h|-v]

Example
>iwndxmgrstatus
If the index manager is frozen, returns:

FROZEN.
If the index manager is not frozen, returns:

ACTIVE.

iwndxmgrstop.exe
Sends a shutdown command to the index manager.
Man Page Group
Search and Index.
Usage
iwndxmgrstop [-h|-v]

Example
>iwndxmgrstop
stops the index manager. This command does not display a return message.
NOTE
This command does not verify that the index manager shut down successfully. Check
the index log file or list of processes to verify index manager status.

iwndxpurgebr.exe
Deletes the index collections and all other indexing information associated with a
branch from the index manager’s memory and from the system’s disk.
Man Page Group
Search and Index.
Usage
iwndxpurgebr [-h|-v]
iwndxpurgebr branchpath

branchpath Specifies the path of the branch to purge.
Example
>iwndxpurgebr /default/main
Returns:
Success.
NOTE
Use caution when executing iwndxpurgebr. Unlike iwndxrmbr, iwndxpurgebr also
deletes the indexing information from the system’s disk. If, after issuing iwndxpurgebr,
you need to reindex this branch using iwndxaddbr, the entire indexing information will
need to be recreated.

iwndxrefreshbr.exe
Indexes a branch by putting it in the bulk or incremental queue. In general, use the bulk
queue to index a branch for the first time, and use the incremental queue to index
additional or modified files on a branch that is already indexed. Using the bulk queue
typically takes longer than using the incremental queue. However, if the index has not
been updated for a long time, using the incremental queue can be time consuming. In
these cases, it may be preferable to use the bulk queue so that the incremental queue
remains available for other updates.
Man Page Group
Search and Index.
Usage
iwndxrefreshbr [-h|-v]
iwndxrefreshbr [-b|-i] branchpath

-b Reindexes the branch by putting it in the bulk queue (default).
-i Reindexes the branch by putting it in the incremental queue.
branchpath Specifies the path of the branch (see page 13).
Examples
>iwndxrefreshbr -b /default/main
indexes /default/main using the bulk queue and returns:

Success.
>iwndxrefreshbr -i /default/main
reindexes /default/main using the incremental queue and returns:

Success.

iwndxrmbr.exe
Deletes the index collections and all other indexing information associated with a
branch from the index manager’s memory, but retains the information on the system’s
disk.
Man Page Group
Search and Index.
Usage
iwndxrmbr [-h|-v]
iwndxrmbr branchpath

branchpath Specifies the path of the branch to remove.
Example
>iwndxrmbr /default/main
Returns:
Success.
NOTE
Because this command removes indexing information just from memory (and not from
disk), reindexing a branch after using iwndxrmbr is much faster compared to using
iwndxpurgebr because the index manager can retrieve and use the relevant original
information rather than completely rebuild the index.

iwndxstatus.exe
Displays the current index status from the index manager for all indexed branches or a
list of specified branches. Output is in XML format.
Man Page Group
Search and Index.
Usage
iwndxstatus [-h|-v] -a [-f]
iwndxstatus [-f] branchpath1 branchpath2 ...

-a Displays the index status for all full- and partially-indexed
branches.
-f Generates output in a more readable format instead of the default
XML format.
branchpath1... Displays the index status for specified branch(es).
Example s
>iwndxstatus /default/main
Returns the index status of the /default/main branch on the index manager (similar to
the following):
<branch_index_status_list>
<branch_index_status>
<branch>
<serverid>010000000000000051000000</serverid>
<archiveid>640000000000000020200000</archiveid>
<branchid>0C0100000000000050220000</branchid>
</branch>
<vpath>/default/main</vpath>
<status>11</status>
<last_indexed_edition>testEdition1</last_indexed_edition>
<last_indexed_edition_creation_time>1089325560000</
last_indexed_edition_creation_time>
<freeze_status>UNFROZEN</freeze_status>
<workarea_index_status>TRUE</workarea_index_status>
<collection_list>
<collection>0100000000000000510000006400000000000000202000000C01000000000
00050220000_1</collection>
</collection_list>
</branch_index_status>

</branch_index_status_list>
>iwndxstatus -a
Returns the index status of all indexed branches on the index manager.
Notes
If the value inside the <last_index_edition> element starts with # (for example,
#4), the edition is most likely anonymous.
Values used in the <status> element are as follows:

10: Not indexed
11: Indexed
12: Partially indexed

iwndxwamodificationsbr.exe
Enables or disables the indexing of workareas of the specified branch (which is being
indexed by the index server).
Man Page Group
Search and Index.
Usage
iwndxwamodifcationsbr [-h|-v] branchpath
iwndxwamodifcationsbr [-h|-v] -u branchpath

branchpath Enables the indexing of workareas on the specified branch.
-u branchpath Disables the indexing of workareas on the specified branch.
Examples
>iwndxwamodificationsbr /default/main
Enables the indexing of the workareas on this branch, causing all modified files in these
workareas to be indexed and available for later searches.
>iwndxwamodificationsbr -u /default/main
Disables the indexing of the workareas on this branch, causing all modified files in these
workareas to not be available for later searches.

iwnexted.exe
Displays the name that would be automatically generated by the iwpublish -a
command for the next edition on a branch.
Man Page Group
Edition Operation.
Usage
iwnexted [-h|-v] branchvpath

branchvpath Specifies the vpath of the branch (see page 13).
Example
If the last edition on the main branch is named ed_0001,
>iwnexted main
Returns:
ed_0002
If the name of the last edition ends with a number, iwnexted will increment it. If it does
not, iwnexted will append a number to the name.

iwprop.exe
Manipulates TeamSite user properties.
Man Page Group
Usage
iwprop identity action options property ...
identity
[-name] nm Work with the entry whose name is nm.

-id eid Work with the entry whose ID is eid. The syntax of an entry ID
is either:
• user::NTID:
• group::NTID:
where NTID: is a Windows SID (in hex). At least one NTID:
should be specified.
-loc el Work with the entry whose locator is el.
-session s Extract user name from session string s. It is mutually exclusive
with -name (it implies -user).
action
-set or -s Modify or create one or more properties.

-get or -g Print the value of one or more properties (default).
-delete or -d Delete one or more existing properties.
options
-a Automatically create a user or group if it does not exist.

-h Display help information.
-v Display version information.
-D Use the local user database directly
-F path Specifies the path of the local user database
-n Suppress inheritance from related groups

property
For the -get and -delete action, one or more instances of the form:
[mode] [-key] K
where K specifies the property’s key. The -key is only required if K could be confused
with another command line option or contains an equal sign (=).
For the -set action, prop can have either of two forms:
[mode] K=V
[mode] [-key] K [-value V]
Where K is the property’s key and V is the new value. In the first form, V is assumed to
start immediately after the first equal sign (=). The second form can be used if K
contains an embedded equal sign (=); however, the -value argument must immediately
follow K or the property is assigned an empty value. Note that shell escape characters
may be required if K or V contains special characters such as a blank space or double
quotes (“...”).
If no property is specified, -get displays all properties. At least one property must be
specified for -set and -delete.
mode modifies the way key K of a property is matched and may cause a single property
to apply to more than one property. Valid modes are:
-exact or -e K must match the property key exactly (default).

-leading or -l K must be a leading substring of the property key.
-regex or -r K specifies a regular expression that matches the key.

iwprv.exe
Allows users to identify whether any file or directory in any workarea is marked private
and automatically mark any file as either private or public. For a full description of
private and public files and directories, see the ContentCenter online help.
Man Page Group
Workarea Operation.
Usage
iwprv [-h|-v] [-c|-g|-s] list-of-vpath

-c Clear the private bit.
-g Get the private bit (returns 0 if the item is not private, 1 if it is)
(default). This option can only accept one vpath.
-s Set the private bit.
list-of-vpath List of vpaths of files and directories to mark private (see
page 13). Entries must be separated by spaces.
Examples
>iwprv -s main/br1/WORKAREA/wa1/gifs main/br1/WORKAREA/wa1/mktg
main/br1/WORKAREA/wa1/index.html main/br1/WORKAREA/wa1/main.html
makes the directories gifs and mktg and the files index.html and main.html private.
>iwprv -g main/br1/WORKAREA/wa1/gifs
Returns: 1 (indicating that the item is private)
>iwprv -c main/br1/WORKAREA/wa1/gifs main/br1/WORKAREA/wa1/mktg

main/br1/WORKAREA/wa1/index.html main/br1/WORKAREA/wa1/main.html
makes these same files and directories no longer private.
>iwprv -g main/branch1/WORKAREA/wa1/test.html
Returns: 0 (indicating that the item is not private)

iwpublish.exe
Publishes the staging area on a branch. For more information on publishing editions, see
the ContentCenter online help.
Man Page Group
Edition Operation.
Usage
iwpublish -g [-w|-s] [-f] vpath area comment [ownerid]
iwpublish [-h|-v] [-w|-s] [-f] vpath area edition comment [ownerid]
-g Generates an edition name based on the last edition name.

-w Overrides conflicts.
-s Skips conflicts and files locked in another area.
-f Fails publish if there have been no changes since the last publish.
vpath Vpath of the branch whose area you want to publish. Can be a
full vpath (//server/archive/branch) or a relative path (as
shown in the example below).
area The vpath to the workarea or staging area you want to publish. If
a vpath to a workarea is given, the contents of the workarea are
submitted to staging, and then an edition based on the staging
area is published.
edition Name of the new edition.
comment Comment attached to the edition.
ownerid User ID of the owner of the branch.
Example
>iwpublish main/branch1 STAGING ed_002 'checkpoint'
publishes the staging area on the subbranch branch1 as edition ed_002 with the
comment “checkpoint” attached.

iwqueryjobs.exe
Reads a query from stdin and prints to stdout a list of job IDs that match the query
criteria. Query syntax is described in the DTD section.
Man Page Group
Workflow/Job.
Usage
iwqueryjobs[-h|-v][-x][-o offset][-m max][-l locale][-s servername]
<query

-x Returns output result in XML format.
-o offset Skips the first number of results specified by offset before
results are returned.
-m max Limits the number of returned results to the value specified by
max.
-l locale Specifies the locale for server-side sorting.
-s servername Specifies the server on which to check for matching query
criteria. Server names can be specified by name or IP address.
This is typically the TeamSite server.
<query The query to read from stdin.
Example
The following command searches for matching job IDs on the server
production.example.com:
>iwqueryjobs -s production.example.com
DTD
All queries must be in XML format that matches the following DTD:
<!ELEMENT wfquery (and|or|not|ownedby|active)>

<!ELEMENT and ((and|or|not|ownedby|active)+)>
<!ELEMENT or ((and|or|not|ownedby|active)+)>
<!ELEMENT not (and|or|not|ownedby|active)>
<!ELEMENT ownedby EMPTY>
<!ATTLIST ownedby v CDATA #REQUIRED>
!ELEMENT active EMPTY>
The ownedby element returns the job owned by the specified user. The active element
returns active jobs.

iwquerytasks.exe
Reads a query from stdin and prints to stdout a list of task IDs that match the query
criteria. Query syntax is described below in the DTD section.
Man Page Group
Workflow/Job.
Usage
iwquerytasks[-h|-v][-x][-o offset][-m max][-l locale][-s servername]
<query

-x Returns output result in XML format.
-o offset Skips the first number of results specified by offset before
results are returned.
-m max Limits the number of returned results to the value specified by
max.
-l locale Specifies the locale for server-side sorting.
-s servername Specifies the server on which to check for matching query
criteria. Server names can be specified by name or IP address.
This is typically the TeamSite server.
<query The query to read from stdin.
Example
The following command searches for matching task IDs on the server
>iwquerytasks -s production.example.com
DTD
All queries must be in XML format that matches the following DTD:
<!ELEMENT taskquery (and|or|not|ownedby|active|wfactive|wfownedby|

workflow|needsattention|type|sharedby|undoableby)>
<!ELEMENT and ((and|or|not|ownedby|active|wfactive|wfownedby|
workflow|needsattention|type|sharedby|undoableby)+)>
<!ELEMENT or ((and|or|not|ownedby|active|wfactive|wfownedby|
workflow|needsattention|type|sharedby|undoableby)+)>
<!ELEMENT not (and|or|not|ownedby|active|wfactive|wfownedby|
workflow|needsattention|type|sharedby|undoableby)>

<!ELEMENT ownedby EMPTY>

<!ATTLIST ownedby v CDATA #REQUIRED>
<!ELEMENT active EMPTY>
<!ELEMENT wfactive EMPTY>
<!ELEMENT wfownedby EMPTY>
<!ATTLIST wfownedby v CDATA #REQUIRED>
<!ELEMENT workflow EMPTY>
<!ATTLIST workflow v CDATA #REQUIRED>
<!ELEMENT needsattention EMPTY>
<!ELEMENT type EMPTY>
<!ATTLIST type v (usertask, grouptask, externaltask,
cgitask, submittask, updatetask, endtask,
dummytask, locktask, wftask) #REQUIRED>
<!ELEMENT sharedby EMPTY>
<!ATTLIST sharedby v CDATA #REQUIRED>
<!ELEMENT undoableby EMPTY>
<!ATTLIST undoableby v CDATA #REQUIRED>
Expression and Element Descriptions
Table 21 Query expressions and elements

Expression/Element Description
active Displays tasks which are active.
and, or, and not Standard logical operations.
needsattention Displays submit or update tasks that have stalled because of
conflicts and cgi tasks that are ready to be run.
ownedby Displays tasks owned by the specified user.
sharedby Displays group tasks that can be grabbed by the specified
user.
type Displays tasks of the specified type.
undoable Displays user or group tasks that can have their chosen
transitions taken back.
wfactive Displays tasks that belong to active jobs.
wfownedby Displays tasks that belong to jobs owned by the specified
user.
workflow Displays tasks that belong to the specified job.

iwrename.exe
Renames any file, directory, workarea, edition, or branch (except main) in TeamSite.
Man Page Group
Usage
iwrename [-h|-v] old_vpath new_vpath
iwrename [-h|-v] old_areavpath new_areaname

old_vpath Specifies a vpath to a file or directory to be renamed (see
page 13).
new_vpath Specifies the new vpath and name of the file or directory. If you
specify a new name without a vpath, the new file or directory is
created in the directory in which you run iwrename.
old_areavpath Specifies a vpath to a workarea, edition, or branch to be renamed.
new_areaname Specifies the new name (without vpath) of the workarea, edition,
or branch.
Examples
>iwrename main/branch1 test
changes the name of subbranch branch1 to test.
>iwrename main/test/WORKAREA/wa2 andre
changes the name of workarea wa2 to andre on the test subbranch.
> cd main/test/WORKAREA
> iwrename wa2 andre
changes the name of workarea wa2 to andre on subbranch test. The results are identical
to the preceding example; in this case no vpath was specified in the iwrename command
because wa2 is located in the working directory.

iwretryjobop.exe
Called when conflicts preventing successful completion of submit or update tasks have
been resolved.
Man Page Group
Workflow/Job
Usage
iwretryjobop [-h|-v|-o] [-s servername] taskID [comment]

-o Force submit or update.
taskID Specifies the task that will be retried. Task IDs are represented as
integers.
comment An optional comment.
Example
The following command retries task 7734 on the server production.example.com:

>iwretryjobop -s production.example.com 7734

iwrevert.exe
Gives command-line users the same revert functionality that is available from the
history screen in the TeamSite GUI. That is, a user can now revert to any version of a
file via the command line.
Man Page Group
Version Management.
Usage
iwrevert [-h|-v] vpath rev

rev Specifies the version of the file to revert to. rev can have any of
these formats:
• A revision string, as displayed by iwrlog or the History screen
in the TeamSite GUI (for example, /main/br/52)
• A number, indicating how many revisions back (for example, 3
to revert to three versions ago)
• The object id of the version of the file (obtainable through
iwrlog).

iwrlog.exe
Shows a revision log for the specified TeamSite file. Provides functionality similar to
RCS’s rlog for TeamSite files.
Man Page Group
Version Management.
Usage
iwrlog [-h|-v][-c][-m] vpath

-c Omits comments/labels from listing.
-m Displays log information in machine-parsable format. Paths and
comments are URL-encoded; fields are separated by tabs.
vpath Vpath to a file (see page 15).
Example
>iwrlog -c /default/main/branch1/WORKAREA/andre/htdocs/index.html
Returns the revision number, date, user, and area containing that version for each
version of the file:
file /default/main/branch1/WORKAREA/andre/htdocs/index.html (locked)
working revision /main/branch1/6+
----------------------------
name /htdocs/index.html
revision /main/branch1/6+
last modified Wed Jul 26 11:26:13 2000 by andre in area andre
size 16911
objid 0x0000478f0000479200004816
submit event objid N/A
----------------------------
revision /main/branch1/6
last modified Wed Jul 26 11:29:19 2000 by andre in area ed_0002
size 16919
objid 0x000048180000479d0000480f
submit event objid 0x00002258000000000000480e
----------------------------
last modified Wed Jul 26 11:26:13 2000 by andre in area ed_0001
size 16911

objid 0x000048060000479d00004805
submit event objid 0x000022580000000000004802
----------------------------
name index.html
last modified Wed Jul 26 11:24:35 2000 by andre
size 16904
objid 0x0000480600004804000047fa
submit event objid 0x0000225800000000000047f7
----------------------------
name index.html
last modified Tue Jul 25 18:59:51 2000 by andre
size 1206
objid 0x00004806000047f9000047b7
submit event objid 0x0000225800000000000047b4
----------------------------
name index.html
size 4
objid 0x00004806000047b6000047ac
submit event objid 0x0000225800000000000047a9
----------------------------
name index.html
size 0
objid 0x00004806000047ab000047a1
submit event objid 0x00002258000000000000479b
==================================================================
total revisions: 7
==================================================================

iwrmbr.exe
Removes the specified branch and all of its contents from TeamSite. For more
information on deleting TeamSite branches, see the ContentCenter online help.
Man Page Group
Branch Operation.
Usage
iwrmbr [-h|-v] branchvpath
iwrmbr [-h|-v] parentvpath brname

branchvpath Vpath of the branch to be deleted (see page 13).
parentvpath Vpath of the parent branch (see page 13).
brname Name of the branch to be deleted.
Example
>iwrmbr main branch1
removes the subbranch branch1 from the main branch.

iwrmed.exe
Deletes any edition on a branch. For more information on deleting TeamSite editions,
see the ContentCenter online help.
Man Page Group
Edition Operation.
Usage
iwrmed [-h|-v] branchvpath edition

branchvpath Vpath of the branch on which the edition is located (see page 13).
edition Name of the edition to be removed.
Example
>iwrmed main/branch1 ed_001
removes the edition ed_001 from the subbranch branch1.

iwrmjob.exe
Unconditionally removes a job instance from the server. Only use as a last resort.
Man Page Group
Workflow/Job.
Usage
iwrmjob [-h|-v] [-s servername] jobID

jobID Specifies the job that will be removed. Job IDs are represented as
integers. Multiple job IDs may be specified.
Example
The following command removes job 7734 from the server production.example.com:
>iwrmjob -s production.example.com 7734

iwrmtaskfile.exe
Removes a file from a specific task in an instantiated job.
Man Page Group
Workflow/Job.
Usage
iwrmtaskfile [-h|-v] [-s servername] taskID file

taskID Specifies the task from which the file will be removed. Task IDs
are represented as integers.
file Specifies the area-relative path of the file that will be removed
from the job task.
Example
The following command removes the file /default/main/WORKAREA/eng/content.txt

from job 7734 on the server production.example.com (assuming the command is
issued from the eng directory):
>iwrmtaskfile -s production.example.com 7734 content.txt

iwrmtaskgroup.exe
Removes groups from group tasks.
Man Page Group
Workflow/Job.
Usage
iwrmtaskgroup [-h] [-v] [-s servername] taskID group

-v Print version.
group OS or TeamSite group to remove from task.
Example
>iwrmtaskgroup -s darkstar 1973 approvers

iwrmtaskuser.exe
Removes users from group tasks.
Man Page Group
Workflow/Job.
Usage
iwrmtaskuser [-h|-v] [-s servername] taskID user

-v Print version.
user User to remove from task.
Example
>iwrmtaskuser -s factotum 420 bukowski

iwrmwa.exe
Removes the specified workarea. For more information on deleting workareas, see the
ContentCenter online help.
Man Page Group
Workarea Operation.
Usage
iwrmwa [-h|-v] branchvpath workarea

branchvpath Vpath of the branch on which the workarea is located (see
page 13).
workarea Name of the workarea to be removed.
Example
>iwrmwa main/branch1 wa1
removes the workarea wa1 from the subbranch branch1.

iwsetjobdescription.exe
Changes the description of a job.
Man Page Group
Workflow/Job.
Usage
iwsetjobdescription [-h|-v] [-s servername] workflowID description

-v Print version.
workflowID ID of job to change.
description New description for job.
Example
>iwsetjobdescription 344 2002_press_releases

iwsetjobowner.exe
Changes the owner of a job.
Man Page Group
Workflow/Job.
Usage
iwsetjobowner [-h|-v] [-s servername] workflowID owner

-v Print version.
workflowID ID of job to change.
owner New owner for job.
Example
>iwsetjobowner -s beavis 112 nickSaloman

iwsettaskattrib.exe
Sets a new true or false value for a task attribute (for example, read-only or lock).
Man Page Group
Workflow/Job.
Usage
iwsettaskattrib [-h|-v] [-s servername] taskid name value
-h Print help message.

-v Print version.
taskid ID of task to change.
name Name of attribute to modify.
value New value for attribute. Valid values are t (true) and f (false).
Example
>iwsettaskattrib -s maynard 462 readonly f

iwsettaskcomment.exe
Assigns a comment to a TeamSite task.
Man Page Group
Workflow/Job.
Usage
iwsettaskcomment [-h|-v] [-s servername] taskID comment

comment Comment to set.
Example
>iwsettaskcomment 420 "All content looks valuable here. Tech Pubs is doing
a great job!"

iwsettaskdescription.exe
Modifies an existing TeamSite task description.
Man Page Group
Workflow/Job.
Usage
iwsettaskdescription [-h|-v] [-s servername] taskID description

description New description for task.
Example
>iwsettaskdescription 1200 "Add images to content"

iwsettaskfilecomment.exe
Assigns a comment to a file associated with a TeamSite task.
Man Page Group
Workflow/Job.
Usage
iwsettaskfilecomment [-h|-v] [-s servername] taskID path comment

path Area relative path of file.
comment Comment to set.
Example
>iwsettaskfilecomment 1200 images/homebase.gif "Great image of home base."

iwsettaskownerandarea.exe
Assigns an owner and workarea to a TeamSite task.
Man Page Group
Workflow/Job.
Usage
iwsettaskownerandarea [-h] [-v] [-s servername] taskid owner areavpath

owner New owner for task.
areavpath New vpath for task.
Example
>iwsettaskownerandarea 1200 INTERWOVEN\jsmith \default\main\web
\WORKAREA\smith

iwsettasktimeout.exe
Changes the timeout value on an inactive task that already has a timeout successor
specified in the original job specification.
Man Page Group
Workflow/Job.
Usage
iwsettasktimeout [-h|-v] [-s servername] taskid timeout

timeout New timeout value (using the format: +HHHHMM or
MMDDYYYYHHMM).
Examples
>iwsettasktimeout 1200 +002400
>iwsettasktimeout 1200 122520020600

iwsrchattrib.exe
Displays an XML formatted list of indexed extended attributes or FormsPublisher
templating attributes.
Man Page Group
Search and Index.
Usage
iwsrchattrib [-h|-v|-e|-t template_data_type]

-e Displays the extended attribute list (default).
-t Displays the templating attribute list.
template_data_typ Specifies the path of the template data type (as determined by
e the data_category/data_type directory structure used by
FormsPublisher).
Examples
>iwsrchattrib -t iw-home/examples/Templating/templatedata/internet/pr
Returns a list of indexed attributes for the FormsPublisher pr data type (residing in the
internet data category).
>iwsrchattrib -e
Returns a list of all extended attributes registered with the index manager, such as:
<attr>
<name>Indexed</name>
<type>int</type>
</attr>
<attr>
<name>TeamSite/Templating/PrimaryDocumentType</name>
<type>string</type>
</attr>
<attr>
<name>TeamSite/Templating/PrimaryDCR</name>
<type>string</type>
</attr>

<attr>
<name>OwningAreaId</name>
<type>long</type>
</attr>
<attr>
<name>AreaRelativePath</name>
<type>string</type>
</attr>
<attr>
<name>TeamSite/Templating/DCR/Type</name>
<type>string</type>
</attr>
<attr>
<name>BranchId</name>
<type>long</type>
</attr>
<attr>
<name>CreateDate</name>
<type>date</type>
</attr>
<attr>
<name>IndexedDate</name>
<type>date</type>
</attr>
<attr>
<name>Creator</name>
<type>string</type>
</attr>
<attr>
<name>LastModifier</name>
<type>string</type>
</attr>
<attr>
<name>Version</name>
<type>int</type>
</attr>
<attr>
<name>Size</name>
<type>int</type>
</attr>

<attr>
<name>LastModifiedDate</name>
<type>date</type>
</attr>
<attr>
<name>Title</name>
<type>string</type>
</attr>

iwsrchgethome.exe
Displays the location of the search home directory.
Man Page Group
Search and Index.
Usage
iwsrchgethome [-h|-v]

Example
>iwsrchgethome
Returns:
>$G:\Interwoven\search\output\nti86.DEV\src\tests\java\dummy.

iwsrchgetpage.exe
Displays a page of results from a query previously performed by iwsrchquery.
Man Page Group
Search and Index.
Usage
iwsrchgetpage [-h|-v]
iwsrchgetpage userID queryID start page_size

userID Specifies a valid TeamSite user ID.
queryID Specifies the value of <query_id> as returned by the
previously performed query.
start Specifies the index of the first query result to return (that is,
the starting point for returning query results)
page_size Specifies the number of returned query results per page.
Example
>iwsrchgetpage AJUBA\user1 CMQB9ZZ4 5 5
Returns a results page from query ID CMQB9ZZ4 starting at result index 5 and containing
up to 5 query results (although in this case there were only 2 matching results, so only 2
are displayed). The user has the valid TeamSite ID user1 on the AJUBA domain. Results
could appear as follows:
<data>
<query_id>CMQB9ZZ4</query_id>
<result>
<vpath>//jzhuangd2ks/default/main/STAGING/Copy (3) of
test1.txt</vpath>
<rank>5000.0</rank>
</result>
<result>
test1.txt</vpath>
<rank>5000.0</rank>
</result>
<return_code>0</return_code>
</data>

Notes
To display, for example, 500 results in 50-result blocks, enter values as follows for
start and page_size in consecutive iwsrchgetpage commands:
0 50
50 50
100 50
150 50
and so on.
The value shown in <rank> is the document hit score. It can range from 0 to 10000,
with higher values representing more hits.

iwsrchmgrping.exe
Pings the search manager and displays response time.
Man Page Group
Search and Index.s
Usage
iwsrchmgrping [-h|-v]

Example
>iwsrchmgrping
Returns:
The response time for search manager is: 15 ms

iwsrchmgrstop.exe
Sends a shutdown command to the search manager.
Man Page Group
Search and Index.
Usage
iwsrchmgrstop [-h|-v]

Example
>iwsrchmgrstop
stops the search manager. This command does not display a return message.
NOTE
This command does not verify that the search manager shut down successfully. Check
the list of processes to verify search manager status.

iwsrchndxstatus.exe
Displays the current index status from the search manager for all indexed branches or a
list of specified branches. Output is in XML format.
Man Page Group
Search and Index.
Usage
iwsrchndxstatus [-h|-v] -a [-f]
iwsrchndxstatus [-f] branchpath1 branchpath2 ...

-a Displays the index status for all full- and partially-indexed
branches.
-f Generates output in a more readable format instead of the default
XML format.
branchpath1... Displays the index status for specified branch(es).
Examples
>iwsrchndxstatus /default/main
Returns the index status of the /default/main branch on the search manager (similar to
the following):
<branch_index_status_list>
<branch_index_status>
<branch>
<serverid>010000000000000051000000</serverid>
<archiveid>640000000000000020200000</archiveid>
<branchid>0C0100000000000050220000</branchid>
</branch>
<vpath>/default/main</vpath>
<status>11</status>
<last_indexed_edition>testEdition1</last_indexed_edition>
<last_indexed_edition_creation_time>1089325560000</
last_indexed_edition_creation_time>
<workarea_index_status>TRUE</workarea_index_status>
<collection_list>
<collection>0100000000000000510000006400000000000000202000000C010000000
0000050220000_1</collection>
</collection_list>
</branch_index_status>
</branch_index_status_list>

>iwsrchndxstatus -a
Returns the index status of all indexed branches as known to the search manager.
Notes
If the value inside the <last_index_edition> element starts with # (for example,
#4), the edition is most likely anonymous.
Values used in the <status> element are as follows:

10: Not indexed
11: Indexed
12: Partially indexed

iwsrchndxstatuschg.exe
Instructs the search manager to get the latest status of all the indexed branches from the
search manager.
Man Page Group
Search and Index.
Usage
iwsrchndxstatus [-h|-v]

Examples
>iwsrchndxstatuschg
Returns:
Success.
NOTE
Under normal circumstances, the index manager automatically notifies the search
manager of any index changes. This CLT is provided as a manual way of performing
that task in case the index manager is brought down or fails after it has indexed a branch
but before it can notify the search manager of the changes.

iwsrchquery.exe
Executes a query on the search manager and returns the first page of the query in XML
format. Use iwsrchgetpage to display additional pages.
Man Page Group
Search and Index.
Usage
iwsrchquery [-h|-v]
iwsrchquery [-s] [-f queryStrFile] userID pageSize branchpath areapath

-s Performs schema validation.
-f Specifies a query string in a file. You are prompted for a query if
you execute iwsrchquery without setting this option.
queryStrFile Specifies the name of the query string file.
userID Specifies a valid TeamSite user ID.
pageSize Specifies the number of returned query results per page.
branchpath Specifies the path of the branch to which the query is applied.
areapath Specifies the TeamSite area to which the query is applied. This
can be an absolute path or a path relative to the branch.
Examples
>iwsrchquery -f C:\queries\query1.txt AJUBA\user1 5
\\server1\default\main \\server1\default\main\STAGING
Returns the first page (containing up to 5 query results) resulting from the query defined
in the file C:\queries\query1.txt. The user has the valid TeamSite ID user1 on the
AJUBA domain. The query is applied to the staging area on the default\main branch of
the system server1. The query defined in query1.txt could appear as follows:
<predicate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="TeamSiteSearch.xsd">
<accrue>
<fulltext-any>
<term>vdk</term>
</fulltext-any>
<fulltext-any>
<term>modified</term>
</fulltext-any>
</accrue>
</predicate>

Depending on the contents of the staging area, output similar to the following is
displayed:
<data>
<query_id>CMQB9ZZ4</query_id>
<result>
<vpath>//jzhuangd2ks/default/main/STAGING/test1.txt</vpath>
<rank>5000.0</rank>
</result>
<result>
<vpath>//jzhuangd2ks/default/main/STAGING/Copy of test1.txt</vpath>
<rank>5000.0</rank>
</result>
<result>
test1.txt</vpath>
<rank>5000.0</rank>
</result>
<result>
test1.txt</vpath>
<rank>5000.0</rank>
</result>
<result>
test1.txt</vpath>
<rank>5000.0</rank>
</result>
<return_code>0</return_code>
</data>
>iwsrchquery AJUBA\user1 5 \\server1\default\main

\\server1\default\main\STAGING
In this example no query file is specified, so you are prompted to enter a query:
Please enter the query below. Press Ctrl+C to quit.
Enter the query on the command line. If you enter it as shown in the preceding example
(the contents of query1.txt), the output displayed is identical to the output shown in
preceding example. To run a query that you enter on the command line, press return
after entering </predicate>. The command recognizes that that is the end of the query
and executes the query immediately.
Notes
The schemas are described in this manual in Appendix D, “Search Query Schemas.”
Performing schema validation with the -s option increases search response time.
Use iwsrchgetpage to view additional query result pages. Use the ID specified by
<query_id> in the first page’s output to specify the query in iwsrchgetpage.

The value shown in <rank> is the document hit score. It can range from 0 to 10000,
with higher values representing more hits.
If queryStrFile contains multi-byte characters, it needs to be saved in UTF-8
encoding for the CLT to run properly.

iwsubmit.exe
Submits any TeamSite workarea, file, or directory to the staging area. For a full
description of submitting files to the staging area, see the ContentCenter online help.
Man Page Group
Workarea Operation.
Usage
iwsubmit [-h|-v] [-s] [-w|-x] [-u] [-r] [-c global_comment]
[-i info_comment] {vpath file_comment}+
iwsubmit [-h] [-v] [-s] [-w|-x] [-u] [-r] [-c global_comment]

[-i info_comment] -f file_name
-c global_comment Comment to attach to the submit event.

-i info_comment Second comment to attach to the submit event.
vpath One or more vpaths to a file, directory, or workarea (see
page 13).
file_comment Comment to attach to the file, directory, or workarea specified.
-f file_name File from which to read the vpath and file_comment. Use
newline to separate vpath and file_comment). If file_name is -,
the information is read from stdin.
Flags

-s Skips conflicts and locked files.
-w Overwrites all files. Files in STAGING but not in src_area are
deleted.
-x Overwrites conflicts.
-u Unlocks locked files.
-r Reports on submitted files.
Example
>iwsubmit -w -u -c 'updated support info' -i 'keyword'
main/WORKAREA/andre/htdocs/index.html 'added imagemap'
Submits the file index.html to the staging area, with the comment “added imagemap”
attached to the file. The comments for the submit operation are “updated support info”
and “keyword”. If index.html is locked, this operation will unlock it. If the version in
the staging area is newer, this operation will overwrite it.

iwtaketask.exe
Assigns a shared task to a specified user.
Man Page Group
Workflow/Job.
Usage
iwtaketask [-h|-v] [-s servername] taskID username

taskID Specifies the task that will be assigned. Task IDs are represented
as integers.
username Specifies the user who will receive the task assignment.
Example
The following command assigns task 7734 on the server production.example.com to

user Andre:
>iwtaketask -s production.example.com 7734 Andre

iwtaskselect.exe
Marks a usertask finished and chooses which <successorset/> element to signal.
Man Page Group
Workflow/Job.
Usage
iwtaskselect [-h|-v] [-s servername] taskID choice [comment]

taskID Specifies the task that will be marked finished. Task IDs are
choice Specifies the index (starting from 0) of the <successorset/>
element in the <successors/> section of the task's configuration.
comment Optional comment.
Example
The following command marks task 7734 done on the server production.example.com
and signals the third <successorset/> element in that task’s <successors/> section:
>iwtaskselect -s production.example.com 7734 2

iwtaskvariable.exe
Creates, deletes, sets, and retrieves values of variables on a TeamSite task.
Man Page Group
Workflow/Job.
Usage
iwtaskvariable [-h|-v] [-q] [-s servername] (-g name|-c key value|-t key
value|-d key value) taskid

-q Suppress all error messages.
-g name Get variable.
-c key value Create variable.
-t key value Set variable.
-d key value Delete variable.
taskid Workflow ID number.
Example
>iwtaskvariable -c superhero Spider-Man 111
Creates a task variable with the key “superhero” and the value “Spider-Man” in task
111.

iwundochoice.exe
When a user chooses a transition from a usertask or grouptask, that choice can be taken
back. iwundochoice reverses one such task. The iwundochoice CLT cannot reverse a
transition for a task with multiple successors.
Man Page Group
Workflow/Job.
Usage
iwundochoice [-h|-v] [-s servername] taskID

taskID Specifies the task that was active prior to the transition. Task IDs
are represented as integers.
Example
The following command reverses the transition from task 7734 on the server
>iwundochoice -s production.example.com 7734

iwunlock.exe
Unlocks any file or directory in any TeamSite workarea. See the ContentCenter online
help for a full description of unlocking files.
Man Page Group
Workarea Operation.
Usage
iwunlock [-h|-v] vpath

Example
>iwunlock main/branch1/WORKAREA/wa1/index.html
Unlocks the file index.html in the workarea wa1 on the subbranch branch1. Only one
file may be unlocked at a time with this command.

iwuntaketask.exe
Removes the ownership of an active group task.
Man Page Group
Workflow/Job.
Usage
iwuntaketask [-h|-v] [-s servername] taskID

Example
>iwuntaketask 1250
where 1250 is a grouptask of which someone has already taken ownership (by either
using the GUI, or the iwtaketask CLT).

iwupdate.exe
Updates any TeamSite file, directory, or workarea with the latest version of any file
system element. This command acts like the Copy To or (if vpath_from specifies the
staging area on that branch) the Get Latest command. See the ContentCenter online
help for more information about these commands.
Man Page Group
Workarea Operation.
Usage
iwupdate [-h|-v] [-w|-x|-s] [-o] [-r] {src_vpath}+ dst_vpath
iwupdate [-h|-v] [-w|-x|-s] [-o] [-r] [-f vpath_file] dst_vpath
Where src_vpath specifies a path to a file, directory, or area and dst_vpath specifies a
path to a workarea (dst_vpath may specify a path to a file or directory in a workarea if
the area-relative portions of dst_vpath and src_vpath are the same).

-w Overwrites all files. Files in dst_area but not in src_area are
deleted.
-x Overwrites all conflicts.
-s Overwrites all versioned files.
-o Directory update conflicts return success.
-r Reports on updated files.
-f Reads source vpaths from the file vpath_file (if vpath_file
is -, STDIN will be read).
src_vpath Specifies a path to a file, directory, or area.
dst_vpath Specifies a path to a workarea (dst_vpath may specify a path to
a file or directory in a workarea if the area relative portions of
dst_vpath and src_vpath are the same).
Example
>iwupdate -x main/branch1/WORKAREA/wa1 main/branch1/WORKAREA/wa2
copies all the files that are different in workarea wa1 to workarea wa2, overriding any
conflicts.

iwvpath.exe
Prints all or parts of the version path of the specified object.
Man Page Group
Usage
iwvpath [-h|-v] [-p|-b|-d|[-s][-a]] objectvpath
iwvpath [-h|-v] [-p|-b|-d|[-s][-a]] -o objid

-p Prints the components of the version path in separate lines:
<server>
<archive>
<branch>
<area-type>
<area-name>
<directory-path>
where <area-type> is WORKAREA, STAGING, or EDITION
-b Prints the branch relative vpath only (see page 13).
-d Prints the directory path only (see page 13).
-s Includes the server as part of the vpath.
-a Prints the area vpath (rooted at the archive) (see page 13).
objectvpath Vpath of any TeamSite object (see page 13).
-o objid Objid of any TeamSite object (see page 15).
Examples
>iwvpath -d main/WORKAREA/andre/htdocs/index.html
Returns:
/htdocs/index.html
>iwvpath -p -c fse -o 0x0000007b0000007d00000093 //IWSERVER/default
Returns:
chocolate
default
/main
WORKAREA
andre
/htdocs/index.html

>iwvpath -b -c fse -o 0x0000007b0000007d00000093 //IWSERVER/default
Returns:
/main
>iwvpath -d -c fse -o 0x0000007b0000007d00000093 //IWSERVER/default
Returns:
/htdocs/index.html

Chapter 4
Command Triggers
This chapter describes how to:

Configure command triggers to run as services.
Start and stop command triggers that have been set up to run as services.
This chapter also contains man pages for all supported command triggers. All man
pages in this chapter are presented as one group, arranged alphabetically:
Table 22 Command trigger tools

Trigger Description See...
iwat.exe Registers an event handler for events that do not have a page 226
specific command trigger.
iwatcreate.ipl Triggers a custom script each time a file or a directory is page 227
created.
iwatlock.ipl Triggers a custom script each time a file or a directory is page 228
locked.
iwatmkbr.ipl Triggers a custom script each time a new branch is page 229
created.
iwatmkwa.ipl Triggers a custom script each time a new workarea is page 230
created.
iwatpub.ipl Triggers a custom script each time a new edition is page 231
published.
iwatrmbr.ipl Triggers a custom script each time a branch is deleted. page 232
iwatrmed.ipl Triggers a custom script each time an edition is deleted. page 233
iwatrmwa.ipl Triggers a custom script each time a workarea is deleted. page 234
iwatserver.ipl Triggers a custom script each time a StartUp, ShutDown, page 235
Freeze, Thaw, or DiskLow event occurs.
iwatsub.ipl Triggers a custom script each time a file or a directory is page 236
submitted.
iwatunlock.ipl Triggers a custom script each time a file or a directory is page 237
unlocked.
iwatupdate.ipl Triggers a custom script each time a Copy To or Get page 238
Latest update event occurs.
iwlsat.exe Lists registered iwat programs. page 239
iwrmat.exe Removes registered iwat programs. page 240

Chapter 4: Command Triggers
Starting Command Triggers

TeamSite command triggers run custom scripts whenever certain events occur in the
TeamSite system. For example, the iwatpub trigger can be configured to execute an
email notification script when an edition is published. Each trigger that is invoked tails
the event log and responds to different events. See Appendix B, “Sample Command
Trigger Scripts,” for script examples.
NOTE
Not all events are logged by default in the event log. If an iwat command relies on an
event being logged, and if TeamSite is not configured to log that event, the iwat
command will fail or not run properly. For example, the iwatcreate command looks for
CreateFSE events in the event log. However, CreateFSE events are logged only if you
set log_modifyfse=yes in the iwserver section of the iw.cfg file.
Because they are non-terminating, command triggers are usually included in a script that
starts and stops the process and its tail.
By default, the iwat command triggers invoke user scripts synchronously. That is, they
wait for the scripts to return before handling the next event. You can use the syntax
shown in the following example to configure an iwat trigger to run a script
asynchronously:
iwatserver.ipl "progname progargs ... &"
NOTE
The ampersand is inside the quotation marks that encase the command. This prevents
the shell from running iwatserver itself in the background. As coded above, progname
runs in the background when executed. The iwatserver command trigger is just used as
an example here. You can use this syntax with any iwat command trigger.
To configure the automatic triggering of custom scripts, you will need to use
srvany.exe and instsrv.exe (available as part of the Windows NT Resource Kit).
NOTES
In the following steps, you must use MS-DOS naming conventions if the file or
directory names that you specify contain spaces or more than eight characters. For
example, instead of C:\iw-home\Program Files\Interwoven, you would specify
C:\iw-home\Progra~1\Interw~1. You can use the dir /x command to display the
long and short versions of the file names in the current directory.
The String data type in regedit is the same as REG_SZ in regedt32.
See the Windows operating system documentation for more information about
srvany.

Perform the following procedure to set up a command trigger script as a service:

1. Create a service:
>instsrv.exe <servicename> "C:\iw-home\tools\srvany.exe"
For example:
>instsrv.exe iwatsub "C:\iw-home\tools\srvany.exe"
2. Start regedt32.exe (note that regedt32 does not contain the letter i). Go to
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\
servicename. Using the example from Item 1, servicename would be iwatsub.
3. Add a key called Parameters.
4. Add an Application value to the Parameters key:
Application: REG_SZ: script
where script specifies the full path to your executable, including extension.
Continuing with the example from Item 1, this line would read as follows for a perl
script named iwperl.exe residing in the iw-perl/bin directory:
Application: REG_SZ: C:\iw-home\iw-perl\bin\iwperl.exe
5. Add an AppParameters value to the Parameters key:

AppParameters: REG_SZ: C:\iw-home\bin\triggername.ipl script
[parameters]
where triggername is the command trigger you want to run when the submit event
occurs and parameters are the parameters (if any) the script requires that can be
known at service startup time. For example (assuming no parameters are necessary):
AppParameters: REG_SZ: C:\iw-home\bin\iwatsub.ipl C:\iw-home\
iw-perl\bin\iwperl.exe
6. Add an AppDirectory value to the Parameters key:

AppDirectory: REG_SZ: exec_dir
where exec_dir is the directory where you want the application to execute. For
example:
C:\iw-home\iw-perl\bin
To remove a service:
>instsrv.exe servicename REMOVE
To start a service:
>net start servicename
To stop the service:

>net stop servicename

Environment Variables
When using command triggers, environment variables are set before the program
progname is run. The events and their values are described under the appropriate
command trigger in the following table. Note that some of the events listed in the Event
column do not result in IW_EVENT being set. Because those events also do not have a
command trigger to control the setting of any environment variables, no value is shown
for them in the Command Trigger column. For example, the DeleteEA event does not
set the IW_EVENT variable, and there is no corresponding command trigger to perform
that setting. To make DeleteEA set IW_EVENT, you would have to write a custom script
and then register the event and script through the iwat command.
Values shown in the Event column are the strings used both internally and on the
command line for the corresponding event. If the event has a value in the Command
Trigger column, the string in the Event column is also the value to which the command
trigger sets IW_EVENT. All events, including those without an entry in the Command
Trigger column, can be monitored using iwat.
Table 23 Command triggers and TeamSite events

Command
Event Description
Trigger
CreateBranch A branch has been created iwatmkbr
CreateEA A new EA has been added to a file

CreateFSE An FSE (file/directory/symlink) has iwatcreate
been created
CreateWorkarea A workarea has been created iwatmkwa
DeleteEA An extended attribute (EA) has been deleted

from a file
DestroyBranch A branch has been deleted iwatrmbr
DestroyEdition An edition has been deleted iwatrmed
DestroyFSE An FSE has been deleted

DestroyWorkarea A workarea has been deleted iwatrmwa
DiskFail An I/O error has occurred on the disk(s) iwatserver

containing the backing store
DiskLow The disks containing the backing store are iwatserver
running low on space
Freeze The server has been frozen (iwfreeze) iwatserver
Lock A file or directory has been locked iwatlock
MarkDoneFile A file has been marked as “done”

ModifyFSE An FSE has been modified
PublishStagingArea A new edition has been published from iwatpub
the staging area
ReassignFile A file has been reassigned
RejectFile A file has been reject

Table 23 Command triggers and TeamSite events (Continued)

Command
Event Description
Trigger
RenameBranch A branch has been renamed
RenameFSE An FSE has been renamed
RenameWorkarea A workarea has been renamed
ResetConfig TeamSite has been asked to reload its
configuration files (iwreset)
SetEA An EA has been added to/modified on a file
ShutDown The server has been shut down iwatserver
Startup The server has been started iwatserver
Submit A file or directory has been submitted iwatsub
SyncDestroy A file with EAs has been deleted

SyncModify A file with EAs has been modified
SyncRevert A file with EAs has reverted to an earlier
version
Thaw The server has been unfrozen (thawed) iwatserver
TruncateEA An existing EA has been modified on a file

UnassignFile A file has been unassigned
Unlock A file or directory has been unlocked iwatunlock
Update A file or directory has been updated iwatupdate
WriteEA An EA on a fiel was writen to. Multiple

WriteEA events are followed by a SetEA
event

iwat.exe
This program is used to register an event handler for events that do not have a specific
command trigger program.
Usage
iwat.exe [-h|-v] [-s servername] eventpattern program

specified by name or IP address. The default value is the
current TeamSite server.
eventpattern A regular expression to match complete iwevents.log lines.
program The program to run when the event matches the
eventpattern regular expression.
Example
>iwat CreateWorkarea /usr/ucb/echo

iwatcreate.ipl
iwatcreate is a non-terminating script that executes the custom script progname once
each time a file or a directory has been created.
Usage
iwatcreate.ipl [-h|-v] [-p] progname progargs...

-p Prints process ID before starting.
progname Custom script to be executed.
progargs Arguments to progname.
The following environment variables are set (to the described values) before the
program progname is run:
IW_EVENT “CreateFSE”
IW_TIMESTAMP Time when the event occurred.
IW_EVENTUSER Username of person who performed the operation.
IW_EVENTROLE Role IW_EVENTUSER was in during the operation.
IW_FILE vpath of file (rooted at the archive).

iwatlock.ipl
iwatlock is a non-terminating script that executes the custom script progname once each
time a file or a directory is locked.
Usage
iwatlock.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “Lock”
IW_EDITOR Workarea owner.

iwatmkbr.ipl
iwatmkbr is a non-terminating script that executes the custom script progname once each
time a new branch is created.
Usage
iwatmkbr.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “CreateBranch”
IW_BRANCH vpath of branch (rooted at the archive).

iwatmkwa.ipl
iwatmkwa is a non-terminating script that executes the custom script progname once each
time a new workarea is created.
Usage
iwatmkwa.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “CreateWorkarea”
IW_WORKAREA vpath of workarea (rooted at the archive).

iwatpub.ipl
iwatpub is a non-terminating script that executes the custom script progname once each
time a new edition is published.
Usage
iwatpub.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “PublishStagingArea”
IW_EDITION vpath of edition (rooted at the archive).
IW_STAGINGAREA Version path of the staging area published.
IW_WORKAREA Version path of the workarea published.

iwatrmbr.ipl
iwatrmbr is a non-terminating script that executes the custom script progname once each
time a branch is deleted.
Triggers an event (custom script) upon removal of a branch.
Usage
iwatrmbr.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “DestroyBranch”
IW_BRANCH vpath of branch (rooted at the archive).

iwatrmed.ipl
iwatrmed is a non-terminating script that executes the custom script progname once each
time an edition is deleted.
Usage
iwatrmed.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “DestroyEdition”
IW_EDITION vpath of edition (rooted at the archive).

iwatrmwa.ipl
iwatrmwa is a non-terminating script that executes the custom script progname once each
time a workarea is deleted.
Usage
iwatrmwa.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “DestroyWorkarea”
IW_WORKAREA vpath of workarea (rooted at the archive).

iwatserver.ipl
The iwatserver CLT is a non-terminating script that executes progname once each time
after one of the following events has occurred: StartUp, ShutDown, Freeze, Thaw,
DiskLow, DiskFail, ActivateStore, DeactivateStore, OutOfMemory.
Usage
iwatserver.ipl [-h|-p|-v] progname progargs

-p Prints the process ID before starting.
The following environment variables are set (to the described values) before progname
is run:
IW_EVENT One of the events: StartUp, ShutDown, Freeze, Thaw, DiskLow,

or DiskFail.
IW_TIMESTAMP The time when the event occurred.
IW_EVENTROLE Role that IW_EVENTUSER was in during the operation.
IW_COMMENTS Comments associated with the event.

iwatsub.ipl
iwatsub is a non-terminating script that executes the custom script progname once each
time a file or a directory is submitted.
Triggers an event (custom script) upon submission of any file system element.
Usage
iwatsub.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “Submit”
IW_EVENTLINE Copy of the line from the event log that originally triggered the
event.
IW_WORKAREA vpath of workarea (rooted at the archive) (same as IW_AREA and
IW_VPATH).
IW_SUBMITID objid associated with the submit event.

iwatunlock.ipl
iwatunlock is a non-terminating script that executes the custom script progname once
each time a file or a directory is unlocked.
Usage
iwatunlock.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “Unlock”

iwatupdate.ipl
iwatupdate is a non-terminating script which executes the custom script progname once
each time a Copy To or Get Latest update event occurs.
Triggers a custom script each time.
Usage
iwatupdate.ipl [-h|-v] [-p] progname progargs...

IW_EVENT “Update”
IW_WORKAREA Version path of workarea (rooted at the archive).
IW_UPDATEID objid associated with the update event.

iwlsat.exe
iwlsat lists registered iwat programs, their IDs, and their event regular expressions.
Usage
iwlsat.exe [-h|-v] [-s servername]

TeamSite server.
Example
>iwlsat
displays the following output:

ID: 1234 “CreateWorkarea” /usr/ucb/echo

iwrmat.exe
iwrmat unregisters programs that have been added using the iwat command.
Usage
iwrmat.exe [-h|-v] [-s servername] ID

TeamSite server.
ID The ID number of the iwat program to unregister.
Example
>iwrmat 1234

Appendix A
Master List
The following is an alphabetized master list of all the CLTs and command triggers
described in this manual:
Table 24 CLT alphabetized master list

CLT/Trigger Description See...
iwabort.exe Provides a method for terminating a page 22
long-running server operation.
iwaccess.exe Controls TeamSite user permissions. page 23
iwaccessmigrate.exe Applies user and group permission settings page 31
for configurable roles and delegated
administration.
iwaddtaskfile.exe Adds a file to a job task that is part of a job page 102
instance already created on the TeamSite
server.
iwaddtaskgroup.exe Adds groups to group tasks. page 103
iwaddtaskuser.exe Adds users to tasks. page 104
iwadduser.ipl Adds a user to TeamSite role files. page 34
iwancestor.exe Displays the vpath of the common ancestor page 35
of the specified files.
iwat.exe Registers an event handler for events that do page 226
not have a specific command trigger.
iwatcreate.ipl Triggers a custom script each time a file or a page 227
directory is created.
iwatlock.ipl Triggers a custom script each time a file or a page 228
directory is locked.
iwatmkbr.ipl Triggers a custom script each time a new page 229
branch is created.
iwatmkwa.ipl Triggers a custom script each time a new page 230
workarea is created.
iwatpub.ipl Triggers a custom script each time a new page 231
edition is published.
iwatrmbr.ipl Triggers a custom script each time a branch page 232
is deleted.
iwatrmed.ipl Triggers a custom script each time an edition page 233
is deleted.

Appendix A: Master List
Table 24 CLT alphabetized master list (Continued)

iwatrmwa.ipl Triggers a custom script each time a page 234
workarea is deleted.
iwatserver.ipl Triggers a custom script each time a page 235
StartUp, ShutDown, Freeze, Thaw, or
DiskLow event occurs.
iwatsub.ipl Triggers a custom script each time a file or a page 236
directory is submitted.
iwattrib.exe Returns metadata information on any object page 105
in the TeamSite server, including all
branches, workareas, editions, staging areas,
files, directories, and symlinks.
iwatunlock.ipl Triggers a custom script each time a file or a page 237
directory is unlocked.
iwatupdate.ipl Triggers a custom script each time an update page 238
event occurs (Copy or Get Latest).
iwauthen.exe Authenticates the user (by username) by page 113
checking the corresponding password.
iwcallback.exe Tells the TeamSite server that the program page 115
corresponding to an external or cgi task is
finished. Passes a return code to the server.
iwcat.exe Displays any version of a (text) file in page 116
TeamSite.
iwchgrp.exe Changes the group of a TeamSite workarea page 36
or branch.
iwckrole.exe Checks whether or not a user can log in with page 117
a particular role.
iwcmp.exe Compares any two TeamSite areas and page 118
returns a list of differences.
iwconfig.exe Reads or writes to TeamSite’s main page 37
configuration file.
iwconfigtsreport.ipl Sets TeamSite Reporting parameters in the page 38
tsreport.xml file. Parameters include
database type, port, server, user, password,
license key, and other items.
iwconvertserver.exe Supports the backing store conversion GUI page 40
by communicating with remote TeamSite
servers and invoking iwconvert on behalf of
the GUI.
iwcp.exe Copies files. page 120
iwdecode.exe Decodes HTML-encoded %xx lines to page 121
ASCII lines.
iwdeltaskfile.exe Deletes a file that is attached to a TeamSite page 122
task.
iwencode.exe Encodes ASCII lines to HTML-encoded page 123
%xx lines.


iwevents.exe Returns a history of submissions or updates page 124
of a workarea.
iwextattr.exe Sets extended attributes on a file. page 127
iwfilestate.exe Displays details about a file in a TeamSite page 129
workarea, edition, or staging.
iwfreeze.exe Freezes and unfreezes all system writes. page 41
iwfsck.exe Diagnoses backing store problems. page 43
iwfsfix.exe Fixes problems found by iwfsck. page 45
iwfsshrink.exe Finds and removes duplicate data in the page 46
backing store.
iwgetelog.exe Returns location of TeamSite events log. page 48
iwgeteventcomments.exe Displays comments associated with a page 132
iwgeteventfiles.exe Displays a list of files associated with a page 133
iwgetfilejobs.exe Returns a list of associated workflow job page 49
and task IDs for a file.
iwgethome.exe Returns location of TeamSite program files. page 50
iwgetlocation.exe Returns the locations of various TeamSite page 51
log and configuration files.
iwgetmount.exe Returns location of TeamSite mount point page 53
iwgetstore.exe Returns location of TeamSite backing store. page 54
iwgettaskbyname.exe Writes the task ID to stdout for a task page 134
specified by name.
iwgettrace.exe Returns location of TeamSite trace logs. page 55
iwgetwfobj.exe Prints the state of any part of the server page 135
workflow subsystem in XML.
iwgroup.exe Administers TeamSite groups (list groups, page 56
add and delete groups or members within a
group, modify group names, and other
operations).
iwidmap.exe Change the mapping between the SID and page 63
the token. It can also be used to refresh the
mapping when the same names are used, but
the SID has changed.
iwinvokejob.exe Starts a job whose instance has already been page 136
created on the TeamSite server.
iwjobc.exe Creates a job instance (based on a job page 137
specification file) on the TeamSite server.
iwjobvariable.exe Manipulates workflow variables. page 138
iwlasted.exe Returns the name of the last published page 139
edition on a branch.


iwldapmigrate.exe Creates a new version of tsusers.xml page 140
containing LDAP OS user information
previously stored in
tsldapuserscache.xml. Configures the
LDAP server in user_databases.xml.
iwldapsearch.exe A search program to query an LDAP page 142
directory.
iwldapsync.exe Synchronizes information about TeamSite page 146
users from one or more LDAP servers.
Modifies entries in tsusers.xml based on
configuration settings in
user_databases.xml and information
obtained from LDAP servers.
iwlist.exe Returns a list of all areas contained by a page 146
parent areas. For example, iwlist returns
all editions, workareas, and branches
contained on a parent branch.
iwlistlocks.exe Lists the locks and assignments in a page 149
workarea or branch.
iwlistmod.exe Lists all modified files and directories in a page 150
specified area.
iwlock.exe Locks any file or directory in a specified page 151
area.
iwlockinfo.exe Provides detailed information on any lock. page 152
iwlsat.exe Lists registered iwat programs. page 239
iwmerge.ipl Merges files from one area into another. page 153
iwmigrate.exe Splits or moves Content Stores. page 65
iwmkbr.exe Creates a new TeamSite branch. page 154
iwmkwa.exe Creates a new TeamSite workarea. page 155
iwmvtaskfile.exe Renames a file that is attached to a TeamSite page 156
task.
iwndxaddbr.exe Adds a branch to be indexed. page 157
iwndxfreezebr.exe Freezes or unfreezes the indexing of a page 158
branch.
iwndxlistbr.exe Displays a list of indexed branches. page 159
iwndxmgrfreeze.exe Freezes or unfreezes the index manager. page 160
iwndxmgrstatus.exe Displays the current status of the index page 161
manager.
iwndxmgrstop.exe Shuts down the index manager. page 162
iwndxpurgebr.exe Deletes the index collections associated with page 163
a branch.
iwndxrefreshbr.exe Reindexes a branch by putting it in the bulk page 164
or incremental queue.


iwndxrmbr.exe Removes indexing information for an page 165
indexed branch.
iwndxstatus.exe Displays the current index status for a list of page 166
specified branches from the index manager.
iwndxwamodificationsbr Enables or disables the indexing of page 168
.exe workareas of the specified branch (which is
being indexed by the index server).
iwnexted.exe Returns the name that would be page 169
autogenerated for the next edition on a
branch.
iwprefconv.exe Copies existing homepage information from page 67
the iwprofiles directory to the entity
database.
iwprop.exe Manipulates TeamSite user properties. page 170
iwproxy.exe Invokes a proxy server. page 68
iwprv.exe Allows users to identify whether any file or page 172
directory in any workarea is marked private
and automatically mark any file as either
private or public.
iwpublish.exe Publishes the staging area. page 173
iwqueryjobs.exe Prints a list of overall job information based page 174
on a query from stdin.
iwquerytasks.exe Prints a list of job task information based on page 175
a query from stdin.
iwrecentusers.exe Displays a list of everyone who has used page 69
TeamSite since the last time the TeamSite
server was started, and a timestamp of each
user’s most recent TeamSite operation.
iwrename.exe Renames a file, directory, workarea, edition, page 177
or branch.
iwreset.exe Rereads TeamSite configuration files. page 70
iwretryjobop.exe Retries submission or task update after page 178
resolution of conflicts that originally
prevented those operations.
iwrevert.exe Revert to a previous version of a file. page 179
iwrlog.exe Shows a revision log for a TeamSite file. page 180
iwrmat.exe Removes registered iwat programs. page 240
iwrmbr.exe Deletes a TeamSite branch and all contained page 182
areas (workareas, staging areas, and
editions).
iwrmed.exe Deletes an edition. page 183
iwrmjob.exe Unconditionally removes an entire job page 184
instance from the TeamSite server.
iwrmtaskfile.exe Removes a file from a job task. page 185


iwrmtaskgroup.exe Removes groups from group tasks. page 186
iwrmtaskuser.exe Removes users from group tasks. page 187
iwrmuser.ipl Removes a user from TeamSite. page 71
iwrmwa.exe Deletes a TeamSite workarea. page 188
iwroleadm.exe Lets you view, create, delete, and otherwise page 72
administer roles.
iwsetjobdescription.exe Changes the description of a job. page 189
iwsetjobowner.exe Changes the owner of a job. page 190
iwsettaskattrib.exe Sets a new value for task attributes that have page 191
true or false values.
iwsettaskcomment.exe Assigns a comment to a TeamSite task page 192
iwsettaskdescription.exe Assigns a description to a TeamSite task. page 193
iwsettaskfilecomment.exe Assigns a comment to a file associated with page 194
a TeamSite task.
iwsettaskownerandarea.exe Assigns an owner and workarea to a page 195
TeamSite task.
iwsettasktimeout.exe Changes the time-out value on an inactive page 196
task that already has a time-out.
iwsi.ipl Collects system state data. page 72
iwsrchattrib.exe Displays a list of indexed extended page 197
attributes or templating attributes.
iwsrchgethome.exe Displays the location of the search home page 200
directory.
iwsrchgetpage.exe Displays the results page of a search query. page 201
iwsrchmgrping.exe Pings the search manager. page 203
iwsrchmgrstop.exe Shuts down the search manager. page 204
iwsrchndxstatus.exe Displays the current index status for a list of page 205
specified branches from the search manager.
iwsrchndxstatuschg.exe Reports index status changes. page 207
iwsrchquery.exe Queries the search manager. page 208
iwstat.exe Returns current system activity. page 78
iwstoreadm Activates or deactivates a backing store. page 81
iwsubmit.exe Submits any TeamSite workarea, file, or page 211
directory to the staging area.
iwtaketask.exe Assigns a shared task to a single user. page 212
iwtaskselect.exe Marks a user’s job task finished and selects page 213
a successor task.
iwteamsite.exe Installs or uninstalls the iwtock watchdog page 82
daemon.
iwtaskvariable.exe Creates, deletes, sets, and retrieves values of page 214
variables on a TeamSite task.


iwtestcfg.exe Returns the operation that will be performed page 83
upon a file at submission time.
iwtock Manipulates and displays data about the page 84
TeamSite watchdog daemon.
iwundochoice.exe Reverses a user-chosen transition from a page 215
user task or group task.
iwunlock.exe Unlocks any file or directory. page 216
iwuntaketask.exe Removes the ownership of an active group page 217
task.
iwupdate.exe Updates a TeamSite workarea with the page 218
version of a file or directory in the staging
area.
iwuser.exe Enables you to manipulate TeamSite user page 85
information.
iwuseradm.exe Lets you add and remove TeamSite users, page 88
change user attributes, view and set user
roles.
iwutildreset.exe Resets iwutild configuration settings. page 92
iwutildstat.exe Displays active iwutild server operation page 93
statistics.
iwversion.exe Returns current TeamSite release page 94
information.
iwvpath.exe Prints all or parts of the version path of a page 219
specified object.


Appendix B
Sample Command Trigger

Scripts
This appendix contains the following sample command trigger Perl scripts:
email_to.ipl – sends email to a list of users when a triggering event occurs.
replicate_tobranch.ipl – replicates submitted files and directories from a
workarea to the staging area of a specified branch.
Email Notification Script

The following Perl script, email_to.ipl, sends email to a specified list of users when a
triggering event occurs. Usage and syntax are explained in comment lines.
#!/usr/local/bin/perl
# email_to.ipl
#
# Usage:
# iwatasgn email_to.ipl tolist
# iwatlock email_to.ipl tolist
# iwatmkbr email_to.ipl tolist
# iwatmkwa email_to.ipl tolist
# iwatpub email_to.ipl tolist
# iwatrmbr email_to.ipl tolist
# iwatrmed email_to.ipl tolist
# iwatrmwa email_to.ipl tolist
# iwatsub email_to.ipl tolist
# iwatunlock email_to.ipl tolist
#
# (Unix)
# Example : iwatpub email_to.pl 'mktg,staff,$IW_EVENTUSER'
# Example : iwatasgn email_to.pl '$IW_ASSIGNEE,$IW_EDITOR'
# Example : iwatsub email_to.pl '$IW_EVENTUSER,mktg'
#
# (NT)
# Example : perl iwatpub perl email_to.pl mktg,staff,$IW_EVENTUSER
# Example : perl iwatasgn perl email_to.pl $IW_ASSIGNEE,$IW_EDITOR

Appendix B: Sample Command Trigger Scripts
# Example : perl iwatsub perl email_to.pl $IW_EVENTUSER,mktg

#
$| = 1;
use Config;
if ($Config{osname} eq "MSWin32") {
$MAILER = 'blat.exe - -t';
} else {
$MAILER = '/usr/lib/sendmail';
}
# Change $DEFDOMAIN to be default domain suffix for user email

# $DEFDOMAIN = '@YOURDOMAIN.NET';
# $FROMUSER is added to From: line in emails

$FROMUSER = 'teamsite (TeamSite notifier)';
# $SIGNATURE is added to end of messages - signature string

$SIGNATURE = "\n\nTeamSite is brought to you by Interwoven.";
# Preprocess path to include iw-home in case script is called from

# environment without path initialization
$IW_HOME = `iwgethome`; chop $IW_HOME;

if ( $ENV{'PATH'} !~ m|$IW_HOME/bin| ) {
$ENV{'PATH'} .= ":$IW_HOME/bin";
}
# Add $IW_HOME/lib/perl5 to Perl module include path

push @INC, "$IW_HOME/iw-perl/lib";
use File::Basename;
$MYNAME = basename($0, ".pl" );
use Env qw(PATH IWDEBUGERR IWDEBUGMAIL IW_EVENT IW_TIMESTAMP
IW_EVENTUSER IW_EVENTROLE IW_AREA IW_FILEPATH IW_OBJID
IW_ASSIGNEE IW_COMMENTS);
# $IWDEBUGERR true allows system calls to print errors to STDERR

# $IWDEBUGERR=1;
# $IWDEBUGMAIL true redirects output to STDOUT instead of mail program

# $IWDEBUGMAIL=1 unless defined($IWDEBUGMAIL);
# Redirect STDERR and set up signal

# handler to restore STDERR for final error message
$IWDEBUGERR=0 unless defined($IWDEBUGERR);

if (! $IWDEBUGERR) {

open(SAVESTDERR, ">&STDERR") || die "Can't save STDERR, $!\n";

open(STDERR,">/dev/null") || die "Can't open STDERR to /dev/
null\n";
$SIG{__DIE__} = sub {
open(STDERR, ">&SAVESTDERR");
die "$MYNAME: " . $_[0];
};
}
# Mail programs - uses reference to hash with keys being email

# users
sub MailTolist {
my $maillist_p = $_[0];
my $maillist = join ",", map "$_$DEFDOMAIN", keys %$maillist_p;
return $maillist;
}
sub MailTo {
my $maillist = MailTolist($_[0]);
my $oldfh;
return unless $maillist;
unless ($IWDEBUGMAIL) {
open (MAIL, "| $MAILER $maillist")
or die "Couldn't open pipe to $MAILER $maillist\n";
$oldfh = select MAIL;
}
else {
print "Pipe to $MAILER $maillist\n";
}
# Insert mail header

print "From: $FROMUSER\n";
print "To: $maillist\n";
print "Reply-To: $FROMUSER\n";
if ( $IW_EVENT eq "AssignFile" ) { &MailAssign; }

elsif ( $IW_EVENT eq "ApproveFile" ) { &MailApprove; }
elsif ( $IW_EVENT eq "RejectFile" ) { &MailReject ; }
elsif ( $IW_EVENT eq "UnassignFile" ) { &MailUnassign; }
elsif ( $IW_EVENT eq "MarkDoneFile" ) { &MailMarkDone; } ;
print "$IW_COMMENTS\n";
&DumpAll;
print "$SIGNATURE\n";

unless ($IWDEBUGMAIL) {
close (MAIL);
select $oldfh;
}
}
sub MailAssign {
print "Subject: File assigned to $IW_ASSIGNEE: $IW_FILEPATH\n\n";
print "Timestamp: $IW_TIMESTAMP\n";
print "Branch: $IW_BRANCH\n";
print "Workarea: $IW_AREA\n";
print "Workarea owner: $IW_EDITOR\n";
print "Assigned by user: $IW_EVENTUSER\n";
print "File path: $IW_FILEPATH\n";
print "\nAssignment comments:\n" . "-" x 60 . "\n";
}
sub MailApprove {
print "Subject: File approved by $IW_EVENTUSER: $IW_FILEPATH\n\n";
print "Approved by: $IW_EVENTUSER\n";
print "\nApproval comments:\n" . "-" x 60 . "\n";
}
sub MailReject {
print "Subject: File rejected by $IW_EVENTUSER: $IW_FILEPATH\n\n";
print "Rejected by: $IW_EVENTUSER\n";
print "\nRejection comments:\n" . "-" x 60 . "\n";
}
sub MailUnassign {
print "Subject: File unassigned by $IW_EVENTUSER:
$IW_FILEPATH\n\n";
print "Unassigned by: $IW_EVENTUSER\n";
print "\nUnassignment comments:\n" . "-" x 60 . "\n";
}
sub MailMarkDone {
print "Subject: File marked done by $IW_EVENTUSER:
$IW_FILEPATH\n\n";


print "Marked done by: $IW_EVENTUSER\n";
print "\nMark Done comments:\n" . "-" x 60 . "\n";
}
sub DumpAll {
@vars = qw(
IW_TIMESTAMP IW_EVENTUSER IW_EVENTROLE IW_EVENT
IW_VPATH IW_EVENTLINE IW_BRANCH IW_EDITION
IW_STAGINGAREA IW_WORKAREA IW_AREA IW_FILE
IW_FILEPATH IW_OBJID IW_ASSIGNEE IW_EDITOR
IW_COMMENTS IW_SUBMITID);
for ($i=0; $i<=$#vars; $i++) {
$v = $vars[$i];
if (! $ENV{$v}) { next; }
print "$v : $ENV{$v}\n";
}
}
# MAIN code
#
# Grab the mail targets...

#
foreach $mailDst (split(",", $ARGV[0])) {
##print $mailDst;
if ($mailDst =~ /^\$/) {
$mailDst =~ s/^\$//;
$mailDst = $ENV{$mailDst};
##print "changed to $mailDst\n";
}
$emaillist{$mailDst} = 1;
}
MailTo(\%emaillist);
# -w mode can be a bit noisy for testing - eliminate unused var

# warnings
sub fakewarnings {
my $i1 = \$DEFDOMAIN;
my $i2 = \$SAVESTDERR;
my $i3 = \$objid;
}

Replication Script
The following Perl script, replicate_tobranch.pl, replicates files and directories to
the staging area of a specified branch. Replication is triggered whenever the files or
directories are submitted to their original workarea. This script is designed for use with
the iwatsub command trigger and is typically used to integrate content from one or
more subbranches back to a parent branch. Syntax and an example are included in
comment lines. Due to this document’s formatting constraints, some individual lines are
depicted below as two or more lines. These lines are indicated by a large, bold-face
exclamation point (!). A line ending with this character should be joined with the next
line to form a single line of code.
#!/usr/local/bin/perl
#replicate_tobranch.pl
##This program replicates submitted files/dirs from a workarea
##to the staging area of a specified branch. This can be useful
##when integrating content from subbranches back to parent
##branches.
##Example:
##Given Teamsite directory layout:
##main->dev1
## EDITION
## STAGING
## WORKAREA
## ->dev2
## EDITION
## STAGING
## WORKAREA
## user1
## file1
##
##> iwatsub replicate_tobranch.pl dev1
##
##When file1 is submitted to dev2 STAGING, a submit event
##will be generated, and file1 will also get submitted to
##STAGING in dev1.
push @INC, "/usr/local/lib/perl5";
#get argument as the pathname for download directory
if ($#ARGV >=0) {
$submitto_branch="//IWSERVER/default/main/". @ARGV[0];
} else {
$submitto_branch="//IWSERVER/default/main/acmetest/A"; #default
}
#Assume the replicated workarea is called wa1

$replicate_workarea="$submitto_branch/WORKAREA/wa1";

chomp ($iwhome = `/usr/bin/iwgethome`);

$iwhomebin=$iwhome . "/bin";
# environment variables available

$event = $ENV{'IW_EVENT'}; # should always be "Submit"
$timestamp = $ENV{'IW_TIMESTAMP'};
$user = $ENV{'IW_EVENTUSER'};
$role = $ENV{'IW_EVENTROLE'};
$objid = $ENV{'IW_SUBMITID'};
$path = $ENV{'IW_WORKAREA'};
# testing only, get the last event, assume it's submit for now
if ($event eq "") {
$eventlog=`$iwhomebin/iwgetelog`;
chop($eventlog);
$tailevent=`grep Submit $eventlog |tail -1`;
@tailevent=split("\t",$tailevent);
$event=@tailevent[3];
$timestamp = @tailevent[0];
$user = @tailevent[1];
$role = @tailevent[2];
$objid = @tailevent[5];
chop($objid);
$path = @tailevent[4];
}
#
#iwlist makes sure the branch is valid
#
$existbranch=`$iwhomebin/iwlist $submitto_branch 2>&1`;

chop($existbranch);
if ($existbranch =~ /ERROR/) { #branch does not exist

print STDERR ("$submitto_branch is not a valid branch.\n");
exit(0);
}
#
#iwlist makes sure the replicated workarea exists in
#submitto_branch
#
$existreparea=`$iwhomebin/iwlist $replicate_workarea 2>&1`;
chop($existreparea);
if ($existreparea =~ /ERROR/) { #reparea does not exist

print STDERR ("$replicate_workarea need to exist.\n");

exit(0);
}
## get submit comment info and submit info field

print "GETTING SUBMIT COMMENTS\n";
$submit_cmt = `$iwhomebin/iwattrib -c submitevent -o $objid $path!

submit_cmt`;
$submit_info = `$iwhomebin/iwattrib -c submitevent -o $objid $path!
submit_info`;
$submit_cmt =~ s/\s+$//;
$submit_info =~ s/\s+$//;
## print info for debugging

print "
For Debugging...
User : $user ($role)
Area : $path
Time : $timestamp
Submit Info: $submit_info
Submit Cmt : $submit_cmt
ObjId : $objid
";
#
#find parentbranch from the path in the submit event
#
($parentbranch,$pathend) = ($path =~ /(.*)\/WORKAREA\/(.*)/ );
print "$parentbranch\n";
#get the list of files/dirs submitted from iwevents CLT
unless(open(SUBLOG, "$iwhomebin/iwevents -s -n $objid |")) {

print STDERR "Can't open iwevents: $!\n";
return;
}
#can only update to a workarea, so in order to submit to a

#specific branch, first
#copy it to a workarea under that branch, then submit
#get individual submitted file/dir name and description
$submit_objs="";
while (<SUBLOG>) {
@result = split('\t', $_);

$action = $result[1];
$obj_type = $result[2];
($filename) = &URLDecode($result[3]);
($description) = &URLDecode($result[5]);
$description =~ s/(\s)+/ /g; # loose newlines/tabs
if ($description eq "<none>") {
$description = "[no comment specified]";
}
print "DEBUG:filename : $filename\n";
print "DEBUG:obj_type : $obj_type $action\n";
print "DEBUG:Individual Comment: $description\n\n";
##construct full path name for the updated file and

##to-replicate workarea
$updateobj = $parentbranch . "\/STAGING" .$filename;

$replicateobj=$replicate_workarea;
print "DEBUG:iwupdate -r $updateobj

$replicateobj...\n";
# update obj to the to-replicate workarea
@updatertn=`iwupdate -r $updateobj $replicateobj`;

print ("$iwhomebin/iwupdate return: @updatertn\n");
# construct submit strings <obj comment> pairs to be

#used in iwsubmit
$submit_objs = $submit_objs. " " . $replicateobj .

$filename . " '". "$description" . "'";
}
print ("DEBUG: submit_objs = $submit_objs\n");

#Submit the newly copied objs
$submitcmd ="$iwhomebin/iwsubmit -r -c \'$submit_cmt\' !
-i \'$submit_info\' $submit_objs";
print "$submitcmd\n";
$submitrtn=`$submitcmd`;
print "DEBUG: submit rtn=$submitrtn\n";
sub URLDecode
{
#Decode a URL encoded string or array of strings
#+ is converted to space
#%NN is converted from hex
foreach (@_) {
s/%0D%0A/ /g;
tr/+/ /;

s/%(..)/pack("c", hex($1))/ge;
}
@_;
}

Appendix C
Error Codes
This table lists all the possible error codes that can be returned by a TeamSite
command-line tool. Most of them are standard errors, but there are also many
TeamSite-specific error codes. The list of TeamSite-specific error codes starts on
page 265.
Table 25 CLT error codes

# Error Description
General OS and NFS errors
-1 psx_EOF
0 psx_ENFS_OK (NFS error)

0 psx_SUCCESS
0 psx_YES
1 psx_FAILURE Generic failure.

2 psx_ENFS_NOENT (NFS error) No such file or directory.
2 psx_ENOENT No such file or directory.
3 psx_ESRCH No such process.
4 psx_EINTR Interrupted system call.
5 psx_EIO I/O error.
5 psx_ENFS_IO (NFS error) A hard error occurred when the operation
was in progress.
6 psx_ENFS_NXIO (NFS error) No such device or address.
6 psx_ENXIO No such device or address.
7 psx_E2BIG Argument list too long.
8 psx_ENOEXEC Executable file format error.
9 psx_EBADF Bad file number.
10 psx_ECHILD No children.
11 psx_EAGAIN Resource temporarily unavailable.
12 psx_ENOMEM Not enough core memory.
13 psx_EACCES Permission denied.
13 psx_ENFS_ACCES (NFS error) Permission denied.
14 psx_EFAULT Bad address.
15 psx_ENOTBLK Block device required.

Appendix C: Error Codes
Table 25 CLT error codes (Continued)

# Error Description
16 psx_EBUSY Mount device busy.
17 psx_EEXIST Item already exists.
17 psx_ENFS_EXIST (NFS error) Item already exists.
18 psx_ENFS_XDEV (NFS error) Attempt to do a cross-device hard link.
18 psx_EXDEV Cross-device link.
19 psx_ENFS_NODEV (NFS error) No such device.
19 psx_ENODEV No such device.
20 psx_ENFS_NOTDIR (NFS error) Directory expected, but wasn’t one.
20 psx_ENOTDIR Directory expected, but wasn’t one.
21 psx_EISDIR Is a directory.
21 psx_ENFS_ISDIR (NFS error) Is a directory.
22 psx_EINVAL Invalid argument.
22 psx_ENFS_INVAL (NFS error) Invalid argument or unsupported
argument for an operation.
23 psx_ENFILE File table overflow.
24 psx_EMFILE Too many open files.
25 psx_ENOTTY Inappropriate I/O control for device.
26 psx_ETXTBSY Text file busy.
27 psx_EFBIG File too large.
27 psx_ENFS_FBIG (NFS error) File too large.
28 psx_ENFS_NOSPC (NFS error) Insufficient space to complete operation.
28 psx_ENOSPC Insufficient space to complete operation.
29 psx_ESPIPE Illegal seek.
30 psx_ENFS_ROFS (NFS error) File system is read-only or archive is
frozen.
30 psx_EROFS File system is read-only or archive is
frozen.
31 psx_EMLINK Too many links.
31 psx_ENFS_MLINK (NFS error) Too many hard links.
32 psx_EPIPE Broken pipe.
33 psx_EDOM Math argument out of domain of
function.
34 psx_ERANGE Math result not representable.
35 psx_ENOMSG No message of desired type.
36 psx_EIDRM Identifier removed.
37 psx_ECHRNG Channel number out of range.
38 psx_EL2NSYNC UNIX boot level 2 not synchronized.


# Error Description
39 psx_EL3HLT UNIX boot level 3 halted.
40 psx_EL3RST UNIX boot level 3 reset.
41 psx_ELNRNG Link number out of range.
42 psx_EUNATCH Protocol driver not attached.
43 psx_ENOCSI No CSI structure available.
44 psx_EL2HLT UNIX boot level 2 halted.
45 psx_EDEADLK Resource deadlock condition.
46 psx_ENOLCK No record locks available.
47 psx_ECANCELED Operation canceled.
48 psx_ENOTSUP Operation not supported.
Filesystem Quotas
49 psx_EDQUOT Disk quota exceeded.
Convergent Error Returns
50 psx_EBADE Invalid exchange.
51 psx_EBADR Invalid request descriptor.
52 psx_EXFULL Exchange full.
53 psx_ENOANO No anode.
54 psx_EBADRQC Invalid request code.
55 psx_EBADSLT Invalid slot.
56 psx_EDEADLOCK File locking deadlock error.
57 psx_EBFONT Bad font file format.
Stream Problems
60 psx_ENOSTR Device not a stream.
61 psx_ENODATA No data (for no delay I/O).
62 psx_ETIME Timer expired.
63 psx_ENOSR Out of streams resources.
64 psx_ENONET Machine is not on the network.
65 psx_ENOPKG Package not installed.
66 psx_EREMOTE The object is remote.
67 psx_ENOLINK The link has been severed.
68 psx_EADV Advertise error.
69 psx_ESRMNT Srmount error.
70 psx_ECOMM Communication error on send.
71 psx_EPROTO Protocol error.
72 psx_EBADRPC RPC struct is bad; error checks failed.
73 psx_EDOTDOT RFS specific error.


# Error Description
74 psx_EMULTIHOP Multihop attempted.
77 psx_EBADMSG Trying to read unreadable message.
78 psx_ENAMETOOLONG Path name is too long.
79 psx_EOVERFLOW Value too large to be stored in data type.
80 psx_ENOTUNIQ Given log. name not unique.
81 psx_EBADFD File descriptor invalid for this operation.
82 psx_EREMCHG Remote address changed.
Shared Library Problems
83 psx_ELIBACC Can’t access a needed shared library.
84 psx_ELIBBAD Accessing a corrupted shared library.
85 psx_ELIBSCN .lib section in a.out corrupted.
86 psx_ELIBMAX Attempting to link in too many libraries.
87 psx_ELIBEXEC Attempting to exec a shared library.
88 psx_EILSEQ Illegal byte sequence.
89 psx_ENOSYS Unsupported file system operation.
90 psx_ELOOP Symbolic link loop.
91 psx_ERESTART Restartable system call.
92 psx_ESTRPIPE Pipe or FIFO doesn’t sleep in stream
head.
93 psx_ENOTEMPTY Directory not empty.
94 psx_EUSERS Too many users (for UFS).


# Error Description
BSD Networking Software
argument errors
95 psx_ENOTSOCK Socket operation on non-socket.
96 psx_EDESTADDRREQ Destination address required.
97 psx_EMSGSIZE Message too long.
98 psx_EPROTOTYPE Protocol wrong type for socket.
99 psx_ENOPROTOOPT Protocol not available.
Linux-specific
117 psx_EUCLEAN Structure needs cleaning.
118 psx_ENOTNAM Not a XENIX named type file.
119 psx_ENAVAIL No XENIX semaphores available.
120 psx_EISNAM Is a named type file.
121 psx_EREMOTEIO Remote I/O error.
BSD Networking Software
120 psx_EPROTONOSUPPORT Protocol not supported.
122 psx_EOPNOTSUPP Operation not supported on socket.
123 psx_EPFNOSUPPORT Protocol family not supported.
124 psx_EAFNOSUPPORT Address family not supported by protocol
family.
125 psx_EADDRINUSE Address already in use.
126 psx_EADDRNOTAVAIL Can’t assign requested address.
Operational Errors
127 psx_ENETDOWN Network is down.
128 psx_ENETUNREACH Network is unreachable.
129 psx_ENETRESET Network dropped connection because of
reset.
130 psx_ECONNABORTED Software caused connection abort.
131 psx_ECONNRESET Connection reset by peer.
132 psx_ENOBUFS No buffers available.
133 psx_EISCONN Socket is already connected.
134 psx_ENOTCONN Socket is not connected.
143 psx_ESHUTDOWN Can’t send after socket shutdown.
144 psx_ETOOMANYREFS Too many references: can’t splice.
145 psx_ETIMEDOUT Connection timed out.
146 psx_ECONNREFUSED Connection refused.
147 psx_EHOSTDOWN Host is down.


# Error Description
148 psx_EHOSTUNREACH No route to host.
149 psx_EALREADY Operation already in progress/done.
150 psx_EINPROGRESS Operation now in progress.
151 psx_ESTALE Stale NFS file handle.
301 psx_EPERM No permission; or not super-user.
301 psx_ENFS_PERM (NFS error) Not owner.
311 psx_EWOULDBLOCK Berkeley sockets error - operation would
block till completion.
FreeBSD-specific
398 psx_EJUSTRETURN (400-2) don’t modify registration, just
return.
473 psx_ERPCMISMATCH RPC version wrong.
474 psx_EPROGUNAVAIL RPC program not available.
475 psx_EPROGMISMATCH Program version wrong.
476 psx_EPROCUNAVAIL Bad procedure for program.
479 psx_EFTYPE Inappropriate file type or format.
480 psx_EAUTH Authentication error.
481 psx_ENEEDAUTH Need authenticator.
Linux-specific
512 psx_ERESTARTSYS Linux system startup error.
513 psx_ERESTARTNOINTR Linux system startup error.
514 psx_ERESTARTNOHAND Restart if no handler.
515 psx_ENOIOCTLCMD No I/O control command.
SunOS4-specific
567 psx_EPROCLIM Too many processes.
581 psx_ERREMOTE Object is remote.
OSF/AXP-specific
688 psx_ECLONEME Tells open to clone the device.
689 psx_EDIRTY Mounting a dirty (unchecked) file
system.
690 psx_EDUPPKG Duplicate package name on install.
691 psx_EVERSION Version number mismatch.
693 psx_ENOSYM Unresolved symbol name.
695 psx_EFAIL Cannot start operation.
697 psx_EINPROG Operation (now) in progress.
698 psx_EMTIMERS Too many timers.
700 psx_EAIO Internal AIO operation complete.


# Error Description
723 psx_ESOFT Indicates a correctable error.
724 psx_EMEDIA Returned by a disk driver to indicate a
hard ECC error or similar disk media
failure.
725 psx_ERELOCATED “Success” code indicating that a defect
relocation request was performed
successfully.
Misc. generic error numbers
901 psx_EEXITING Exiting process/thread.
905 psx_EIMPLEMENT Function not yet implemented.
910 psx_EBUFTOOSMALL Buffer is too small for output.
911 psx_ESTRTOOLONG String argument is too long.
920 psx_ENOTFOUND Object being looked up was not found.
925 psx_ENOUSER No such user.
930 psx_ERPCFAILURE RPC connection failure.
980 psx_ENOAUTHENDONE No authentication was done.
981 psx_ENOAUTHORDONE No authorization was done.
999 psx_NO “No” is the response.
Interwoven-specific error codes
2000 psx_EITERENDED Iteration ended.
2001 psx_EITERNOENT No iteration entry.
2003 psx_ENOBASEED Invalid base edition for operation.
2004 psx_ENOSE No server found.
2005 psx_ENOAR No archive found.
2006 psx_ENOBR No branch found.
2007 psx_ENOWA No workarea found.
2008 psx_ENOED No edition found.
2009 psx_ENOFSE No file or directory found.
2010 psx_ENOPREVFSE No previous file or directory found.
2011 psx_ENOWADIR Workarea directory not found.
2012 psx_ENOEDDIR Edition directory not found.
2013 psx_ENOSA No staging area found.
2014 psx_ENOOP No operation found.
2015 psx_ENOTAG No tag found.
2016 psx_ECONFLICTS Conflicts prevent operation.
2017 psx_ECHECKEDOUT Checked out files prevent submitting.
2018 psx_EWABRBAD Workarea does not match branch.


# Error Description
2019 psx_EONLYED Cannot destroy last remaining edition on
branch.
2100 psx_EBADNAME Illegal name given.
2102 psx_EBADVPATH Bad version path.
2150 psx_EPRIVATE Illegal operation on private file or
directory.
2200 psx_ENOROLE No such role.
2300 psx_EILOP Illegal operator.
2301 psx_ENOATTRIB No such attribute.
2400 psx_ERESERVED Object is being reserved by someone else.
2401 psx_ESAMEFSE File or directory is the same as the other
version.
2402 psx_ENEWERFSE File or directory is newer than the other
version.
2403 psx_ENOUPDATE No update performed.
2404 psx_ENOSUBMIT No submit performed.
2405 psx_ENOCMPRS Compressing workarea, staging area, or
latest edition is not allowed.
2408 psx_EMULTIBR More than one branch found.
2409 psx_EMULTIWA More than one workarea found.
2410 psx_ENOGROUP No such group.
2411 psx_EDELETED File had been deleted.
2412 psx_EASSIGNED Assigned files prevent submitting.
2413 psx_ENOTAUTHOR Must be Author.
2414 psx_EOLDERFSE File is older than the other version.
2415 psx_ENOTWAMBR Not owner or member of workarea.
2416 psx_EABORTED Operation aborted.
2417 psx_ENEWERDELETION File or directory is a deletion of the other
file or directory.
2418 psx_ENOROLEAUTH Role is not authorized for this user.
2419 psx_EWRONGUSERPWD Invalid username/password combination.
2420 psx_ENODOMAIN Domain does not exist.
2421 psx_ENOSADIR Staging area directory not found.
2422 psx_ENOTSUSER No such TeamSite user.
ODBC errors
21098 psx_ECONN_INVALID_HANDLE ODBC code: invalid handle.
21099 psx_ECONN_ERROR ODBC code: generic error.


# Error Description
21101 psx_ECONN_SUCCESS_WITH_INFO ODBC code: success; more information
is coming.
21199 psx_ECONN_NEED_DATA ODBC code: need more data.
21200 psx_ECONN_NO_DATA_FOUND ODBC code: no data found.
Interwoven Object Transfer Protocol
21501 psx_ECOP_ILLXPORT Illegal transport.
21502 psx_ECOP_XPORTNOTAVAIL Transport not available.
21503 psx_ECOP_NOSERVER Server not found.
21504 psx_ECOP_BUFTOOSMALL Buffer too small.
21505 psx_ECOP_NOTENOUGHDATA Not enough bytes.
21506 psx_ECOP_BADBYTECOUNT Incorrect byte count.
21507 psx_ECOP_ILLDATA Illegal data.
21508 psx_ECOP_METHODNOTAVAIL Specified method not available.
21510 psx_ECOP_VERNOTSUP COP version not supported.
21512 psx_ECOP_BADMSGINDEX Incorrect message index.
22001 psx_ESC_FAILURE General Special Channel failure.
22004 psx_ESC_BADKEY Bad Special Channel key.
22006 psx_ESC_NOCHANNEL No Special Channel.
22008 psx_ESC_NODIR No Special Channel directory.
22010 psx_ESC_CANTCREATE Cannot create Special Channel.
NFS errors
100063 psx_ENFS_NAMETOOLONG File name too long.
100066 psx_ENFS_NOTEMPTY Directory not empty.
100069 psx_ENFS_DQUOT Disk quota exceeded.
100070 psx_ENFS_STALE Invalid file handle.
100071 psx_ENFS_REMOTE The file handle given in the arguments
referred to a file on a non-local file
system on the server.
100099 psx_ENFS_WFLUSH The server’s write cache used in the
“WRITECACHE” call got flushed to
disk.
110001 psx_ENFS_BADHANDLE Illegal NFS file handle. The file handle
failed internal consistency checks.
110002 psx_ENFS_NOT_SYNC Update synchronization mismatch was
detected during a SETATTR operation.
110003 psx_ENFS_BAD_COOKIE READDIR or READDIRPLUS cookie is
stale.
110004 psx_ENFS_NOTSUPP Operation is not supported.
110005 psx_ENFS_TOOSMALL Buffer or request is too small.


# Error Description
110006 psx_ENFS_SERVERFAULT An error occurred on the server which
does not map to any of the legal NFS
version 3 protocol error values
110007 psx_ENFS_BADTYPE An attempt was made to create an object
of a type not supported by the server.
110008 psx_ENFS_JUKEBOX The server initiated the request, but was
not able to complete it in a timely
fashion.

Appendix D
Search Query Schemas
This appendix contains the following search query XML schemas, which are used with
the iwsrchquery CLT:
BaseQueryLanguage.xsd – the basic search query schema.
FullTextQueryElements.xsd – extends BaseQueryLanguage.xsd to support
full-test searches for documents and attributes.
TeamSiteSearch.xsd – extends BaseQueryLanguage.xsd to support searches for
FormsPublisher templating attributes.
BaseQueryLanguage.xsd
<?xml version="1.0" encoding="UTF-8" ?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified" attributeFormDefault="unqualified">

<xs:complexType name="constraint" abstract="true">

<xs:annotation>
<xs:documentation>The base type of all constraints
</xs:documentation>
</xs:annotation>
</xs:complexType>
<xs:group name="attributeSpecifier">
<xs:annotation>
<xs:documentation>
Used to refer to attributes in attributeConstraints, selectors
and ordering clauses
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="name" type="xs:string" />


<xs:element name="dataType" type="xs:string" minOccurs="0"/>

<xs:element name="modifier" type="xs:string" minOccurs="0"
maxOccurs="unbounded"/>
</xs:sequence>
</xs:group>
<xs:complexType name="attributeConstraint" abstract="true">

<xs:annotation>
<xs:documentation>The superclass of all field constraints.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="constraint">
<xs:sequence>
<xs:group ref="attributeSpecifier"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="attribute">
<xs:annotation>
<xs:documentation>
Used to refer to attributes in select and ordering clauses
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:group ref="attributeSpecifier"/>
</xs:sequence>
</xs:complexType>
<xs:element name="attribute" type="attribute"/>

<xs:complexType name="and">
<xs:annotation>
<xs:documentation>
A constraint formed by logically 'AND'ing a set of constraints.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
<xs:element ref="constraint" maxOccurs="unbounded" />
</xs:sequence>

</xs:extension>
</xs:complexType>
<xs:complexType name="or">
<xs:annotation>
<xs:documentation>
A constraint formed by logically 'OR'ing a set of constraints
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
</xs:complexType>
<xs:complexType name="accrue">
<xs:annotation>
<xs:documentation>
A constraint whose relevance is determined by the number
of sub-constraints that match.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
</xs:complexType>
<xs:complexType name="not">
<xs:annotation>
<xs:documentation>Negates a constraint</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
<xs:element ref="constraint" minOccurs="1" maxOccurs="1" />
</xs:sequence>
</xs:extension>
</xs:complexType>


<xs:simpleType name="operator">

<xs:annotation>
<xs:documentation>
An operator for logical attribute comparisons
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="LT" />
<xs:enumeration value="GT" />
<xs:enumeration value="EQ" />
<xs:enumeration value="NEQ" />
<xs:enumeration value="GE" />
<xs:enumeration value="LE" />
</xs:restriction>
</xs:simpleType>
<xs:complexType name="attributeComparison">
<xs:annotation>
<xs:documentation>
Used to logically compare a attribute to a constant
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="attributeConstraint">
<xs:sequence>
<xs:element name="operator" type="operator" />
<xs:element name="value" type="xs:string" />
</xs:sequence>
</xs:extension>
</xs:complexType>

<xs:element name="predicate">
<xs:annotation>
<xs:documentation>The root of a query predicate</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:all>
<xs:element ref="constraint" />
</xs:all>
</xs:complexType>
</xs:element>

<xs:complexType name="selector">
<xs:annotation>
<xs:documentation>
An abstract element that defines the selector portion of a query
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="attribute" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ordering">
<xs:annotation>
<xs:documentation>
An abstract element that defines how to order results
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="attribute" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:element name="selector" type="selector"/>

<xs:element name="ordering" type="ordering"/>

<xs:element name="query">
<xs:annotation>
<xs:documentation>A full query.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element ref="selector" minOccurs="0"/>
<xs:element ref="predicate" minOccurs="0"/>
<xs:element ref="ordering" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name="constraint" abstract="true">

<xs:annotation>
<xs:documentation>
The abstract substitution group for any constraint
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="attributeConstraint" type="attributeConstraint"

substitutionGroup="constraint">
<xs:annotation>
<xs:documentation>
The abstract substitution group for attribute constraints
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="and" type="and" substitutionGroup="constraint" />

<xs:element name="or" type="or" substitutionGroup="constraint" />
<xs:element name="not" type="not" substitutionGroup="constraint" />
<xs:element name="accrue" type="accrue"
substitutionGroup="constraint"/>
<xs:element name="attributeComparison" type="attributeComparison"

substitutionGroup="attributeConstraint" />
</xs:schema>
FullTextQueryElements.xsd

<xs:include schemaLocation="BaseQueryLanguage.xsd"/>
<xs:complexType name="fulltext" abstract="true">

<xs:annotation>
<xs:documentation>
A full text constraint. Abstract.
</xs:documentation>

</xs:annotation>
<xs:complexContent>
<xs:extension base="constraint" />
</xs:complexType>
<xs:complexType name="fulltext-any">
<xs:annotation>
<xs:documentation>
A fulltext constraint that searches for any of the terms
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="fulltext">
<xs:sequence>
<xs:element name="term" type="xs:string" maxOccurs="unbounded" />
</xs:sequence>
</xs:extension>
</xs:complexType>
<xs:complexType name="fulltext-accrue">
<xs:annotation>
<xs:documentation>
A fulltext constraint that searches for any of the terms
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
</xs:complexType>
<xs:complexType name="fulltext-all">
<xs:annotation>
<xs:documentation>
A fulltext constraint that searches for all of the terms
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
</xs:complexType>

<xs:complexType name="fulltext-phrase">
<xs:annotation>
<xs:documentation>
A fulltext constraint that searches for a phrase
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
<xs:element name="term" type="xs:string" />
</xs:sequence>
</xs:extension>
</xs:complexType>
<xs:complexType name="fulltext-sentence">
<xs:annotation>
<xs:documentation>
A fulltext constraint that searches for its terms in the
same sentence
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
</xs:complexType>
<xs:complexType name="fulltext-near">
<xs:annotation>
<xs:documentation>
A fulltext constraint that searches for its terms based
on their proximity
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
<xs:element name="ordered" type="xs:boolean" />
<xs:element name="proximity" type="xs:int" />
</xs:sequence>
</xs:extension>
</xs:complexType>

<xs:complexType name="fulltext-stem">
<xs:annotation>
<xs:documentation>
A fulltext constraint that searches for a word and its stems
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
</xs:complexType>
<xs:complexType name="fulltext-wildcard">
<xs:annotation>
<xs:documentation>
A fulltext constraint based on a wildcard expression
</xs:documentation>
</xs:annotation>
<xs:all>
</xs:all>
</xs:complexType>
<xs:complexType name="fulltext-attribute">
<xs:annotation>
<xs:documentation>
A fulltext constraint that is applied to a attribute.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="attributeConstraint">
<xs:sequence>
<xs:element ref="fulltext" minOccurs="1" maxOccurs="1"/>
</xs:sequence>
</xs:extension>
</xs:complexType>
<xs:element name="fulltext" abstract="true"

substitutionGroup="constraint">
<xs:annotation>
<xs:documentation>
The abstract substitution group for a fulltext constraint
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="fulltext-accrue" type="fulltext-accrue"

substitutionGroup="fulltext" />
<xs:element name="fulltext-any" type="fulltext-any"
<xs:element name="fulltext-all" type="fulltext-all"
<xs:element name="fulltext-phrase" type="fulltext-phrase"
<xs:element name="fulltext-sentence" type="fulltext-sentence"
<xs:element name="fulltext-near" type="fulltext-near"
<xs:element name="fulltext-stem" type="fulltext-stem"
<xs:element name="fulltext-wildcard" type="fulltext-wildcard"
<xs:element name="fulltext-attribute" type="fulltext-attribute"
substitutionGroup="attributeConstraint"/>
</xs:schema>
TeamSiteSearch.xsd

<xs:include schemaLocation="FullTextQueryElements.xsd"/>


<xs:element name="queryLocale" type="xs:string" maxOccurs="1">
<xs:annotation>
<xs:documentation>A constraint that restricts the search to a
particular locale</xs:documentation>
</xs:annotation>
</xs:element>


<xs:complexType name="templatingAttribute">
<xs:annotation>
<xs:documentation>
A constraint that searches for a particular templating attribute
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="templateType" type="xs:string" />
<xs:element ref="attributeConstraint" />
</xs:sequence>
</xs:complexType>


<xs:complexType name="scope-fileExt">
<xs:annotation>
<xs:documentation>
A constraint that restricts the search to the specified
file extensions
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="extension" type="xs:string" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>

<xs:complexType name="scope-location">
<xs:annotation>
<xs:documentation>
A constraint that restrics the search to a location
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence maxOccurs="unbounded">
<xs:element name="location" type="xs:string" />
</xs:sequence>
</xs:extension>
</xs:complexType>

<xs:complexType name="areaRelativePath">
<xs:annotation>
<xs:documentation>
A constraint that restrics the search to a location
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:sequence minOccurs="1" maxOccurs="1">
<xs:element name="wildcard" type="xs:string" />
</xs:sequence>

</xs:extension>
</xs:complexType>

<xs:element name="templatingAttribute" type="templatingAttribute"
substitutionGroup="constraint" />
<xs:element name="scope-fileExt" type="scope-fileExt"
<xs:element name="scope-location" type="scope-location"
<xs:element name="areaRelativePath" type="areaRelativePath"
</xs:schema>

Index
A iwatrmwa 234
activating Content Store 81 iwatserver 235
ancestor iwatsub 236
print common 35 iwatunlock 237
areas iwatupdate 238
comparison 118 iwlsat 239
list of 147 replication script 254
modified files in 150 sample scripts 249, 269
attributes starting 222
extended 127 configuration files
list 197 interfacing with 37
of servers 106 location 51
authenticating users 113 rereading 70
autoprivate.cfg 70 conflicts
resolving 178
Content Store 81
B activating 81
branch 158 conversion 40
changing group ownership 36 diagnose 43
creating 153, 154, 229 fixing problems 45
deleting 232 iwconvertserver 40
freeze indexing 158 iwfsck 43
index 157, 159 iwfsfix 45
indexing 157 iwfsshrink 46
list indexed 159 iwidmap 63
locks 149 iwmigrate 65
removing 182 iwstoreadm 81
renaming 177 location 54
resume indexing 158 move 65
status 207 removing duplicate file contents 46
branch operation 96 split 65
iwmkbr 153, 154 controlling 81
iwrmbr 182 convergent error returns 261
BSD networking software error codes 263 copying files 120
C D
CGI task 115 daemon
command trigger 233, 240 watchdog 82
iwatcreate 227 deactivating Content Store 81
iwatlock 228 decoding %xx lines 121
iwatmkbr 229 deleting editions 183
iwatmkwa 230 deleting workarea 188
iwatpub 231 diagnose Content Store 43
iwatrmbr 232

Index
directory information 129

creation 227 locking 151, 216
modified 150 modified 150
directory paths 15 removing duplicate contents 46
removing from task 185
E renaming 177
reverting 179
edition
submitting 211, 236
deleting 183, 233
unlocking 237
name of last 139
update 218
name of next 169
updating 238
publishing 231
versions 116
renaming 177
file system quota error codes 261
edition operation 97
filtering 83
iwlasted 139
finishing task 213
iwnexted 169
free BSD specific error codes 264
iwpublish 173
freeze 41, 78, 158, 160
iwrmed 183
freeze index manager 160
email notification script 249
encoding HTML %xx lines 123
environment data G
collecting 76 general development 95
error codes 259 iwattrib 105
argument errors 263 iwauthen 113
BSD networking software 263 iwckrole 117
convergent error returns 261 iwcp 120
file system quotas 261 iwdecode 121
free BSD 264 iwencode 123
general OS and NFS 259 iwextattr 127
generic 265 iwfilestate 129
Interwoven 265 iwldapmigrate 140
Interwoven Object Transfer Protocol 267 iwldapsearch 142
Linux-specific 263, 264 iwldapsync 146
NFS 267 iwlist 147
ODBC 266 iwprop 170
operational 263 iwrename 177
OSF/AXP 264 iwvpath 219
shared library 262 general OS and NFS errors 259
stream problems 261 generic error numbers 265
SunOS4 264 Get Latest 218
event group ownership
occurring 235 changing 36
triggering 236 groups
events log TeamSite 56
contents 48
extended attributes 127
external task 115 H
history of workarea 124
HTML %xx lines
F decoding 121
file encoding 123
adding to task 102
copy 120
delete from task 122
displaying 133

Index
I iwgeteventfiles 133
index 158, 159, 160, 161, 162, 205, 207 iwgethome 50
index manager 157, 160 iwgetlocation 51
status 161 iwgetlog 48
stop 162 iwgetmount 53
indexing iwgetstore 54
branch 158 iwgettaskbyname 134
Interwoven error codes 265 iwgettrace 55
Interwoven Object Transfer Protocol error codes iwgetwfobj 135
267 iwgroup 56
iw.cfg 37, 70 iwidmap 63
iwabort 22 iwinvokejob 136
iwaccess 23 iwjobc 137
iwaccessmigrate 31 iwjobvariable 138
iwaddtaskfile 102 iwlasted 139
iwaddtaskgroup 103 iwldapmigrate 140
iwaddtaskuser 104 iwldapsearch 142, 146
iwancestor 35 iwldapsync 146
iwat 226 iwlist 147
iwatcreate 227 iwlistlocks 149
iwatlock 228 iwlistmod 150
iwatmkbr 229 iwlock 151
iwatmkwa 230 iwlockinfo 152
iwatpub 231 iwlsat 239
iwatrmbr 232 iwmigrate 65
iwatrmed 233 iwmkbr 154
iwatrmwa 234 iwmkwa 155
iwatserver 235 iwmvtaskfile 156
iwatsub 236 iwndxaddbr 157
iwattrib 105 iwndxfreezebr 158
iwatunlock 237 iwndxlistbr 159
iwatupdate 238 iwndxmgrfreeze 160
iwauthen 113 iwndxmgrstatus 161
iwcallback 115 iwndxmgrstop 162
iwcat 116 iwnexted 169
iwchgrp 36 iwprefconv 67
iwckrole 117 iwprop 170
iwcmp 118 iwproxy 68
iwconfig 37 iwprv 172
iwconfigtsreport 38 iwpublish 173
iwconvertserver 40 iwqueryjobs 174
iwcp 120 iwquerytasks 175
iwdecode 121 iwrecentusers 69
iwdeltaskfile 122 iwrename 177
iwencode 123 iwreset 70
iwevents 124 iwretryjobop 178
iwextattr 127 iwrevert 179
iwfilestate 129 iwrlog 180
iwfreeze 41 iwrmat 240
iwfsck 43 iwrmbr 182
iwfsfix 45 iwrmed 183
iwfsshrink 46 iwrmjob 184
iwgeteventcomments 132 iwrmtaskfile 185
iwrmtaskgroup 186

Index
iwrmtaskuser 187 L
iwrmwa 188 LDAP configuration 140
iwroleadm 72 LDAP query 142
iwsetjobdescription 189 LDAP users 146
iwsetjobowner 190 Linux-specific error codes 263, 264
iwsettaskattrib 191 location 53
iwsettaskcomment 192 locking 152
iwsettaskdescription 193 locking files 151
iwsettaskfilecomment 194 locks 149
iwsettaskownerandarea 195 directory 228
iwsettasktimeout 196 log
iwsi 76 file locations 51
iwsrchattrib 197 revision 180
iwsrchgethome 200 trace 55
iwsrchgetpage 201
iwsrchmgrping 203
iwsrchmgrstop 204 M
iwsrchndxstatus 205 mapping
iwsrchndxstatuschg 207 changing 63
iwsrchquery 208 metadata
iwstat 78 obtaining 105
iwstoreadm 81 modifications
iwsubmit 211 list of 118
iwtaketask 212 mount point 53
iwtaskselect 213
iwtaskvariable 214 N
iwteamsite 82 NSF error codes 267
iwtestcfg 83
iwtock 82, 84
iwundochoice 215 O
iwunlock 216 object IDs 15
iwuntasktask 217 objids 15
iwupdate 218 ODBC error codes 266
iwuser 85 operational error codes 263
iwuseradm 88 operations
iwutildreset 92 deleting from server 22
iwutildstat 93 OSF/AXP error codes 264
iwversion 94
iwvpath 219 P
paths
J directory 15
job version 13, 14
change description 189 permissions
change owner 190 control 23
instantiating 137 migrating 31
querying 174 print
removing from server 184 version path 219
running 136 private workareas 172
program
executing 115
unregistering 240
proxy server 68
publishing staging area 173

Index
Q server workflow
query displaying 135
server workflow event
LDAP 142
query results displaying 132
display 201 service monitor 84
querying jobs 174 shared library error codes 262
querying tasks 175 shared task 212
staging
publishing 173
R submitting to 211
relative vpaths 14 statistics
release information 94 utility daemon 93
removing branch 182 status 205
rename file 156 stopping index manager 162
reporting stream problem error codes 261
configuring 38 submit
reverse task transition 215 resolving conflicts 178
revert file to previous version 179 submit filtering 83
revision log 180 submit to staging 211
roles submit.cfg 70
administer 72 SunOS4 error codes 264
user 117 system activity 78
system information 19
iwgetelog 48
S iwgetfilejobs 49
script iwgethome 50
email notification 249 iwgetlocation 51
replication 254 iwgetmount 53
search 197, 201, 204, 205, 207 iwgetstore 54
home directory 200 iwgettrace 55
query 208 iwrecentusers 69
response time 203 iwstat 78
search and index iwuser 85
iwndxaddbr 157 iwversion 94
iwndxfreezebr 158 system services 20
iwndxlistbr 159 iwabort 22
iwndxmgrfreeze 160 iwaccess 23
iwndxmgrstatus 161 iwaccessmigrate 32
iwndxmgrstop 162 iwancestor 35
iwsrchattrib 197 iwchgrp 36
iwsrchgethome 200 iwconfig 37
iwsrchgetpage 201 iwconfigtsreport 38
iwsrchmgrping 203 iwfreeze 41
iwsrchmgrstop 204 iwgroup 56
iwsrchndxstatus 205 iwprefconv 67
iwsrchndxstatuschg 207 iwproxy 68
iwsrchquery 208 iwreset 70
search manager iwroleadm 72
stop 204 iwsi 76
server
iwteamsite 82
proxy 68
iwtestcfg 83
removing job 184
server operation
terminating 22

Index
iwtock 84 V
iwuseradm 88 version management 98
iwutildreset 92 iwcat 116
iwutildstat 93 iwcmp 118
iwrevert 179
T iwrlog 180
task version paths 13
add users 104 printing 219
adding file 102 relative 14
assigning 212 vpaths 13, 116
attribute 191 relative 14
comment 192
delete file 122 W
description 193
watchdog daemon 82
file comment 194 workarea
finishing 213 changing group ownership 36
information 134 creating 155, 230
owner 195, 217 deleting 234
querying 175 history 124
remove group 186 locking 152
remove users 187 locks 149
removing a file from 185 private 172
rename file 156 removing 188
reverse transition 215 renaming 177
variables 214 submitting 211
TeamSite
update 218
service monitor 76, 82
TeamSite program files workarea operation 97
location 50 iwevents 124
timeout 196 iwlistlocks 149
tracelogs iwlistmod 150
location 55 iwlock 151
iwlockinfo 152
iwmkwa 155
U iwprv 172
unfreeze 41 iwrmwa 188
unlock 237 iwsubmit 211
update tasks iwunlock 216
resolving conflicts 178 iwupdate 218
user properties 170 workflow
user_databases.xml 140, 142, 146 job and task IDs 49
users workflow event 133
add to task 104 workflow variables
authenticating 113 manipulating 138
list of 69 workflow/job 98
manage 88 iwaddtaskfile 102
role 117 iwaddtaskgroup 103
utility daemon iwaddtaskuser 104
configuring 92 iwcallback 115
statistics 93 iwdeltaskfile 122
iwgeteventcomments 132
iwgeteventfiles 133
iwgettaskbyname 134
iwgetwfobj 135

Index
iwinvokejob 136
iwjobc 137
iwjobvariable 138
iwmvtaskfile 156
iwqueryjobs 174
iwquerytasks 175
iwretryjobop 178
iwrmjob 184
iwrmtaskfile 185
iwrmtaskgroup 186
iwrmtaskuser 187
iwsetjobdescription 189
iwsetjobowner 190
iwsettaskattrib 191
iwsettaskcomment 192
iwsettaskdescription 193
iwsettaskfilecomment 194
iwsettaskownerandarea 195
iwsettasktimeouttask 196
iwtaketask 212
iwtaskselect 213
iwtaskvariable 214
iwundochoice 215
iwuntaketask 217

Index

Ts 671sp1 CLT Win v01 en

Hochgeladen von

Dokumentinformationen

Originalbeschreibung:

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Ts 671sp1 CLT Win v01 en

Hochgeladen von

Copyright:

Verfügbare Formate

TeamSite ®

Interwoven, ConfirmSite, ContentServices, ControlHub, DataDeploy, DeskSite, FileSite, iManage,

TeamSite Command-Line Tools

TeamSite Command-Line Tools 3

TeamSite Command-Line Tools 5

TeamSite Command-Line Tools 7

How This Manual is Organized

ContentCenter Professional User’s Guide 9

Table 1 Notation conventions

Overview of CLTs and

TeamSite Command-Line Tools 11

Before Using CLTs

To specify a Content Store:

To specify a branch or subbranch:

TeamSite Command-Line Tools 13

The name of an edition on the subbranch dev would be:

To specify an individual file within a workarea:

you would only need to specify:

For example, a file whose vpath is:

would have the directory path of:

Executing CLTs Remotely

To run CLTs from a remote system complete the following procedure:

Object IDs are 24-digit hexadecimal numbers, such as:

TeamSite Command-Line Tools 15

staging area 0x00002255

submit event 0x00002258

update event 0x0000225A

file or directory 0x00001008

For example, a CLT could require a comment to be specified using an option:

The second way of specifying a comment is as a required field:

TeamSite Command-Line Tools 17

System Information Tools

Table 2 System information tools

TeamSite Command-Line Tools 19

System Services Tools

Table 3 System services tools

Content Store Tools

Table 4 Content Store tools

TeamSite Command-Line Tools 21

Man Page Group

operation_id The operation_id displayed by iwstat.

Status: Server running

ID Thread User Duration Operation

Man Page Group

iwaccess add-permission-entry vpath -user user -role role

iwaccess add-windows-permission vpath -user user -perm perm [-mode

iwaccess all-operations-of-user user

iwaccess all-permission-entries-of-user user [-verbose]

iwaccess all-roles-of-user user

iwaccess check-job-permission jobid -user user -op op

iwaccess check-permission vpath -user user -op op

iwaccess check-task-permission taskid -user user -op op

iwaccess clear-permission-entries vpath

iwaccess delegable-roles-of-user vpath -user user

iwaccess export-permission-entries file

TeamSite Command-Line Tools 23

iwaccess group vpath

iwaccess import-permission-entries file [-clear]

iwaccess inheritance vpath

iwaccess owner vpath

iwaccess permission-entries vpath [-modinfo] [-inherited]

iwaccess private vpath