Maintaining Broker Definitions in UEC Database - zOS and Windows

List All Defined Universal Brokers

The following illustrates the output of a user-friendly format of the Universal Brokers defined in the UEC database.

uecload -port 8778 -userid joe -pwd akkSdiq -list -broker_name "*"

Command Line Options

The command line options used in this example are:

Option

Description

-port

TCP/IP port number of the UEC.

-userid

UEC user ID/account with which Brokers will be modified.

-pwd

Password associated with -userid.

-list

Output the described broker definition in a user-friendly format.

-broker_name

"*" specifies all Universal Brokers.

Export a Specific, Defined Universal Broker

The following illustrates the output of a Universal Broker defined in the UEC database in a format suitable for use within a broker definition file.

uecload -port 8778 -userid joe -pwd akkSdiq -level audit -export -broker_name mybroker1

Command Line Options

The command line options used in this example are:

Option

Description

-port

TCP/IP port number of the UEC.

-userid

UEC user ID/account with which Brokers will be modified.

-pwd

Password associated with -userid.

-level

Level of messages written.

-export

Output the described broker definition in a format to be used by a broker definition file.

-broker_name

Unique name of the defined Universal Broker.

Export Events

The following illustrates the export of an events file into CSV format.

uecload -port 8778 -userid joe -pwd akkSdiq -level audit -export EVENTS -stime "*-5" -etime "*" -format CSV -deffile events.csv

Note

The double quotation marks ( " ) are required only with UNIX.

Command Line Options

The command line options used in this example are:

Option

Description

-port

TCP/IP port number of the UEC.

-userid

UEC user ID/account with which Brokers will be modified.

-pwd

Password associated with -userid.

-level

Level of messages written.

-export

Output the described broker definition in a format to be used by a broker definition file.

-stime

Start time of exported data.

-etime

End time of exported data.

-format

Format of the output from the -export EVENTS action.

-deffile

File containing multiple broker definitions to be added or deleted in the UEC database.

Delete a Specific, Defined Universal Broker

The following figure illustrates the deletion of a Universal Broker defined in the UEC database. Specifically, Universal Broker mybroker1 is deleted from use of UEC.

uecload -port 8778 -userid joe -pwd akkSdiq -level audit -delete -broker_name mybroker1

Command Line Options

The command line options used in this example are:

Option

Description

-port

TCP/IP port number of the UEC.

-userid

UEC user ID/account with which Brokers will be modified.

-pwd

Password associated with -userid.

-level

Level of messages written.

-delete

Delete Agent definitions from UEC.

-broker_name

Unique name of the defined Universal Broker.

Add Specific, Defined Universal Broker via deffile

The following figure illustrates the addition of a group of Universal Broker definitions specified within a definition file in the UEC database. The name sample_deffile represents the name of the created file.

uecload -port 8778 -userid joe -pwd akkSdiq -level audit -add -deffile sample_deffile

Command Line Options

The command line options used in this example are:

Option

Description

-port

TCP/IP port number of the UEC.

-userid

UEC user ID/account with which Brokers will be modified.

-pwd

Password associated with -userid.

-level

Level of messages written.

-add

Add Agent definitions to UEC.

-deffile

File containing multiple broker definitions to be added or deleted in the UEC database.

Definition File

The following figure is the definition file to be used for this example.

<BROKERDEF>
broker_name mybroker1
broker_host localhost
broker_port 7887
broker_desc "This is a description of broker1."
groups "Group 1, Group 2,Group  3"
<BROKERDEF>
<BROKERDEF>
broker_name mybroker2
broker_host 127.0.0.1
broker_port 7887
broker_desc "This is a description of broker2."
groups "Group 1, Group 2, Group 3"
<BROKERDEF>
<BROKERDEF>
broker_name mybroker3
broker_host 10.20.30.40
broker_port 7887
broker_desc "This is a description of broker3."
groups "Group 1, Group 2, Group 3"
<BROKERDEF>

Add Existing Universal Brokers to a Broker Group

The following illustrates the addition of existing Universal Brokers to a Broker group.

uecload -port 8778 -userid joe -pwd akkSdiq -add -deffile brokers -groups "Test 1, Test 2, Test 3"

Command Line Options

The command line options used in this example are:

Option

Description

-port

TCP/IP port number of the UEC.

-userid

UEC user ID/account with which Brokers will be modified.

-pwd

Password associated with -userid.

-add

Add Agent definitions to specified group(s).

-deffile

File containing multiple broker definitions to be added or deleted in the UEC database.

-groups

Group(s) in which the defined Universal Broker is a member. The Universal Broker will be added to the Group(s).

Delete Existing Universal Brokers from a Broker Group

The following illustrates the deletion of existing Universal Brokers from a Broker group.

uecload -port 8778 -userid joe -pwd akkSdiq -delete -deffile brokers -groups "Test 2, Test 3"

Command Line Options

The command line options used in this example are:

Option

Description

-port

TCP/IP port number of the UEC.

-userid

UEC user ID/account with which Brokers will be modified.

-pwd

Password associated with -userid.

-delete

Delete Agent definitions from specified group(s).

-deffile

File containing multiple broker definitions to be added or deleted in the UEC database.

-groups

Group(s) in which the defined Universal Broker is a member. The Universal Broker will be added to the Group(s).