QUSRBRM.CHANGE_ENTERPRISE_HUB Procedure

The QUSRBRM.CHANGE_ENTERPRISE_HUB procedure allows you to make changes to the enterprise hub.

Parameters

QUSRBRM.CHANGE_ENTERPRISE_HUB(HUB_CONTACT=> hub-contact, SEND_ERROR_EMAIL=> send-error-email, SEND_REPORT_EMAIL=> send-report-email, REFRESH_RATE=> refresh-rate)

hub-contact (optional)

Specifies a new contact for the enterprise hub.

Possible values are:

NULL	The optional value has not been specified.
hub-contact	The primary contact name for the enterprise hub. The contact name can be up to 10 characters long and must exist in the Enterprise Contact file.

send-error-email (optional)

Specifies whether an email should be sent to the enterprise hub contact when an error occurs when running a report.

Possible values are:

NULL	The optional value has not been specified.
NO	Indicates that an email should not be sent to the enterprise hub contact when there is an error running a report.
YES	Indicates that an email should be sent to the enterprise hub contact when there is an error running a report.
*REPORTDFN	Indicates that the individual report definitions should decide if an email should be sent to the enterprise hub contact when there is an error running a report.

send-report-email (optional)

Specifies whether to send report output in an email to the enterprise hub contact.

Possible values are:

NULL	The optional value has not been specified.
NO	Indicates that report output should not be emailed to the enterprise hub contact.
YES	Indicates that report output should be emailed to the enterprise hub contact.
*REPORTDFN	Indicates that the individual report definitions should decide if report output should be emailed to the enterprise hub contact.

refresh-rate (optional)

The refresh frequency that enterprise node communication will be verified for the systems defined in the enterprise network.

Possible values are:

NULL	The optional value has not been specified.
refresh-rate	The refresh frequency that enterprise node communication will be verified for the systems defined in the enterprise network. The refresh frequency represent minutes and supports a range of 0 to 16,666 minutes. The value 0 indicates that no refresh action will be performed.

Authorization: The privileges held by the authorization ID of the statement must include the following:

*EXECUTE SQL privilege on this procedure.

The BRMS Network feature is required.

The schema is QUSRBRM.

Examples

To change the contact on the enterprise hub:

call QUSRBRM.CHANGE_ENTERPRISE_HUB( HUB_CONTACT=> 'CHUCK' )

To change the refresh rate on the enterprise hub to 15 minutes:

call QUSRBRM.CHANGE_ENTERPRISE_HUB( REFRESH_RATE=> 15 )

Error Messages

The following SQL States and error messages may be returned by this procedure:

U0001	Unable to retrieve Enterprise Hub.
U0002	Enterprise Hub not found.
U0003	Contact not found.
U0004	Send error email not valid. Must be *REPORTDFN, NO or YES.
U0005	Send report email not valid. Must be *REPORTDFN, NO or YES.
U0006	Refresh rate not valid. Must be 0 or between 15 and 16666.
U0007	Unable to change Enterprise Hub.
U9997	Functional authority to BRMS Enterprise QIBM_Q1A_ENT required.
U9998	BRMS Network and Advanced Functions features required.
U9999	Illegal execution.