DataBlade Module Installation and Registration Guide Registering with the BladeManager Command-Line Interface

This section describes how to complete the tasks described in the following subsections:

• Starting and Stopping BladeManager, next
• Obtaining Help for Commands
• Setting Confirmation
• Executing BladeManager Commands Automatically at Startup
• Executing Multiple BladeManager Commands
• Removing BladeManager Objects for Server Reversion

To start BladeManager, enter the following command at the UNIX or the MS-DOS command line prompt:

blademgr

Your screen displays a prompt consisting of the value of the current database server (the value of the INFORMIXSERVER environment variable when you start BladeManager) and an angle bracket (>). To execute BladeManager commands, enter the command name.

Important: If BladeManager fails to execute, make sure that Informix environment variables are set to run Informix database utilities. See Prerequisite Tasks for more information.

To exit BladeManager, enter one of the following commands:

• bye
• exit
• quit
• an end-of-file key sequence, such as CTRL-D or CTRL-Z

To see a list of BladeManager commands and their syntax, enter one of the following commands:

• help
• ?

If confirmation is on, BladeManager prompts you to confirm the following tasks:

• Register a DataBlade module with the register command
• Unregister a DataBlade module with the unregister command
• Install a client file with the add client command
• Uninstall a client file with the del client command

When confirmation is off, BladeManager issues no confirmation prompt when you execute these commands. You might want to turn confirmation off when you use BladeManager in batch operations, so you can send commands to BladeManager from a file.

To turn confirmation on, enter the following command:

set confirm on

To turn confirmation off, enter the following command:

set confirm off

When BladeManager starts, it searches for the batch file blademgr.run in the current directory. If BladeManager finds the file, it executes any commands in it before it displays the prompt that allows you to enter commands. You can edit this file and place commands in it that are automatically executed whenever BladeManager starts.

For example, if you do not want to be prompted for confirmation each time you register a DataBlade module, you can put the set confirm off command in blademgr.run to turn confirmation off automatically whenever you run BladeManager.

If you include multiple commands in blademgr.run, separate each command with a carriage return.

To execute a series of BladeManager commands using shell redirection, enter the following command:

blademgr < filename.txt

The filename.txt specification in the example represents the name of a text file that contains one or more BladeManager commands, each on a separate line.

If you want to revert to an earlier version of your database server, you must remove every database object added since the database server and database were upgraded. BladeManager adds its objects to a database whenever you connect to a database with BladeManager. To remove BladeManager objects from the specified database, enter the following command:

unprep database_name

To successfully revert to a previous version, the following conditions must be true about your database:

• You must have removed any new database objects.
• You must not have altered any existing database objects: for example, by upgrading existing DataBlade modules.

For more information on server reversion, see the Informix Migration Guide.