dsmLogEventEx

dsmLogEventEx 函数调用将用户消息记录到服务器日志文件和/或本地错误日志中。此调用必须在处于会话中的 InSession 状态时进行。此调用无法在 send、get 或 query 调用中进行。

摘要状态图: 有关会话交互的概述，请参阅以下主题中的摘要状态图:

严重性确定 IBM® Storage Protect 消息号。要查看服务器上记录的消息，请通过管理客户机使用 query actlog 命令。如果应用程序产生大量写入客户端日志的客户端信息，可使用 IBM Storage Protect client 选项 errorlogretention 来修剪客户端错误日志文件、 dsmLogType 或 logLocal 或 logBoth. 有关更多信息，请参阅 IBM Storage Protect 服务器文档。

语法

extern dsInt16_t DSMLINKAGE  dsmLogEventEx(
       dsUint32_t            dsmHandle,
       dsmLogExIn_t          *dsmLogExInP,
       dsmLogExOut_t         *dsmLogExOutP
);

参数

dsUint32_t dsmHandle(I)

将此调用与之前的 dsmInitEx 调用相关联的句柄。

dsmLogExIn_t *dsmLogExInP

此结构包含输入参数。

dsmLogSeverity severity;

此参数位于事件严重性中。可能的值有：

   logSevInfo,       /* information ANE4990 */
   logSevWarning,    /* warning     ANE4991 */
   logSevError,      /* Error       ANE4992 */
   logSevSevere      /* severe      ANE4993 */

char appMsgID[8];

此参数是用于识别特定应用程序消息的字符串。合适的格式为三个字符后跟四个数字，例如：DSM0250。

dsmLogType logType;

此参数指定指向此事件的位置。该参数具有以下可能的值：

logServer
logLocal
logBoth

char *message;

此参数是要记录的事件消息的文本。该文本必须是以 null 结尾的字符串。最大长度为 DSM_MAX_RC_MSG_LENGTH。

限制: 转至服务器的消息必须为英语。非英语消息将无法正确显示。

dsmLogExOut_t *dsmLogExOutP

此结构包含输出参数。当前没有任何输出参数。

返回码

返回码编号用括号 ( ) 括起。

表 1. dsmLogEventEx 的返回码
返回码	说明
`DSM_RC_STRING_TOO_LONG (2120)`	此消息字符串过长。