Documente Academic
Documente Profesional
Documente Cultură
Version 8 Release 1
User Guide
LC19-2453-00
Version 8 Release 1
User Guide
LC19-2453-00
This document is made available to you as a licensed user of the IBM Information Server software product and is subject to the terms regarding Restricted Materials specified in the Authorized Use provision in the Part of your IBM Customer License (or equivalent license under which you obtained the IBM Information Server software) governing ICA Programs. You must take appropriate steps to ensure that access to this document and any hardcopies thereof is limited to licensed users within your enterprise, and that the scope of use is limited to the Authorized Uses permitted uses under your license. Distribution outside of your enterprise is strictly prohibited and is deemed a material breach of your license agreement with IBM. Copyright International Business Machines Corporation 2008. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Chapter 1. IBM Information Server Manager overview . . . . . . . . . . 1
Basic deployment scenario . . . . . . IBM Information Server Manager workflow Deploying changes to an application . . Deployable objects . . . . . . . . . . . . . . . . . . . . . . . . 1 1 2 2 Deploying packages: Single server model . Deploying packages: Multiple server model Importing and exporting objects . . . . . Exporting objects . . . . . . . . . Importing objects . . . . . . . . . Viewing the log . . . . . . . . . . . . . . . . . . . . . . . 11 12 12 13 13 13
Product documentation . . . . . . . 29
Contacting IBM . . . . . . . . . . . . . 29
Notices . . . . . . . . . . . . . . 31
Trademarks . . . . . . . . . . . . . . 33
Index . . . . . . . . . . . . . . . 35
iii
iv
the package to the file system. A production manager (or any user with access to the required target project and the build package) would then apply the package to a project on the target system. The following diagram shows the workflow of a created package:
Deployable objects
You can deploy most types of DataStage objects with the Information Server Manager. You can add the following types of objects to your deployment packages: v v v v v v v v v v Data elements IMS databases IMS viewsets Jobs (mainframe, parallel, sequence, and server) Machine profiles Routines (mainframe, parallel, and server) Shared containers (parallel and server) Table definitions Transforms Custom folders (external files in the WebSphere DataStage server project directory)
v v v v
QualityStage rule sets QualityStage match specifications Parallel custom stages, build stages, and wrapper stages Parameter sets
You can also deploy job executables, which might be required where your target domain can only run jobs and not compile them. These executables will only work if certain conditions are met (such as the criteria matching exactly).
Adding a domain
When you launch the IBM Information Server Manager, your first task is to add a domain. 1. In the Repository view, right-click and select Add Domain. The Add Domain window opens. 2. In the Add Domain window, specify the application server, user, password, and whether or not the password should be saved. By default, the Save Password setting is unchecked. You can change the default password setting by changing the Save Password option in the Preferences dialog. Changing the Save Password setting in the Preferences applies to all subsequent invocations of the Add Domain dialog, but changing the Save Password setting in the Add Domain dialog applies only to the specified domain. If the Save Password setting was previously enabled, then the password will be remembered. 3. After the connection information has been specified, expand the list of available DataStage projects and package definitions on the domain and select a project. When you select a project, the project namespace in the Properties view displays the Information Server engine on which the project resides. 4. If you need to reconnect to a disconnected application server, right-click on it and select Connect. Alternately, you can double-click on the disconnected domain in the Repository tab. If a valid password has been previously saved for that domain, Information Server Manager will connect without prompting. If there is no previously-saved password, the Edit Domain window opens and you are prompted to enter a password.
Save a package definition Before you can build a package, you are required to first save that package definition. However, if you create a package definition to build at a later time, you are not prompted to save it, and must do so manually. The same is true if you make changes to a package definition. Copy a package definition Make a copy of a package definition by selecting Copy, right-clicking Packages in the navigation tree, then selecting Paste. The Repository View displays the new package definition copy. Delete a package definition Delete a package definition from the repository by right-clicking on the definition you want to remove, then selecting Delete. The history of the deleted package remains in the logs on the Information Server web console.
Multiple views
When you open more than one package view in the IBM Information Server Manager, multiple tabs open in the window you are viewing. You click each of the tabs to view the respective page. When you open multiple windows in the IBM Information Server Manager, each window opens alongside one another in a column format. You can change windows to a horizontal orientation. You can change the Properties view to a horizontal orientation within the left navigation pane. To change the orientation of a window: 1. Click in the upper area of the window, next to the tab-level headings.
2. Drag the window to another area within the Information Server Manager interface. Column and row lines will appear at potential placement locations for the window you are moving. 3. When the desired placement (column or row) is outlined, release the mouse button, and the window view will appear in the new location.
v Use the button to remove criteria. Searches match objects that satisfy all of the listed criteria. To allow global sort, any new results are integrated into the table with the prior results.
Chapter 2. Using the IBM Information Server Manager
v To limit your search to only include the contents of the Information Server Manager Help system, click the arrow next to the Search icon to the right of the search field, the select Search Help from the drop-down list.
To 1. 2. 3.
create a deployment package, you must complete the following subtasks: Define the package. Save the package. Build the package.
In the creation step, the package is built in a location that you specify in the preferences. Information about the deployment is stored in the metadata repository and reused in later deployments.
On the left-side view, items in red indicate that these items were deleted from the newer version of the build. These colors settings are the default. You can customize the colors in the Preferences menu by selecting Package, then History Comparison Colors in the navigation view.
Note: At the bottom left of the Information Server Manager screen is the number of changes found within specific builds.
10
Deploying packages
Different users can participate in deploying a single package by accessing different servers. In a multiple user scenario, the first user must have access to the source server, and the DataStage projects that reside on that server. The second user must have access to the target domain.
11
3. After verifying your settings, click Finish, and the package is deployed to the target project. When the deployment is complete, a Deploy Results window opens, displaying the status of the deployment. In this window, you can view the deployment details, copy the details to a clipboard, or click OK to proceed.
12
You can move objects between projects without having to perform a full deployment. This movement is useful in cases where there is a subset of project objects that must be populated in a secondary environment.
Exporting objects
You can use the IBM Information Server Manager to export objects to an archive file. Use the Information Server Manager to export objects to an archive file which you store on the client computer. You can then import the package to a different project. To export objects: 1. Connect to the server and engine that contain the objects you want to export. See Adding a domain on page 5. 2. Right-click the project or any objects in that project that you want to export from, and then select Export. The object is added to the Export editor. You can drag and drop additional objects into the Export editor. 3. When your list is complete, click Export. 4. In the Export window, specify the target location for the export package. 5. Click Save.
Importing objects
You can use the IBM Information Server Manager to import objects to a specific project. To import objects: 1. Right-click on any node within DataStage or on the DataStage node, and select Import. The Select a file to import window opens where you can choose a file to import. 2. Select a file to import. The Import editor opens, displaying a list of items in the archive. 3. Click Import. 4. Select the target project and set the option to replace any existing items in the Import dialog. 5. Click OK.
13
14
15
In the Command mode, commands are entered one at a time on a single command line. Each command line starts with a command, then the options. Option values that contain embedded spaces must be surrounded by double quotes. Command syntax:
istool {command } [-options ... ]
Console mode (in a command prompt) An alternative to entering commands one-by-one, which might require a new Information Server connection to be established for each command, is to execute istool with no options. This puts istool in Console mode. In Console mode, istool caches connections to the Information Server. This reduces execution time for subsequent commands to the same Information Server. In Console mode, istool prints a command prompt and waits for a command. Each command is processed without exiting istool. You can exit the Console mode by entering ., exit, or quit at the prompt. istool in Console mode also provides a history feature, which recalls the last 30 commands entered. Each command can be recalled and re-executed. Command syntax:
istool
Option syntax: No options are required for Console mode. Script mode istool can be used to execute commands read directly from a text file. The file is read and executed as a series of command lines. In Script mode, connections to the Information Server are cached between commands. This causes significantly faster command execution. Each line in the input file must be formatted exactly the same as a command line entered manually, except for the following stipulations: v The -username/-password options can be specified only the first time a domain option is given. Subsequent commands only require the corresponding domain option and username option to identify the server. v It is not necessary to include the istool string on each command line. v Multiple commands are separated by a semicolon character (;) at the end of an input line. v Command lines can cross line boundaries. Command syntax:
istool script <filename> Table 3. Script command option syntax Flag -script <filename> Description Opens a text file containing istool commands.
16
The following sample script shows an export from -domain d, and an import to -domain e.
istool export -domain d -archive c:/x.isx -ds istool import -domain e -archive c:/x.isx -ds -username u -password p d/project1/routines/a.pjb; -username v -password q -replace e/project2
istool commands
This topic describes the istool commands that support the Information Server Manager Import, Export, and Deployment features.
Purpose
The istool commands provide a scriptable management interface for Deployment, Import, and Export features. These commands parallel the deployment features of the Information Server Manager.
Command syntax
istool build package domain <domain[:port]> -username <username> -password <password> -package <package> [ -comment <comment> ] [ -help ] [ -verbose ] [ -replace ] [ -silent ] [ -preview ] [ -label <buildlabel> ]
Command options
Table 4. istool command options Long name -domain -username -password -package Short name -dom -u -p -pkg Value String String String String Required? Y Y Y Y Description Name of the Information Server domain. Name of the user account on the Information Server domain. Password for the account specified in the -username option. Name of the existing Deployment Package definition in the Information Server repository. Adds a comment to the Deployment package information. Prints detailed information throughout operation. Prints the list of build package command options. Replaces the existing Deployment package. Silences non-error command output. Previews the build operation.
-com -v -h -r -s -pre
N N N N N N
17
Table 4. istool command options (continued) Long name -label Short name -la Value String Required? N Description Label for the build.
Exit status
0 Package was built successfully >0 An error occurred
Error handling
When building a Deployment Package, if at least one object is successfully exported, a Deployment Package file will be created. Exit status will report an error if one or more exports fail.
Purpose
The deploy package command copies the contents of a Deployment Package into a target IBM Information Server repository by using an existing deployment package created with the build package command.
Command syntax
istool deploy package domain server[:port] -username name [-password pass] -package pkg [-label lbl] -datastage [-replace][-repl] server/proj { -silent ][ -verbose ] istool deploy package -domain sliver:9080 -username myName -password myPass -silent -package aPackageName -datastage -repl sliver:5000 "sliver/destProject" -replace, -repl : replace existing DataStage assets with imported assets
18
Command options
Table 5. istool deploy package command options Long name -domain[:port] Short name -dom Value String[:Number] Required? Y Description Name of the IBM Information Server domain. Specifically, this is the machine on which the services tier is installed and the port number under which the IBM Information Server is running in a WebSphere Application Server. Name of the user account on the Information Server domain. Password for account specified in the -username option. Name of the existing Deployment package in the Information Server repository. Print detailed information throughout the operation. Print the list of deploy package command options. Label of Deployment package to deploy. Specify the DataStage deployment options. Silences all non-essential command output.
-u -p -pkg
Y Y Y
-v -h -l -ds -s
N N N Y N
Note: The argument for the -datastage deploy command option is:
[-replace] <project-ID> [-repl]
where -replace replaces existing assets on the target server, and <projectID> is the target of the DataStage project deployment. The default action is to not replace existing assets.
Exit status
0 The deploy package command completed successfully. >0 An error occurred.
Error handling
When deploying a Deployment Package into an Information Server repository, the operation will continue until the entire Deployment Package has been processed. As many objects will be imported as possible. If one or more objects is unsuccessfully added to the repository, the exit status will report an error.
19
Purpose
The export command copies Information Server and DataStage objects to the local file system. Following use of this command, the import command can be used to restore the exported objects into an Information Server repository.
Command syntax
istool export domain <domain[:port]> [ -help ] | [-h] [ -verbose ] | [-v] [ -silent ] | [-s] -username <usernme> | -u <username> [ -password <password> | [ -p <password> ] -archive <filename> | -ar <filename> [ -preview ] | -ds [ -base=<server[:port]>/<project>] [ -incdep ] | [ -includedependent ] [ -nodesign ] | [ -nodes ] [ -incexec ] | [ -includeexecutable ] [ -abort=N ] | [-abortAfter=N ] "dsServer>/<project>/<folder(s)>/<name>.<type>"
Command options
Table 6. istool export command options Long name -domain -username Short name -dom -u Value String String Required? Y Y Description Name of the Information Server domain Name of the user account on the Information Server domain. Password for account specified in the -username option. Name of the archive file. Specifies the Information Server objects and export options to be exported. The value is in the Selector format (see below). Print detailed information throughout the operation. Prints the list of export command options. Silences all non-essential command output.
-password
-p
String
-archive -datastage
-ar -ds
Filename N/A
Y Y
-v -h -s
N N N
20
Table 6. istool export command options (continued) Long name -preview Short name -pre Value N/A Required? N Description Previews the export results without executing the command. Aborts the command when n errors occur.
-abortiferror
-abort
integer
Table 7. istool -datastage options Long name -nodesign -includedependent -includeexecutable -abortAfter=n -base=n Short name -nodes -incdep -incexec -abort=n -base=n Value N/A N/A N/A Integer Path Required? N N N Y N Description Excludes design items. Includes dependent items. Includes executable items. Aborts the command after n errors. Prefix for paths.
Note: The export command only accepts asset and folder paths. Refer to the Asset ID section for a list of path types.
Exit status
0 The export command completed successfully. >0 An error occurred.
Error handling
When exporting more than one object, a failure will not interrupt the operation. If only one object is successfully exported, a package file will still be created. Exit status will report an error if one or more objects cannot be exported.
21
Purpose
The import package command restores Information Server objects from an archive file created by the export command to an Information Server repository. This command is the reverse of the export package command.
Command syntax
istool import domain <domain[:port]> [ -help ] | [ -h ] [ -verbose ] | [ -v ] [ -silent ] | [ -s ] -username <username> | -u <username> [ -password <password> ] | [ -p <password> ] -archive <filename> | -ar <filename> [ -preview ] | [ -pre ] [ -abortAfter N ] | [ -abort N ] [ -replace ] | [ -r ] -datastage | -ds [ -nodes ] [ -nodesign ] <server[ :port]>/<project>
Command options
Table 8. istool import package command options Long name -domain -username Short name -dom -u Value String String Required? Y Y Description Name of the Information Server domain Name of the user account on the Information Server domain. Password for account specified in the -username option. Name of the existing archive on the local filesystem. Specifies the DataStage project. Prints detailed information throughout the operation. Prints the list of export command options. Silences all non-essential command output. Replaces existing DataStage assets with imported assets. Previews the import without executing. Stops after n number of errors.
-password
-p
String
Filename -nodesign; nodes path N/A N/A N/A N/A N/A integer
Y Y N N N N N N-
The import package datastage command only accepts project paths. Refer to the Asset ID section for a list of path types. Note: The argument for the -datastage import command option is:
22
where -nodes is the command shortname and excludes design assets in the import.
Exit status
0 The import packages command completed successfully. >0 An error occurred.
Error handling
When importing a Deployment Package that contains more than one object, a single failure will not interrupt the operation. Exit status will report an error if one or more objects cannot be imported.
Escape characters
In cases where DataStage asset name contain characters that conflict with the istool command-line syntax, you must escape those characters in the command line. In situations where DataStage asset names contain characters that conflict with the istool command-line syntax, you escape those characters in the command line. The istool command uses the backslash character (\) as an escape character. Inserting a backslash in front of one of these special characters changes the way istool treats the character. In cases where a DataStage asset name contains a backslash (\), you must enter a double backslash: (\\). The following table shows how to enter characters that require special treatment.
Table 9. Escape characters for istool Character Syntax Example istool export .... ds server/project/name_contains_a_back\\slash.type Command mode: istool export .... ds server/project/nam\\\"e.type Console and Script mode: istool export .... ds server/project/name\"contains\"quotes.type (singlequote) . (period) \ istool export .... ds server/project/name\contains\single\quote.type istool export .... ds server/proj\.ect/name.type
\.
23
Table 9. Escape characters for istool (continued) Character * (star) Syntax \* Example istool export .... ds server/project/folder/name\*star.type
Note: When entering a command line in the command mode, you must triple escape a double-quote character, because a single backslash will result in a syntax error. however, in the Console and Script modes, a single backslash is sufficient. The double-quote entry in the table above provides examples. When the asset name contains embedded spaces, you surround the entire asset with double-quotes. The following example shows how to enter an asset path whose name contains space characters:
ds "server/project/name has embedded spaces.type"
Asset IDs
This topic defines Asset IDs and how they function within the Command Line interface. An Asset ID is a fully-qualified path that describes a project, folder, or specific asset, and exists within the Information Server. You obtain Asset IDs for DataStage assets by selecting an item in the Information Server Manager User Interface. Asset IDs are used specifically to identify assets and can be used in any of the following forms: v DataStage project path:
server/project
The DataStage project path only works with deploy and import commands. v DataStage folder path:
server/project/folder/*.* server/project/folder/*/*.*
The DataStage folder path only works with the export command v DataStage asset path:
server/project/folder1/*/name.type server/project/folder1/*/*.type
The DataStage asset path only works with the export command. An Asset ID for a project implicitly refers to all of the individual assets contained within that project.
Wildcard characters
Asset IDs can use a wildcard character. Certain fields and portions of Asset Paths can be replaced with an asterisk (*),which helps match all possible values at a specified level. For example:
24
istool export domain isdom.ibm.com username bspieter password pswd -archive c:/ds_export/today datastage base=serv1/development Routines/Examples/Functions/Conver*.srt Routines/Examples/Functions/*Month.srt */ConvertMonth.srt */*.srt
Wildcards can be used in the following ways: v In place of Asset names: *.pjb v Beginning an Asset name: *Month.srt v Ending an Asset name: Conver*.srt v Beginning and end of an Asset name: *job*.pjb v In place of an Asset type: job.* v In place of a folder for recursive match: server/project/folder1/*/*.pjb
Wildcard examples
v Server/project/Routines/Examples/*/ConvertMonth.srt means server routines with the name =ConvertMonth in the folder Routines/Examples and its subfolders (for example, recursively). v Server/project/*/ConvertMonth.srt means export server routines with the name =ConvertMonth in the specified project and all its folders. v Server/project/folder1/*/*.srt meant export all server routines in folder1 and its subfolders. v Server/project/folder1/*/*.* means export all objects in folder1 and its subfolders.
server1/project2/folder1/folder2/folder3/myprofile.mcp server1/project2/*/myprofile.mcp server1/project2/folder1/*/myprofile.mcp server1/project2/folder1/folder2/folder3/*.mcp server1/project2/folder1/folder2/folder3*.* server1/project2/folder1/folder2/folder3/*profile.* server1/project2/folder1/*job*.pjb server1/project2/folder1/job*.pjb server1/project2/folder1/*/*.*
The same wildcard rules that apply to all assets also apply to the asset name: The wildcards can only appear in the beginning, end, both beginning and end, or in place of the asset name. The following example shows valid wildcarding of table definitions on the export command:
istool export domain isdom.ibm.com username name password pswd -archive c:/arc.isx datastage server/project/folder/*DST\\DSN\\TableName.tbd server/project/folder/DST\\DSN\\TableName*.tbd
Chapter 4. Deploying objects using a command line
25
Asset ID examples
This topic provides examples of Asset IDs that use the istool export command.
Asset ID example 1
In this example of the istool export command, a Deployment archive is created that includes a DataStage Parallel Routine. The IBM Information Server engine name is slick, the asset type is prt (DataStage Parallel Routine), and the asset name is DSJobReport. In addition, as indicated by the -incdep option, any dependent assets are exported. Note that an Asset ID must be surrounded by quotes () to protect an embedded space. An embedded forward slash / in a folder name is escaped with a backslash \. All other special characters require no special consideration.
istool export domain slick.svl.ibm.com:9090 username isadmin password isPass archive c:/Documents and Settings/Bill/My Documents/archive1 ds -incdep slick/development/Routines/Built In/Before\/After/DSJobReport.prt
Asset ID example 2
In this example of istool export, a hierarchy of DataStage Folders is selected for export. Any number of assets of varying types will be exported to the archive c:/ds_export/today. Note that Asset IDs are separated by a space ( ), and that no asset type is specified.
istool export domain isdom.ibm.com username bspieter password pswd -archive c:/ds_export/today datastage server/project/folder/*.* serv1/development/Jobs/January/*.* serv3/development/Jobs/February/*.* servA/test/tested Jobs/dayFolder/*.*
Asset ID example 3
Options that take an Asset ID argument provide a -base option for identifying a common portion of the following Asset IDs:
istool export domain isdom.ibm.com username bspieter password pswd -archive c:/ds_export/today datastage base=serv1/development Jobs/Job1/*.* Jobs/January/*.* Jobs/February/*.* Jobs/April/*.* Jobs/TheRest/*.*
Asset types
This topic lists the various DataStage asset types
26
Commands that use an Asset Identifier must identify the Asset type that uses a predetermined type suffix in the type name or the corresponding long name. Type suffixes and long-names are case-insensitive.
Table 10. Asset type names Asset type DataStageDataElement DataStageIMSDatabase DataStageIMSViewset DataStageMainframeJob DataStageParallelJob DataStageSequenceJob DataStageServerJob DataStageMachineProfile DataStageMainframeRoutine DataStageParallelRoutine DataStageServerRoutine DataStageParallelSharedContainer DataStageServerSharedContainer DataStageTableDefinition DataStageTransform DataStageDataQualitySpec DataStageFolder DeploymentPackage DataStageStageType DataStageDataConnection DataStageParameterSet Long name dataelement imsdatabase imsviewset mainframejob paralleljob sequencejob serverjob machineprofile mainframeroutine parallelroutine serverroutine parallelsharedcontainer serversharedcontainer tabledefinition transform dataqualityspec folder package stagetype dataconnection parameterset Type suffix det idb ivs mjb pjb qjb sjb mcp mrt prt srt psc ssc tbd tfm dqs dfr pkg stp dcn pst
27
28
Product documentation
Documentation is provided in a variety of locations and formats, including in help that is opened directly from the product interface, in a suite-wide information center, and in PDF file books. The information center is installed as a common service with IBM Information Server. The information center contains help for most of the product interfaces, as well as complete documentation for all product modules in the suite. A subset of the product documentation is also available online from the product documentation library at publib.boulder.ibm.com/infocenter/iisinfsv/v8r1/ index.jsp. PDF file books are available through the IBM Information Server software installer and the distribution media. A subset of the information center is also available online and periodically refreshed at www.ibm.com/support/docview.wss?rs=14 &uid=swg27008803. You can also order IBM publications in hardcopy format online or through your local IBM representative. To order publications online, go to the IBM Publications Center at www.ibm.com/shop/publications/order. You can send your comments about documentation in the following ways: v Online reader comment form: www.ibm.com/software/data/rcf/ v E-mail: comments@us.ibm.com
Contacting IBM
You can contact IBM for customer support, software services, product information, and general information. You can also provide feedback on products and documentation.
Customer support
For customer support for IBM products and for product download information, go to the support and downloads site at www.ibm.com/support/us/. You can open a support request by going to the software support service request site at www.ibm.com/software/support/probsub.html.
My IBM
You can manage links to IBM Web sites and information that meet your specific technical support needs by creating an account on the My IBM site at www.ibm.com/account/us/.
29
Software services
For information about software, IT, and business consulting services, go to the solutions site at www.ibm.com/businesssolutions/us/en.
General information
To find general information about IBM, go to www.ibm.com.
Product feedback
You can provide general product feedback through the Consumability Survey at www.ibm.com/software/data/info/consumability-survey.
Documentation feedback
You can click the feedback link in any topic in the information center to comment on the information center. You can also send your comments about PDF file books, the information center, or any other documentation in the following ways: v Online reader comment form: www.ibm.com/software/data/rcf/ v E-mail: comments@us.ibm.com
30
Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the users responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Copyright IBM Corp. 2008
31
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation J46A/G4 555 Bailey Avenue San Jose, CA 95141-1003 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBMs future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.
32
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights reserved. If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Trademarks
IBM trademarks and certain non-IBM trademarks are marked on their first occurrence in this information with the appropriate symbol. IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol ( or ), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/ copytrade.shtml. The following terms are trademarks or registered trademarks of other companies: Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency, which is now part of the Office of Government Commerce. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. ITIL is a registered trademark and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office. UNIX is a registered trademark of The Open Group in the United States and other countries. Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.
Notices
33
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. The United States Postal Service owns the following trademarks: CASS, CASS Certified, DPV, LACSLink, ZIP, ZIP + 4, ZIP Code, Post Office, Postal Service, USPS and United States Postal Service. IBM Corporation is a non-exclusive DPV and LACSLink licensee of the United States Postal Service. Other company, product, or service names may be trademarks or service marks of others.
34
Index A
accessibility 29 adding a domain 5 application, Deploying changes to 2 Asset ID examples 26 Asset IDs 24 Asset types 27
E
escape characters 23 examples, Asset ID 26 export command, istool 20 exporting objects with the IBM Information Server Manager 13 exporting objects, importing and 13
M
Manager workflow, IBM Information Server 1 modes, istool command 15 modifying the deployment package 9 multiple server model, deploying packages 12
B
basic command-line syntax 15 Basic deployment scenario 1 basic IBM Information Server Manager functions 5 building deployment packages 9
F
functions, basic IBM Information Server Manager 5
O
object properties, view 6 objects exporting 13 importing, with the IBM Information Server Manager 13 objects using a command line, deploying 15 objects, deployable 2 objects, importing and exporting 13 objects, searching 11 options, command-line 15 overview, IBM Information Server Manager 1
I
IBM Information Server Manager starting 5 IBM Information Server Manager functions, basic 5 IBM Information Server Manager overview 1 IBM Information Server Manager view, customize 6 IBM Information Server Manager workflow 1 IBM Information Server Manager, search 7 IBM Information Server Manager, using 5 IBM support 29 IBM WebSphere DataStage and WebSphere QualityStage objects, deploying 11 ID examples, Asset 26 IDs, Asset 24 import command, istool 22 importing and exporting objects 13 importing objects 13 Information Server Manager workflow, IBM 1 istool command modes 15 istool commands 17 istool export command 20 istool import command 22
C
characters, escape 23 command line, deploying objects using 15 command modes, istool 15 command-line options, common 15 command-line syntax, basic 15 command, deploy package 18 command, istool export 20 command, istool import 22 commands, istool 17 creating the deployment package 8 customer support 29 customize the IBM Information Server Manager view 6
P
package, creating the deployment packages, deploying 11 packages, searching for objects to include 11 packages, work with 6 preferences, user 7 properties, view object 6 8
D
defining the deployment package 9 deploy package command 18 deployable objects 2 Deploying changes to an application 2 deploying IBM WebSphere DataStage and WebSphere QualityStage objects 11 deploying objects using a command line 15 deploying packages 11 single user model 11 deploying packages: multiple server model 12 deployment package, building 9 deployment package, creating 8 deployment package, defining and modifying 9 deployment scenario, Basic 1 documentation accessible 29 domain, adding a 5
S
scenario, Basic deployment 1 screen readers 29 search the IBM Information Server Manager 7 searching for objects to include in packages 11 Server Manager workflow, IBM Information 1 set the user preferences 7 shared container design, view 6 single user model, deploying packages 11 software services 29 starting the IBM Information Server Manager 5 support, customer 29
J
job or shared container design, view job, view 6 6
L
legal notices 31 log viewing 13
T
trademarks 33 types, Asset 27
35
U
user preferences, set 7 using a command line, deploying objects 15 using the IBM Information Server Manager 5
V
view a job or shared container design view object properties 6 viewing build histories 9 viewing, log 13 6
W
wildcard 24 work with packages 6 workflow, IBM Information Server Manager 1
36
Printed in USA
LC19-2453-00