Getting Started Using the Bulk Loader

Since ibld is a Java application, before running the ibld command, set the CLASSPATH environment variable (or its equivalent) to point to the directory where the bearepadm.zip file is located. For example, on UNIX, <TuxBldr_dir>/client/lib and on NT, the lib directory of the Java run-time environment or the lib directory specified during installation for the location of Java. If CLASSPATH is not set correctly, the Java Virtual Machine cannot locate the required classes.

For security reasons, ibld does not use command-line arguments to specify user authentication information (user password or application password). Depending on the server's security level, ibld will automatically prompt you for the passwords.

The bulk loader utility gets its input from command-line arguments and from the input file.

Using UNIX Platforms

To activate the bulk loader on a UNIX platform:

1. Type the following prompt:

   setenv CLASSPATH <pathname>

   java bea.repositoryadm.ibld [-n] [-u usrname] [-r usrrole] <//host:port filename>

2. Type your user password and application password, if required.

Using Windows NT or Windows 95 Platforms

To activate the bulk loader on a Windows NT or Windows 95 platform:

1. Type the following:

   C:\> set CLASSPATH=C:<pathname>

   C:\> java bea.repositoryadm.ibld [-n][-u usrname] [-r usrrole] <//host:port> <filename>

2. Type your user password and application password (if required) and press Enter.

Table 4-1 describes the command-line options for the ibld (bulk loader) command.

Table 4-1 ibld Command Line Options

Option	Description
-u usrname	Specifies the user name (default is your account name). (Mandatory if required by security)
-r usrrole	Specifies the user role (default is admin). (Mandatory if required by security)
-n	Validates input file against the current repository; no updates are made to the repository. (Optional)
//host:port	Specifies the JSL address (host name and IP port number). (Mandatory)
-c	Specifies clean mode and deletes contents of BLKPKG. (Optional)
-o	Overwrite mode updates new over old. (Optional)
filename	Specifies the file containing the service definitions. (Mandatory)

About the Bulk Load File

The bulk load file is a text file that defines services and their associated parameters. The bulk loader loads the services defined in the bulk loader file into the Contract Repository using the package name, BULKPKG. If a bulk load has been performed, the BULKPKG package exists in the Contract Repository. If another load is performed from a bulk loader file, all the services in the original BULKPKG are deleted. A new BULKPKG package is created with the services from the new bulk loader file.

If a service exists in a package other than BULKPKG, the bulk loader reports the conflict and does not load a service from the bulk loader file into the Contract Repository unless the -o option is used. Use the Contract Repository Editor to remove duplicate services and load the bulk loader file again. See Tasks for additional information.