ratool utility

The ratool utility is an alternative way to administer and configure your connection.

NoteCommand options are case sensitive.

Syntax

 ratool [-host hostname] [-port portnumber] [-user <username>]
 [-password <password>] [-help] [-loglevel <loglevel_type>]
 [<Command_option>] 

Options

This table shows the valid options of ratool.

Table 8-1: ratool options

-host <hostname>

Identifies the name of the host where the RepConnector runtime is running. The default is “localhost”.

-port <portnumber>

The port number where the RepConnector runtime instance is listening. The default value is 8080.

-user <username>

The RepConnector administrator login user ID. The default administrator user name is repraadmin.

password<password>

The password for RepConnector administrator login. By default, there is no administrator password.

-help

Displays a usage message. If used alone, displays help on all ratool commands. If used with the name of a command line flag or command option, displays help for that command line flag or command option.

help <command_option>

Displays the help information for a specific ratool command_option. If a command_option is not specified, it displays a list of the available command options.

NoteDo not include “-” before the help command flag when you display help information for a command option.

-logfile <file_name>

Sends the logging information for ratool to a specified file.

-loglevel <loglevel_type>

Determines the level of logging information to display. Valid values are:

FATAL ERROR WARNING INFO DEBUG

Command Options

-start <conn_name>

Starts a specific connection.

-startAll

Starts all connections

-stop <conn_name>

Stops a specific connection.

-stopAll

Stops all running connections.

-refresh <conn_name>

Refreshes a specific connection.

-refreshAll

Refreshes all connections.

-import <conn_name> <conn_prop_file> [-override]

Adds a new connection. If -override is specified, this command option updates the connection property information for an existing connection.

-delete <conn_name>

Deletes a connection.

-rename <conn_name> <new_conn_name>

Renames a connection name.

-copy <conn_name> <new_conn_name>

Copies a connection name to a new connection name.

-validate <conn_prop_file>| | <conn_name>

Validates a new connection profile or an existing connection.

-list

Lists all known connections.

-status <conn_name>

Lists connection status. If no connection name is specified, this command option gives the status of all known connections. Valid values are: STARTING, RUNNING , STOP.

-getLogInfo <connName> [-file <logFile>]

Displays the logging information for a specified connection. If -file is specified, this option writes the logging information to a file specified by logFile.

-getProperty <connName> [-file <propfile>]

Displays the connection properties for a specific connection. If -file is specified, this option writes the connection property information to a file specified by propfile.

-ping <connName> <pingType>

Verifies the connection is configured correctly. Valid values are:

  • ALL

  • IBMMQ

  • TIBCO

  • JMS

  • DATABASE

    REPLICATION

  • INBOUND

  • OUTBOUND

The default value is ALL.