Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
Table of Contents
maxlevel1

...

Universal Controller supports the following RESTful-based web service for Universal Events.

...

Formatting specifications for the web service, including details about parameter requirements, are provided.

Authorization to publish a Universal Event is assigned by the Universal Event Create permission, or by the ops_admin role.

Note
titleNote

When publishing Universal Events through the Web Service API, take into consideration both Universal Controller server and Database server sizings.

Anchor
Universal Event Publishing
Universal Event Publishing

...

Publish Universal Event

...


Description
URIhttp://host_name/uc/resources/universalevent/publish
DescriptionPublsh a global Universal Event.

HTTP Method

POST

Example URI

http://localhost:8080/uc/resources/audituniversalevent/listpublish
AuthenticationHTTP Basic
Consumes Content-Typeapplication/xml, application/json
Produces Content-Typen/a
Example Responses
  • Status 200

    • Universal Event "{eventname}" published.

  • Status 400

    • Invalid Time To Live. Value must be non-negative or empty.

    • Universal Event attributes unknown for Universal Event Template "{eventname}".

    • Universal Event attribute name required.

    • Universal Event attribute "{attributename}" duplicated.

    • Universal Event attribute "{attributename}" unknown for Universal Event Template "{eventname}".

    • Universal Event attribute value "{attributevalue}" for attribute "{attributename}" is not a valid integer.

    • Universal Event attribute value "{attributevalue}" for attribute "{attributename}" is not a valid float.

  • Status 403

    • Operation prohibited due to security constraints.

  • Status 404

    • Universal Event Template "{eventname}" not found.

    • A universal template with id "{templateid}" does not exist.

  • Status 500

    • Unexpected request failure. See log(s) for more details.


Anchor
Universal Event Publishing Examples
Universal Event Publishing Examples

...

Publish Universal Event

...

: XML and JSON

...

Example Request

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With AnchorauditType - auditauditType - auditauditTypeAudit TypeAudit type to filter the data.

Valid values: One of the following (not case sensitive):

  • As String = Create, As Value = 1
  • As String = Update, As Value = 2
  • As String = Delete, As Value = 3
  • As String = Command, As Value = 4
  • As String = Server Operation, As Value = 5
  • As String = CLI, As Value = 6
  • As String = Restore Version, As Value = 7
  • As String = Delete Version, As Value = 8
  • As String = User Login, As Value = 9
  • As String = z/OS Auto-Restart, As Value = 10
  • As String = Delete Override File, As Value = 11
  • As String = Import, As Value = 12
  • As String = Export, As Value = 13
  • As String = Email, As Value = 14
N Anchorsource - auditsource - auditsourceSourceAudit source type

Valid values: One of the following (not case sensitive):

  • As String = User Interface, As Value = 1
  • As String = Command Line, As Value = 2
  • As String = Web Service, As Value = 3
  • As String = System Operation, As Value = 4
  • As String = Set Variable Action, As Value = 5
  • As String = Task Instance, As Value = 6
  • As String = Agent Message, As Value = 7
  • As String = Scheduled, As Value = 8
  • As String = Stored Procedure, As Value = 9
  • As String = System Processing, As Value = 10
  • As String = Email Notification, As Value = 11
N AnchorupdatedTime - auditupdatedTime - auditupdatedTimen/aIf updatedTimeType = Offset; -offset period.

Valid values:

  • mn (minutes)
  • h (hours)
  • d (days)

Default is d.
 
Examples: -5d (last 5 days), -30mn (last 30 minutes), -6h (last 6 hours), -7 (last 7 days).
 
If updatedTimeType is Since; date/time value (yyyy-MM-dd [HH:mm:ss])
 
If updatedTimeType is Today; updatedTime is ignored.

Y
(if updatedTimeType
is Offset, Since,
or Older Than.)
AnchorupdatedTimeType - auditupdatedTimeType - auditupdatedTimeTypen/aType of updateTime.

Valid values:

  • As String = Today, As Value = 1
  • As String = Offset, As Value = 2
  • As String = Since, As Value = 3
  • As String = Older Than, As Value = 4
N AnchorcreatedBy - auditcreatedBy - auditcreatedBy

Created By

Name of the person created the record.

N Anchorstatus - auditstatus - auditstatusStatus

Status of the record

N AnchortableRecordName - audittableRecordName - audittableRecordNameTable Record Nametable record nameN AnchortableName - audittableName - audittableNameTable Nametable nameN AnchortableKey - audittableKey - audittableKeyTable Keytable keyN AnchorincludeChildAudits - auditincludeChildAudits - auditincludeChildAuditsn/ainclude child audits

boolean property

Valid values: true, false, 1, 0

N

XML Request

JSON Request

Expand
titleXML
<?xml version="1.0" encoding="UTF-8" ?>
<universalEvent>
  <name>ExampleEvent</name>
  <businessServices>
    <businessService>BusinessServiceName1</businessService>
    <businessService>BusinessServiceName2</businessService>
  </businessServices>
  <ttl>60</ttl>
  <attributes>
    <attribute>
      <name>example_attribute1</name>
      <value>Value1</value>
    </attribute>
    <attribute>
      <name>example_attribute2</name>
      <value>Value2</value>
    </attribute>
  </attributes>
</universalEvent>
Expand
titleJSON
{
   	"name": "ExampleEvent",

   "businessServices": [
      "BusinessServiceName1",
      "BusinessServiceName2"
    ],
    	"ttl": 60,
    	"attributes": [
		{
			
       {
          "name": "example_attribute1",
			
          "value": "Value1"
		
       },
		{
			
       {
          "name": "example_attribute2",
			
          "value": "Value2"
		}
	]
}

Universal Event Publishing: Request Properties


       }
    ]
}