Product Documentation

FairCom Replication JSON RPC API

Previous Topic

Next Topic

ctMemphisGetAgents

int ctMemphisGetAgents( pRCESJson request, ppRCESJson result )

Description:

Retrieve all the Agents for a given OpSystem from the Replication Manager Database.

HTTP URL: <baseURL>/ctMemphisGetAgents/

HTTP Verb: POST

Notes:

  • "Status" values can be: "inactive", "active", "stopping", "starting", "deploying", and "paused"
  • "StatusCd" values can be: 0 = "inactive", 1 = "active", 2 = "stopping", 3 = "starting", 4 = "deploying", and 5 = "paused"

Parameters:

  • request [IN] - Get Agents request in JSON format. For example:

{

"id": 0, // optional, if passed, retrieve the Agent by its

identification

"dbEngine": 0, // optional, if passed, retrieve the embedded agent

in the given DBEngine

"opSystem": 0, // optional, if not passed, it will return all the

agents from all the opSystems, otherwise filter

by opSystem

"paging": true, // optional, see Note 1 - Paging Parameters

"limit": 100, // optional, see Note 1 - Paging Parameters

"start": 200 // optional, see Note 1 - Paging Parameters

}

  • result [OUT] - Result in JSON format. For example:

{

"agentList": [

{

"id": 1,

"opSystem": 0,

"workingVolume": 0,

"workingDir": "FairCom",

"dbEngine": 0,

"status": "active", // see "Status" note above

"statusCode": 1, // see "StatusCd" note above

"statusTime": "2015-11-05T10:00:00",

"actionExecs": [

{

"type": "BASIC", // Supported types: BASIC,

FILE_SYSTEM, REPLICATION, REPL_CTREE

"status": "active",

"threadCount": 1,

"statusTime": "2015-11-05T10:00:00"

},

{

"type": "FILE_SYSTEM",

"status": "active",

"threadCount": 4,

"statusTime": "2015-11-05T10:00:00"

},

{

"type": "REPLICATION",

"status": "active",

"threadCount": 4,

"statusTime": "2015-11-05T10:00:00"

}

]

},

{

"id": 2,

"opSystem": 0,

"workingVolume": 0,

"workingDir": "FairCom2",

"dbEngine": 1,

"status": "active", // see "Status" note above

"statusCode": 1, // see "StatusCd" note above

"statusTime": "2015-11-05T10:00:00",

"actionExecs": [

{

"type": "BASIC", // Supported types for now: BASIC,

FILE_SYSTEM, REPLICATION, REPL_CTREE

"status": "active",

"threadCount": 1,

"statusTime": "2015-11-05T10:00:00"

},

{

"type": "FILE_SYSTEM",

"status": "active",

"threadCount": 4,

"statusTime": "2015-11-05T10:00:00"

}

]

}

],

"success": true,

"error":

{

"errorCode": 0,

"message": "Success"

},

"total": 500 // total number of agents for the query -

see Note 1 - Paging Parameters

}

Return:

Error code

TOCIndex