Copyright © Cloud Software Group, Inc. All Rights Reserved

ami_AddProperty()

Function

Declaration

ami_Error ami_AddProperty(

const char * inpName,

void * inpValue,

ami_Property ** inpProperties );

Purpose

Creates a linked list defined as ami_Property and adds transport properties to it. The ami_AddProperty() API allocates memory and creates a linked list for every parameter added.

Create property list using the ami_AddProperty() API and pass it to ami_SessionCreateUsingProperties() API.

Parameters

 

Parameter	Description
inpName	Name of the parameter.
inpValue	Value of the parameter.
ami_Property	Reference to the property.

The following table provides the supported property names and their default values:

 

Property Name	Mandatory	Default	Description
hawk_domain	No	Default	The hawk domain.
hawk_transport	No	tibas	Choice of transport. The available options are: • tibas • tibrv

Table 8 Properties List for hawk_transport = tibas

 

Property Name	Mandatory	Default	Description
agent_name	No	<hostname>	Used to detect if an agent has joined and needs to match one specified in hawkagent.cfg file.
as_listen_url	No	<host>:50000	TIBCO ActiveSpaces listen parameter.
as_discover_url	No	tibpgm://(default provided by AS)	TIBCO ActiveSpaces discover parameter.
as_invocation_timeout	No	30000	All internal synchronous communications will use this default timeout in milliseconds.
as_receive_buffer_size	No	1000	Internal memory size allocation in bytes.
as_virtual_node_count	No	100	Internal parameter for even distribution of data in seeders.
as_worker_thread_count	No	32	Number of threads used by TIBCO ActiveSpaces API.
agent_domain	No	none	Unique identification of HMA with given agent.
agent_session_id	No	<hawk_domain>_<agent_name>_<agent_domain>_0	Unique session id per microagent session. This is useful when a single process creates multiple ami sessions. The integer number at the end starts from 0 and keeps increasing for multiple ami sessions.

Table 9 Properties List for hawk_transport = tibrv

 

Property Name	Mandatory	Default	Description
rv_service	No	7474	TIBCO Rendezvous service property.
rv_network	No	;	TIBCO Rendezvous network property.
rv_daemon	No	tcp:7474	TIBCO Rendezvous daemon property.
rv_queue	No	Internal-queue	TIBCO Rendezvous queue for AMI session.
rv_transport	No	Internal-rv-transports	TIBCO Rendezvous transport for AMI session.

 

Copyright © Cloud Software Group, Inc. All Rights Reserved