System Web Services

Overview

Universal Controller supports the following RESTful-based web services for system operations, which are listed alphabetically on this page

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

Retrieve System Details


Description

URI

http://host_name/uc/resources/status

HTTP Method

GET

Description

Retrieves Universal Controller system status/information.

Example URI

http://localhost:8080/uc/resources/status

Authentication

HTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See Retrieve System Details: Example Response, below.

Retrieve System Details: Example Response

XML Response

JSON Response

 XML Response
<status>
	<build>build.190</build>
	<buildDate>08-31-2020_1026</buildDate>
	<databaseConnections>Server (0/5) Client (0/5) Reserved (0/2)</databaseConnections>
	<databaseName>qa_con_mysql</databaseName>
	<databaseType>MySQL</databaseType>
	<databaseURL>jdbc:mysql://qa-db007.stone.branch/</databaseURL>
	<license>>[Distributed Agents: 3/3] [z/OS Agents: 2/2] [Expiry Date: 2020-12-14 [Days: 45]] [UPPS: true] [USAP: true] [Customer: Pre 6.9 License Migrated.]</license>
	<licenseExpired>false</licenseExpired>
	<memoryFree>806.90 MB (79.19%)</memoryFree>
	<memoryMaximum>1019.00 MB</memoryMaximum>
	<memoryUsed>212.10 MB (20.81%)</memoryUsed>
	<nodeId>qa-con-mysql.stone.branch:8080-qa_con_mysql</nodeId>
	<nodeMode>Active</nodeMode>
	<nodeTime>2020-11-08 14:09:54 -0400 (America/New_York)</nodeTime>
	<nodeUptime>7 Days 19 Hours 57 Minutes 41 Seconds</nodeUptime>
	<release>6.9.0.0<release>
</status>
 JSON Response
{
  "build": "build.190",
  "buildDate": "08-31-2020_1026",
  "databaseConnections": "Server (0/5) Client (0/5) Reserved (0/2)",
  "databaseName": "qa_con_mysql",
  "databaseType": "MySQL",
  "databaseURL": "jdbc:mysql://qa-db007.stone.branch/",
  "license": ">[Distributed Agents: 3/3] [z/OS Agents: 2/2] [Expiry Date: 2020-05-14 [Days: 45]] [UPPS: true] [USAP: true] [Customer: Pre 6.9 License Migrated.]",
  "licenseExpired": false,
  "memoryFree": "806.90 MB (79.19%)",
  "memoryMaximum": "1019.00 MB",
  "memoryUsed": "212.10 MB (20.81%)",
  "nodeId": "qa-con-mysql.stone.branch:8080-qa_con_mysql",
  "nodeMode": "Active",
  "nodeTime": "2020-11-08 14:09:54 -0400 (America/New_York)",
  "nodeUptime": "7 Days 19 Hours 57 Minutes 41 Seconds",
  "release": "6.9.0.0"
}

Retrieve System Details Properties

The System Details properties match the fields on the System Details widget which displays, by default, on the Universal Controller Home dashboard.
 

Property

UI Field Name

Description

build

Build

Build number for this version of the Controller.

buildDate

Build Date

Date when this build was created.

databaseConnections

Database Connections

Information on the database connections required for Universal Controller to execute an SQL task or a Stored Procedure Task.

databaseName

Database Name

Name of the database used by this Controller.

databaseType

DatabaseType

Type of database used by this Controller.

databaseURL

Database URL

URL of the database used by this Controller.

license

License

License information for the Universal Controller:

  • Distributed Agents
  • z/OS Agents
  • Expiry Date
  • Tasks
  • Monthly Executions
  • Cluster Nodes
  • UPPS
  • USAP
  • Customer
  • Environment

licenseExpired

n/a

Indication (true or false) that your Universal Controller license has expired.

memoryFree

Memory Free

Amount of memory available for use by this Controller.

memoryMaximum

Memory Maximum

Maximum amount of memory for this Controller.

memoryUsed

Memory Used

Amount of memory currently being used by this Controller.

nodeId

Node Id

URL of the Controller.

nodeMode

Node Mode

Current mode of the Controller.
 
Valid values:

  • Active
  • Passive
  • Offline

nodeTime

Node Time

Time of day on the Controller when the details were retrieved.

nodeUptime

Node Uptime

Amount of time the Controller has been running.

release

Release

Release level of the Controller.