Broker 10.5 | webMethods Broker Documentation | Administering webMethods Broker | Managing Clients | Viewing Client Configuration Information
Viewing Client Configuration Information
For each client that exists, Broker maintains configuration information specified at the time the client was created and information about current client queue state.
*To view client configuration information
1. In My webMethods: Messaging > Broker Server s > Clients.
2. In the Client List, in the Client ID column, click the name of the client for which you want to view configuration information. If the client does not appear in the list, use the search functionality to locate it.
If you selected a test client, My webMethods displays a Test Client View button in the Client Information tab. Click this button to switch to test client view. For more information about test clients, see Working with Test Clients.
3. On the Client Details page, click the Configuration tab to view configuration information about the client.
The following table describes the contents of the Configuration tab.
Application Name
Name of the application that created the client. The application name can be any string of characters and is specified when the client is created.
Shared Document Order
Specifies whether or not Broker delivers documents to the receiving client program in the same order in which the documents are published.
This property is meaningful for shared-state clients only. If a client does not share state, Broker always delivers documents to the receiving client in the order in which the documents are published.
*Publisher. Broker delivers documents from each publisher to the client programs that share the client state in the same order in which the documents are published. This is the default.
*None. Broker does not enforce the by-publisher order when delivering documents to the client programs that share the client state.
State Sharing
Indicates whether or not state sharing is enabled for this client. In a shared-state configuration, multiple client sessions share a single client queue.
*Enabled. Specifies that state sharing is enabled. Multiple clients, possibly residing on multiple hosts, share the same client state and can process documents in the client queue on a first-come, first-served basis.
*Disabled. Specifies that state sharing for this client is disabled.
Date and time this client was created.
Client Group
Client group to which the client belongs. Click the client group name to view the Client Group Details page for that client group. For more information about client groups, see Managing Client Groups.
The infoset containing the state or configuration information for a client. This is for pre-6.0 Brokers only.
Publish Sequence Number
Specifies the last sequence number for published documents received by this client. A publishing client program assigns sequence numbers to documents to allow Broker to recognize and discard duplicate documents from the same publisher. A sequence number of 0 typically indicates that the publishing client does not use publish sequence numbers.
For more information about sequence numbers, see the relevant programming guide.
Forced Reconnect
Specifies whether a client program can forcibly reconnect to a Broker even if it appears that the client program is already connected to the Broker. In some situations, a Broker might not recognize a lost client connection. For example, if you disconnect the machine on which the client program is running, the Broker may not detect the lost connection for some time and will consider the client program to still be connected.
Forced reconnect is meaningful only for clients that do not share a client state. For shared-state clients, Broker always creates a new client session when processing a connection request.
This applies to Broker versions 6.x and later.
*Yes. Indicates that Broker will accept the reconnection request from a client even if it appears that a connection already exists. If the client is currently connected, Broker disconnects the existing session before establishing a new connection.
*No. Indicates that Broker will reject requests from this client to reconnect if it appears that a connection already exists.
Queue Locked
Indicates whether or not the client queue is locked. For more information about locking client queues, see Locking a Client Queue.
*Yes.Indicates the queue is locked. You must lock a queue before you can edit the contents of the queue. When a queue is locked, new documents can be placed in the queue, but clients cannot retrieve documents from the queue.
*No.Indicates the queue is unlocked.
Lock Held by Client ID
Client ID for the client that locked the queue. If the queue is unlocked, this field is blank. If the queue is locked, click the client ID to view details about the client that holds the lock. For information about unlocking client queues, see Unlocking a Client Queue.
Lock Held by Client Session
Session ID for the session that holds the lock to the client queue. Click the session ID to view session information for the client that is holding the lock. For more information about client sessions, see Managing Sessions.
Lock Held Since
Date and time at which the client was locked.
Access Label
Access label value if one has been assigned to the client. For more information about access labels, see Using Access Labels.
4. Click Close to return to the Clients page.