Properties of a communication service

The following table contains all the properties of an communication Communication Service.

The meanings and values permitted for the various properties can be found in the Management Console online help system under Managing BeanConnect proxy components - Managing communication services - Communication services, table columns and communication service instance, properties.

Keyword (key) in MC-CLI 1	Field name in the GUI 1	Funct. 1	Property value 1
admin-port	MC-CmdHandler Listener Port	cm / g/ ma)	(String numeric)
admin-pw	MC-CmdHandler User Password	cm / m a)	(String)
admin-state	Administrable	g	BcDef.ACTION_RESULT_ADMINISTRABLE or BcDef.ACTION_RESULT_NOT_ADMINISTRABLE2
cp name	Control Point Name	cm / g / mc)	(String)
cp network	Control Point Network	cm / g / mc)	(String)
desc	Description	g / mc)	(String)
host	Host	cm / g / ma)e)	(String)
idblk	IDBLK	cd / g / mc)	(String)
idnum	IDNUM	cd / g / mc)	(String)
install-path	Installation Path	cm / g / m	(String)
install-path-gw	Installation Path(Lu62Gateway)	c / g / mf)	(String)
log.audit-log	Audit Logging / Verbose Audits	cd / g / m b)	BcDef.LOGGING_MODE_xxx with xxx = ON/OFF/VERBOSE2
log.except-log	Activate Exception Logging	cd / g / mb)	BcDef.LOGGING_MODE_xxx with xxx = ON/OFF2
log.line-trac	Activate Line Tracing	cd / g / mb)	BcDef.LOGGING_MODE_xxx with xxx = ON/OFF2
log.verbose-err	Verbose Errors	cd / g / mb)	BcDef.LOGGING_MODE_xxx with xxx = ON/OFF2
mac-addr	MAC Address	cd / g / mc)d)	(String)
name	Name	g	(String)
op system	Operating System	gc)	(String)
proxies	Proxies	gg)	(String)
type	Type	g	(String)

¹ For the meanings of the columns and abbreviations, see Properties
² The possible values of xxx can be found in the JavaDoc (Java class BcDef) in the JavaDoc subdirectory of the Management Console installation directory

Notes on the indices a) to g) in the tables:

a)	If one of the properties host, admin-port or admin-pw is specified during a create or modify operation, the associated MC CmdHandler is searched for or created internally and is assigned to the communication service. The MC CmdHandler must be available as otherwise the call is rejected. In the case of a local host, it is not necessary to specify admin-port and admin-pw.
b)	The properties with the prefix log. can only be read and modified in the case of communication services on Linux or SNAP-IX on Solaris. Since the platform is not known at the time of generation, the default values are set when the object is generated.
c)	If the MC-CmdHandler is not available, the value BcDef.VALUE_UNKNOWN (="<.>") is output for these properties in getProperties().
d)	The property mac-addr is only required if you are using at least one EIS partner of the DLC type LAN. If it is not specified then the default value (empty string) is used.
e)	The property host can only be changed if the host is the same. (i.e. modifiable but will generally be rejected).
f)	The property install-path-gw should be specified when creating a communication service because some of the properties of the communication service are stored under this path. If it is not specified then an already configured Lu62 Gateway is searched for on the host on which the communication service is located. If no gateway is found, the call is rejected with BcParameterException. If the property install-path-gw is not specified when an object is read then it may not be possible to read the properties of the communication service.
g)	The proxies (with name and object) can also be read using the function getProxies(). In this case, the names are sent as a comma-separated string.  Note: If the proxy names contain commas then it is possible that the returned information may be ambiguous.