ami_SessionCreate()

Function

Declaration

ami_Error ami_SessionCreate(
   ami_Session *    inpAmiSession, 
   ami_TraceCode    inTraceLevel, 
   const char *     inpRvService, 
   const char *     inpRvNetwork, 
   const char *     inpRvDaemon,
   unsigned int     inRvTransport,
   unsigned int     inRvQueue, 
   const char *     inpName,
   const char *     inpDisplayName,
   const char *     inpHelp,
   ami_TraceHandler inTraceHandler,
   const void *     inpUserData ); 

Purpose

Creates a new AMI session. Each session represents a single TIBCO Hawk microagent.

Parameters

 

Parameter

Description

inpAmiSession

Target for returned session handle.

inTraceLevel

AMI trace levels for this AMI session. See ami_TraceCode for trace level descriptions.

inpRvService

TIBCO Rendezvous service parameter.

inpRvNetwork

TIBCO Rendezvous network parameter.

inpRvDaemon

TIBCO Rendezvous daemon parameter.

inRvTransport

TIBCO Rendezvous transport for AMI session.

inRvQueue

TIBCO Rendezvous queue for AMI session.

inpName

Unique name string for microagent.

inpDisplayName

User-friendly name string for microagent.

inpHelp

User-friendly microagent description.

inTraceHandler

AMI session trace callback function.

inpUserData

AMI session user data.

 

Note 

If the transport being used is tibrv , you need to perform the following steps:

Explicitly call tibrv_open() method before providing a user queue (rv_queue).
Explicitly call tibrv_close() method before application exit.

Refer to TIBCO Rendezvous® documentation for more information.