configure

Interface Information

>This API belongs to SentinelLmAdmin.dll.

>The corresponding library is License Manager administration library.

static void configure(LmAdminAttribute attribute)
throws LmAdminException, UnsupportedEncodingException

Description

Use this API to configure the LmAdminAPI library. The supported library configurations include:

>Enabling trace writer file for troubleshooting.

>The API must be called before creating the first admin context because the library configuration becomes effective at the time of first admin context creation. The library configuration cannot be modified later.

Syntax

Argument
attribute [In]

Attributes

#	Attribute for...	Key and Description
1	Trace Level	>Attribute Key - SNTL_ATTR_LMADMINCONFIG_TRACE_LEVEL >This attribute is used for setting the trace level required by the admin trace writer file. >The allowed values are: •SNTL_ATTR_LMADMINCONFIG_TRACE_ERROR - Traces the errors encountered at run time. •SNTL_ATTR_LMADMINCONFIG_TRACE_FUNCTION - Traces the admin API functions along with errors encountered at run time. This option also includes the errors encountered at run time (SNTL_ATTR_LMADMINCONFIG_TRACE_ERROR).
2	Trace Writer File name	>Attribute Key - SNTL_ATTR_LMADMINCONFIG_TRACE_WRITER_FILE >This attribute is used for setting the admin trace writer file name. >The Sentinel RMS library writes traces to this file based on the specified admin trace level. >To use the admin trace writer file, set the admin trace level attribute (mandatory). NOTE   Tracing will not for be enabled for API calls placed before admin context creation (for example, sntl_lmadmin_attr_new and sntl_lmadmin_attr_set).

Exception Handling

If unsuccessful, throws LmAdminException or UnsupportedEncodingException.