External Automatic Entry (HUB) Related Commands

The following administration commands relate to the control of external Automatic Entries between applications.

The security level on all :HUB commands is Controller.

Name	Function
:HUB	Display HUB statistics
:HUB+	Start HUB, and set Auto HUB initiate attribute
:HUB-	Stop HUB, and reset Auto HUB initiate attribute

Note: These commands are not applicable in Builder.

:HUB

Displays an analysis and statistics of HUB activities, including:

If HUB is currently running or not.
Number of requests to/from HUB since initiation.
Number of completed to/from requests since initiation.
If HUB mechanism is currently enabled or not.

The :HUB command has the form:

:HUB

The number of incoming requests to a database do not necessarily balance the number of outgoing requests from that database. For example, an error condition might be counted in one database but not in the other.

:HUB+

Enables HUB mechanism (if not enabled), for all valid protocols, and HUB port files are opened for the application. Enables HUB mechanism, if not already enabled.

The :HUB+ command has the form:

:HUB+

:HUB+ Destination

Enables external Automatic Entries (using HUB) to be sent to the destination application from the current application.

Applies only to HUB communications from the current application to the specified destination application.

The :HUB+ destination command has the form:

:HUB+ destination

Where, destination is a destination key in the form:

database / environment / host

Where:

database is value entered in Glb.Destination.
environment is value entered in Glb.DestEnv.
host is value entered in Glb.DestHost.

(Trailing spaces are suppressed).

Refer to :HUB + system, :HUB +, and :HUB –.

:HUB-

Disables HUB mechanism, for all valid protocols, and HUB port files are closed. No further HUB transactions are allowed until you enter a :HUB+ command for this application.

After disabling the HUB mechanism, any HUB transactions involving your application set the built-in attributes Glb.Status (to NODB) and Glb.HubStatus (to HUB.DISABLED).

The :HUB– command has the form:

:HUB-

:HUB- System

Locally disables a destination system, clears existing locally queued external Automatic Entries, and stops any new external Automatic Entries being sent to the destination system from the current application. All new external Automatic Entries receives a Glb.Status value of NODB, and a Glb.HubStatus value of USER.DISABLED.

This does not affect the current system receiving and responding to external Automatic Entries from the specified application.

Existing external Automatic Entries queued for the specified destination system is cleared and receives a Glb.Status value of BLOCK and a Glb.HubStatus value of USER.DISABLED.

Applies only to HUB communications from the current application to the specified destination application.

The :HUB– Administration command has the form:

:HUB - system

Where, system is a destination key in the form:

database / environment / host

Where:

database is value entered in Glb.Destination.
environment is value entered in Glb.DestEnv.
host is value entered in Glb.DestHost.

(Trailing spaces are suppressed).

Refer to :HUB + system, :HUB +, and :HUB -.

:HUB D

Displays:

Count of external Automatic Entry requests (received from other applications) that have been replied to. Shown for each listed application.
Count of external Automatic Entry requests sent from this application, for each listed application.
Status of each listed application, DISABLED or spaces.

List is displayed in alphabetical order, from start point value.

Statistics might be initialized by :HUB I, and are not retained when the application closes down.

The :HUB D command has the form:

:HUB D [start]

Where, start is a full or partial key from which to start the requested display. By default, it is beginning.

Refer to :HUB I and :HUB.

Example Output

Destination 		Received 		Sent
DB2//HOSTA 		0 					10
DB3//HOSTB 		0 					15
DB4/E/HOSTC 		3 					5 			DISABLED
DB5//HOSTD 		2 					0
DB9//HOSTE 		3 					0 			DISABLED

:HUB I

Initializes (clears) statistics displayed by :HUB and :HUB D commands. Following entry of :HUB I, only the identity and status of communicating systems is retained.

The :HUB I command has the form:

:HUB I

Refer to :HUB and :HUB D.

:HUB Q

Displays the following information for all queued external Automatic Entries sent from the current system, and awaiting responses:

Length of time queued (in seconds, to one decimal place). Requests are displayed in descending order of time queued.
Initiator, subsystem or Report name, and mix number.
Commitment protocol used; Y for Two Phase Commit, a space for Immediate Commit.
Destination key (system), in the format:
```
database/environment/host
```
Where:
- database is the value entered in Glb.Destination
- environment is the value entered in Glb.DestEnv
- host is the value entered in Glb.DestHost

A maximum of 20 queued requests are shown:

The :HUB Q command has the form:

:HUB Q

Refer to :HUB+ system, and :HUB- system.

Example Output

Time (secs) 		Initiator 		Mix 		2pc 		Destination
5.3 					SUBSYSTEM3 		5764 					DB3//HOSTA
3.0 					SUBSYSTEM2 		6320 		Y 			DB3//HOSTA
2.0 					TESTREPR10 		1356 					DB1//HOSTB
2.9 					SUBSYSTEM10 	6331 		Y 			DB5/E/HOSTF
5.5 					TESTREP20 		2445 					TESTHUB//HOSTD