TRANSFER_MS_DATA

项目
10/14/2023

TRANSFER_MS_DATA谓词生成包含网络管理矢量传输 (NMVT) 数据的 SNA 请求单元。谓词可以将 NMVT 数据发送到 NetView，以便集中诊断和解决问题。数据记录在本地审核文件中。

以下结构描述谓词控制块 (VCB) 由TRANSFER_MS_DATA 谓词使用。

语法

  
struct transfer_ms_data {  
    unsigned short       opcode;  
    unsigned char        data_type;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        options;  
    unsigned char        reserv3;  
    unsigned char        origntr_id[8];  
    unsigned short       dlen;  
    unsigned char FAR *  dptr;  
};

成员

opcode
提供的参数。标识操作代码的谓词，SV_TRANSFER_MS_DATA。

data_type
提供的参数。指定此谓词提供的数据类型：

使用 SV_NMVT 生成 NMVT (包括 NS 标头、主要网络管理向量和子矢量) 。
使用 SV_ALERT_SUBVECTORS 生成包含适当格式的警报数据的 RU，而无需 NS 标头或主 NMVT 矢量。
使用 SV_PDSTATS_SUBVECTORS 生成包含适当格式的问题确定统计信息数据的 RU，而无需 NS 标头或主 NMVT 向量。
使用 SV_USER_DEFINED 生成用户定义的数据;此数据记录在错误日志中，但无法在为诊断配置的连接的系统服务控制点物理单元 (SSCP-PU) 会话上发送。

reserv2
一个保留字段。

primary_rc
返回的参数。指定在谓词完成时由 APPC 设置的主要返回代码。有效的返回代码因发出的 APPC 谓词而异。有关此谓词的有效错误代码，请参阅“返回代码”。

secondary_rc
返回的参数。指定在谓词完成时由 APPC 设置的次要返回代码。有效的返回代码因发出的 APPC 谓词而异。有关此谓词的有效错误代码，请参阅“返回代码”。

options
提供的参数。通过打开或关闭单个位来指定所需的选项。如果data_type设置为 SV_USER_DEFINED，则忽略 ( 位 1、2 和 3。) 请参阅“备注”部分。

reserv3
保留字段。

origntr_id
提供的参数。指定发出 TRANSFER_MS_DATA的组件的名称。此参数是可选的。如果希望系统忽略它，请将其设置为 0x00。

dlen
提供的参数。指定要提供给此谓词的数据的长度。用户提供的数据 (数据的总长度以及) 添加的任何标头或子矢量必须适合一个 RU。最大 RU 长度为 512 字节。

dptr
提供的参数。指定要发送的数据的地址。

返回代码

SV_OK
主要返回代码；谓词已成功执行。

SV_PARAMETER_CHECK
主要返回代码；由于参数错误，谓词未执行。

SV_DATA_EXCEEDS_RU_SIZE

辅助返回代码;要发送的数据太长。用户提供的数据加上标头和添加的子矢量的长度必须适合长度不超过 512 字节的单个 RU。

SV_INVALID_DATA_SEGMENT

辅助返回代码; dptr 指向的缓冲区不是可读段，也不是超出段边界的缓冲区。

SV_INVALID_DATA_TYPE

辅助返回代码; data_type 参数包含无效值。

SV_STATE_CHECK
主要返回代码；谓词未执行，因为它是在无效状态下发出的。

SV_SSCP_PU_SESSION_NOT_ACTIVE

辅助返回代码;未发送 NMVT;SSCP-PU 会话未处于活动状态、配置为接收诊断信息的节点未处于活动状态，或者未配置网络管理连接。

SV_COMM_SUBSYSTEM_NOT_LOADED
主要返回代码；处理谓词时无法加载或终止某个必需的组件。因此无法通信。请联系系统管理员以执行纠正措施。

SV_INVALID_VERB
主要返回代码；opcode 参数与任何谓词的操作代码都不匹配。未执行任何谓词。

SV_INVALID_VERB_SEGMENT
主要返回代码；VCB 超出了数据段的末尾。

SV_UNEXPECTED_DOS_ERROR
主要返回代码；发生了以下状况之一：

Microsoft Windows 操作系统在处理谓词时遇到错误。已通过次要返回代码返回了操作系统返回代码。如果该问题持续出现，请联系系统管理员执行纠正措施。
从另一个应用程序（其中发出的是 Windows SendMessage 函数调用，而不是更常见的 Windows PostMessage 函数调用）调用的消息循环发出了 CSV 。无法处理谓词。
当 SendMessage 调用你的应用程序时发出了 CSV。可以使用 InSendMessage Windows API 函数调用来确定应用程序是否是通过 SendMessage 调用的。

SV_CANCELLED
主返回代码;当异步谓词被 WinCSVCleanup 调用关闭时，将返回此代码。

SV_SERVER_RESOURCE_NOT_FOUND
主返回代码;找不到可以提供所请求函数的通信服务器。

SV_SERVER_RESOURCES_LOST
主返回代码;提供函数的通信服务器由于连接失败而丢失。

SV_SERVER_CONN_FAILURE

辅助返回代码;由于物理路径问题，与服务器的连接丢失;例如，服务器可能已关闭。

SV_THREAD_BLOCKING
主返回代码;此谓词超出了允许的同步同步谓词的最大数目。

注解

若要指定选项，请按如下所示打开或关闭位：

bit	说明
0	TIME_STAMP_SUBVECTOR。向数据添加日期/时间子矢量。允许的值包括SV_ADD和SV_NO_ADD。
1	PRODUCT_SET_ID_SUBVECTOR。向数据添加Product_Set_ID子矢量。这允许网络管理服务识别警报的发送方。允许的值包括SV_ADD和SV_NO_ADD。
2	SSCP_PU_SESSION。如果会话处于活动状态，则发送为诊断配置的连接的 SSCP-PU 会话上的数据。 (无论数据是在会话上发送，还是返回SV_STATE_CHECK或SV_COMM_SUBSYSTEM_NOT_LOADED，都会将数据添加到错误日志。) 允许的值包括SV_SEND和SV_NO_SEND。
3	LOCAL_LOGGING。记录从错误日志中检索并转发到主机的本地警报。仅当指定了选项 SV_SEND data_type SV_NMVT或 data_type SV_ALERT_SUBVECTORS时，此选项才有效。允许的值包括SV_LOG和SV_NO_LOG。
4 到 7	预留

通过

TRANSFER_MS_DATA

语法

成员

返回代码

注解

其他资源