IBM E02HMLL-I Implementation Guide - Page 130

Exporting, components, package

Page 130 highlights

C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -doBusObj:Customer -deep This option, unlike the -dfo option, is supported with servers running in production mode because the deletion of the referents along with the component guarantees that the repository remains valid. Keep in mind, however, that it can result in many components being deleted; you should be aware of the implications of this action prior to taking it. Exporting components to a package The -o option allows you to export components from the repository to a package. You must specify the name of the package file. When the -o option is used alone the entire repository is exported to a file, as in the following example: C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -oWebSphereICSServer.jar You can specify individual components to be exported by using the -e option. You must use the -e option with the appropriate EntityType keyword listed in Table 12 on page 113, and must follow the keyword with the name of the component. You can specify multiple components by concatenating them with the plus (+) sign. In the following example, the Customer business object and CustomerSync collaboration template are exported to a package named CustomerSyncInterface.jar. C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -eBusObj:Customer+CollabTemplate:CustomerSync -oCustomerSyncInterface.jar You can use the -deep option to export the dependencies of a component as well. In the previous example, the Customer business object was exported, but none of its child business objects were. The following example uses the -deep option to export the CustomerSync_ClarifyToSAP collaboration object and all of its dependencies. C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -eCollaboration:CustomerSync_ClarifyToSAP -oCustomerSyncInterface.jar -deep If you want to export specific components, but do not want to have to enter the entity type keyword and component names, you can store them in a text file and use the -f option. This is very convenient when you want to frequently export the same components. The following example uses the -f option to load the components listed in a text file named Components.txt : C:\WebSphereICS>repos_copy -sWebSphereICSServer -uadmin -pnull -fComponents.txt -oCustomerSyncInterface.jar -deep The contents of the file Components.txt are shown below; a paragraph return follows each entity type keyword and name combination: BusObj:Customer Relationship:Customer CollabTemplate:CustomerSync Note: Repos_copy and System Manager are unfortunately inconsistent with respect to what they identify as "dependencies". If you attempt to delete a component using repos_copy but there are components that depend upon it then repos_copy lists those referring components as dependencies. However, if you right-click the component in System Manager and select Show Dependencies from the context menu the tool lists the components that the selected component depends on. 118 IBM WebSphere Business Integration Server Express and Express Plus: System Implementation Guide

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302

C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-doBusObj:Customer
-deep
This
option,
unlike
the
-dfo
option,
is
supported
with
servers
running
in
production
mode
because
the
deletion
of
the
referents
along
with
the
component
guarantees
that
the
repository
remains
valid.
Keep
in
mind,
however,
that
it
can
result
in
many
components
being
deleted;
you
should
be
aware
of
the
implications
of
this
action
prior
to
taking
it.
Exporting
components
to
a
package
The
-o
option
allows
you
to
export
components
from
the
repository
to
a
package.
You
must
specify
the
name
of
the
package
file.
When
the
-o
option
is
used
alone
the
entire
repository
is
exported
to
a
file,
as
in
the
following
example:
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-oWebSphereICSServer.jar
You
can
specify
individual
components
to
be
exported
by
using
the
-e
option.
You
must
use
the
-e
option
with
the
appropriate
EntityType
keyword
listed
in
Table
12
on
page
113,
and
must
follow
the
keyword
with
the
name
of
the
component.
You
can
specify
multiple
components
by
concatenating
them
with
the
plus
(+)
sign.
In
the
following
example,
the
Customer
business
object
and
CustomerSync
collaboration
template
are
exported
to
a
package
named
CustomerSyncInterface.jar
.
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-eBusObj:Customer+CollabTemplate:CustomerSync
-oCustomerSyncInterface.jar
You
can
use
the
-deep
option
to
export
the
dependencies
of
a
component
as
well.
In
the
previous
example,
the
Customer
business
object
was
exported,
but
none
of
its
child
business
objects
were.
The
following
example
uses
the
-deep
option
to
export
the
CustomerSync_ClarifyToSAP
collaboration
object
and
all
of
its
dependencies.
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-eCollaboration:CustomerSync_ClarifyToSAP
-oCustomerSyncInterface.jar
-deep
If
you
want
to
export
specific
components,
but
do
not
want
to
have
to
enter
the
entity
type
keyword
and
component
names,
you
can
store
them
in
a
text
file
and
use
the
-f
option.
This
is
very
convenient
when
you
want
to
frequently
export
the
same
components.
The
following
example
uses
the
-f
option
to
load
the
components
listed
in
a
text
file
named
Components.txt
:
C:\WebSphereICS>repos_copy
-sWebSphereICSServer
-uadmin
-pnull
-fComponents.txt
-oCustomerSyncInterface.jar
-deep
The
contents
of
the
file
Components.txt
are
shown
below;
a
paragraph
return
follows
each
entity
type
keyword
and
name
combination:
BusObj:Customer
Relationship:Customer
CollabTemplate:CustomerSync
Note:
Repos_copy
and
System
Manager
are
unfortunately
inconsistent
with
respect
to
what
they
identify
as
“dependencies”.
If
you
attempt
to
delete
a
component
using
repos_copy
but
there
are
components
that
depend
upon
it
then
repos_copy
lists
those
referring
components
as
dependencies.
However,
if
you
right-click
the
component
in
System
Manager
and
select
Show
Dependencies
from
the
context
menu
the
tool
lists
the
components
that
the
selected
component
depends
on.
118
IBM
WebSphere
Business
Integration
Server
Express
and
Express
Plus:
System
Implementation
Guide