Previous section.

Systems Management: Software License Use Management (XSLM)
Copyright © 1999 The Open Group

NAME

xslm_adv_log

SYNOPSIS

#include <libxslm.h>

xslm_uint32 xslm_adv_log(
    xslm_handle     session_handle,
    xslm_handle     lic_handle,
    xslm_uint32     * msg_length,
    xslm_string     msg,
    xslm_uint32     * status,
    xslm_uint32     auth_token,
    xslm_bin_string * auth_signature,
    xslm_uuid       * auth_lic_sys_id
);


DESCRIPTION

xslm_adv_log() logs an application-specified text message into the license server's log. Publisher-specific message logging can usually be disabled by an administrator. When application message logging is disabled, XSLM_MASK_APPLIED status value is returned and no message is logged.

A return code of XSLM_OK merely indicates that the message to be logged has been accepted by the license server; it may not have been committed to a physical log file.

INPUT PARAMETERS

session_handle

A reference returned by xslm_adv_begin_session().

lic_handle

A reference returned by xslm_adv_request_license().

msg

Text of the message. This can be of any length; however, a licensing system is not required to accept more than 4,096 bytes.

auth_token

A 32-bit arbitrary value created by the application and used as part of the licensing system authentication process. See Process Description for more information.

INPUT/OUTPUT PARAMETERS

msg_length

Length in bytes of the msg parameter. If specified as 0, or a value higher than the licensing system can handle, this value is updated to indicate the maximum number of bytes that can be accepted (in these cases, no data is written).

OUTPUT PARAMETERS

status

Completion status. Detailed error code directly processable by the caller. This value is set to XSLM_STATUS_OK if no error occurred. For other messages, see ERRORS.

auth_signature

An area large enough to contain a 16-byte digital signature created by the licensing system from the input parameters and auth_token. Used as part of the licensing system authentication process.

auth_lic_sys_id

A unique identifier for the particular type of licensing system handling the current license instance. Used as part of the licensing system authentication process.

RETURN VALUE

XSLM_OK

Message accepted

XSLM_COMM_ERR

Communications problem

XSLM_CERT_ERR

Problem with license and/or certificate

XSLM_RESRC_UNAVL

Local resources unavailable

XSLM_PARM_ERR

Parameter error

ERRORS

The function return value gives an overall indication of the success or failure of the call. In addition, the status parameter will be set to one of the following values, to further help point to the reason for a failed request.
Note:
In the future, additional values may be defined for the status variable. An application must not rely upon these being the only possible values.

Return Value Status Value Explanation
XSLM_OK XSLM_STATUS_OK No errors occurred (including the case when the input length is 0)
  XSLM_MASK_APPLIED Log record not written due to log masking as set by an administrator
XSLM_COMM_ERR XSLM_LIC_SYS_NOT_RESP The licensing system does not respond
XSLM_CERT_ERR XSLM_LOG_ERROR Error accessing log
XSLM_RESRC_UNAVL XSLM_NO_RES Platform dependent
XSLM_PARM_ERR XSLM_BAD_LICENSE_HANDLE The specified license handle is invalid
  XSLM_BAD_PARM One or more parameters were not correct
  XSLM_BAD_SESSION_HANDLE The specified session handle is invalid
  XSLM_INVALID_API_USE Attempt to combine basic and advanced API for same handle
  XSLM_MSG_TOO_LONG The specified message length exceeds the maximum length that the licensing system can handle. No data is written. The maximum length supported is returned in the msg_length parameter.

SEE ALSO

xslm_adv_begin_session(), xslm_adv_request_license().

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index