transfer
Interface Information
>This API belongs to SentinelLicensing.jar.
>The corresponding library is Sentinel RMS licensing library.
Description
Use this API for:
>Transferring a license authorization from the License Manager. Use the commute () action tag for transferring a license authorization from the License Manager.
>Generating the acknowledgment string for returning the commuter authorization code. Use returnCommuter ( ) action tag for generating the acknowledgment string.
>Synchronization between the licensed application \ License Manager and SCC. Use the sync () action for enforcing synchronization.
>Canceling an active lease to SCC so that it is available for other end users to use. Use the cancelLease () action.
>Resuming the canceled lease and request SCC for a new lease. Use the resumeLease () action.
>Marking the usage file containing usage data as completed. Use the readyUsageForUpload () action.
See Also: Implementing Cancel Lease, Resume Lease, and Force Sync (C, Java, .NET)
Syntax
String transfer(String action,String scope, Attribute attribute, String recipient)
Parameters
Parameter | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
action [in] |
Type of transfer action as shown here. |
||||||||||||
Commute action
|
|||||||||||||
Return commuter action
|
|||||||||||||
Force synchronization action
|
|||||||||||||
Cancel Lease action
NOTE Standalone persistence must be initialized before performing the cancel and resume lease operations. |
|||||||||||||
Resume Lease action
NOTE Standalone persistence must be initialized before performing the cancel and resume lease operations. |
|||||||||||||
Ready Usage for Upload action
|
|||||||||||||
scope [in] |
Reserved for future use. Use NULL as the value for this argument. |
||||||||||||
|
The attribute object.
The attribute object contains attributes for Commute action type only:
|
||||||||||||
recipient [in] |
Recipient information of the machine for which the commuter authorization is requested. Use the recipientInfo query type of the sntl_licensing_get_info API to retrieve the recipient information of the machine for which commuter authorization is required. If this attribute is not used (or NULL is provided as the value for this parameter), the commuter code will be fetched for the local machine. NOTE This is applicable to the commute action type only. |
Exception Handling
If unsuccessful, throws LicensingException or UnsupportedEncodingException.