TRANSFER_MS_DATA

The TRANSFER_MS_DATA verb builds an SNA request unit containing Network Management Vector Transport (NMVT) data. The verb can send the NMVT data to NetView for centralized problem diagnosis and resolution. The data is logged in the local audit file.

The following structure describes the verb control block used by the TRANSFER_MS_DATA verb.

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;
};
 

Members

opcode

Supplied parameter. The verb identifying the operation code, sv_transfer_ms_data.

data_type

Supplied parameter. Specifies the type of data provided by this verb:

• Use SV_NMVT to generate an NMVT (including the NS header, the major network management vector, and subvectors).
• Use SV_ALERT_SUBVECTORS to generate an RU containing data for an alert in the appropriate format, without the NS header or major NMVT vector.
• Use SV_PDSTATS_SUBVECTORS to generate an RU containing data for problem determination statistics in the appropriate format, without the NS header or major NMVT vector.
• Use SV_USER_DEFINED to generate user-defined data; this data is recorded in the error log but cannot be sent on the systems services control point-physical unit (SSCP-PU) session on the connection configured for diagnostics.

reserv2

A reserved field.

primary_rc

Returned parameter. Specifies the primary return code set by APPC at the completion of the verb. The valid return codes vary depending on the APPC verb issued. See Return Codes for valid error codes for this verb.

secondary_rc

Returned parameter. Specifies the secondary return code set by APPC at the completion of the verb. The valid return codes vary depending on the APPC verb issued. See Return Codes for valid error codes for this verb.

options

Supplied parameter. Specifies the desired options by turning individual bits on or off. (Bits 1, 2, and 3 are ignored if data_type is set to SV_USER_DEFINED.) See the Remarks section.

origntr_id

Supplied parameter. Specifies the name of the component issuing TRANSFER_MS_DATA. This parameter is optional. Set it to 0x00 if you want the system to ignore it.

dlen

Supplied parameter. Specifies the length of data to be supplied to this verb. The total length of the data (user-supplied data and any added headers or subvectors) must fit into one RU. The maximum RU length is 512 bytes.

dptr

Supplied parameter. Specifies the address of the data to be sent.

Return Codes

sv_ok

Primary return code; the verb executed successfully.

sv_parameter_check

Primary return code; the verb did not execute because of a parameter error.

sv_data_exceeds_ru_size

Secondary return code; the data to be sent was too long. The length of the user-supplied data plus headers and added subvectors must fit in a single RU that is not more than 512 bytes long.

sv_invalid_data_segment

Secondary return code; the buffer pointed to by dptr was not a readable segment or extended beyond the segment boundary.

sv_invalid_data_type

Secondary return code; the data_type parameter contained an invalid value.

sv_state_check

Primary return code; the verb did not execute because it was issued in an invalid state.

sv_sscp_pu_session_not_active

Secondary return code; the NMVT was not sent; either the SSCP-PU session was not active, the node configured to receive diagnostic information was not active, or no network management connection was configured.

sv_comm_subsystem_not_loaded

Primary return code; a required component could not be loaded or terminated while processing the verb. Thus, communication could not take place. Contact the system administrator for corrective action.

sv_invalid_verb

Primary return code; the opcode parameter did not match the operation code of any verb. No verb executed.

sv_invalid_verb_segment

Primary return code; the VCB extended beyond the end of the data segment.

sv_unexpected_dos_error

Primary return code; one of the following conditions occurred:

• The Microsoft® Windows NT®, Microsoft® Windows® 95, Windows version 3.x, Microsoft® MS-DOS®, or OS/2 system encountered an error while processing the verb. The operating system return code was returned through the secondary return code. If the problem persists, contact the system administrator for corrective action.
• A CSV was issued from a message loop that was invoked by another application issuing a Windows SendMessage function call, rather than the more common Windows PostMessage function call. Verb processing cannot take place.
• A CSV was issued when SendMessage invoked your application. You can determine whether your application has been invoked with SendMessage by using the InSendMessage Windows API function call.

sv_cancelled

Primary return code; this code is returned for an asynchronous verb when it has been shut down by a WinCSVCleanup call.

sv_server_resource_not_found

Primary return code; no communication server was found that could provide the requested function.

sv_server_resource_lost

Primary return code; the communications server that was providing the function was lost due to a connection failure.

sv_server_comm_failure

Secondary return code; the connection to the server was lost due to physical path problems; for example, the server may have been powered off.

sv_thread_blocking

Primary return code; this verb exceeds the maximum number of simultaneous synchronous verbs allowed.

Remarks

To specify options, turn bits on or off as follows: