2.2.5 SVR_RESP
The server responds to all client requests with an SVR_RESP. There is a slight variation in the message format for a response to a CLNT_UCAST_DAC (section 2.2.4) request, as described in the next section.
|
0 |
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
1 0 |
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
2 0 |
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
3 0 |
1 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
SVR_RESP |
RESP_SIZE |
RESP_DATA (variable) |
|||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
-
SVR_RESP (1 byte): A single byte whose value MUST be 0x05.
-
RESP_SIZE (2 bytes): This unsigned integer specifies the length, in bytes, of subsequent response data RESP_DATA.
-
RESP_DATA (variable): A variable-length MBCS string that does not need to be byte-aligned. The maximum size of RESP_DATA MUST be 1,024 bytes if the server is responding to a CLNT_UCAST_INST (section 2.2.3) request. If the server is responding to a CLNT_BCAST_EX (section 2.2.1) or a CLNT_UCAST_EX (section 2.2.2) request, the maximum size of RESP_DATA MUST be 65,535 bytes.
Note
-
The content of the RESP_DATA string corresponds to the type of request received. For example, a CLNT_UCAST_EX request is answered with a CLNT_UCAST_EX response string. The formal syntax of the message is provided in Augmented Backus-Naur Form (ABNF), as specified in [RFC4234].
-
All responses to client requests contain information about one or more of the following transports:
-
Named Pipes in message mode [PIPE]. See [MSDN-NamedPipes] for additional information related to Microsoft-specific implementations.
-
A reliable transport over the Virtual Interface Architecture (VIA) interface [VIA2002].
RESP_DATA = CLNT_BCAST_EX_RESPONSE / CLNT_UCAST_EX_RESPONSE / CLNT_UCAST_INST_RESPONSE CLNT_BCAST_EX_RESPONSE = CLNT_UCAST_EX_RESPONSE CLNT_UCAST_EX_RESPONSE = *[CLNT_UCAST_INST_RESPONSE] CLNT_UCAST_INST_RESPONSE = "ServerName" SEMICOLON SERVERNAME SEMICOLON "InstanceName" SEMICOLON INSTANCENAME SEMICOLON "IsClustered" SEMICOLON YES_OR_NO SEMICOLON "Version" SEMICOLON VERSION_STRING [NP_INFO] [TCP_INFO] [VIA_INFO] [RPC_INFO] [SPX_INFO] [ADSP_INFO] [BV_INFO] SEMICOLON SEMICOLON ; see Note 1
|
Name |
Value |
|
SEMICOLON |
SEMICOLON = ";" |
|
SERVERNAME |
The name of the server. The SERVERNAME MUST be no greater than 255 bytes. |
|
INSTANCENAME |
A text string that represents the name of the server instance being described. The INSTANCENAME MUST be no greater than 255 bytes but SHOULD be no greater than 16 MBCS characters. |
|
YES_OR_NO |
YES_OR_NO= "Yes" / "No" |
|
VERSION_STRING |
A text string that conveys the version of the server instance. The VERSION_STRING MUST be no greater than 16 bytes. VERSION_STRING MUST NOT be empty and MUST appear as follows: VERSION_STRING=1*[0-9"."] |
|
NP_INFO |
NP_INFO=SEMICOLON "np" SEMICOLON NP_PARAMETERS |
|
NP_PARAMETERS |
NP_PARAMETERS=PIPENAME |
|
PIPENAME |
A text string that represents the pipe name [PIPE]. |
|
TCP_INFO |
TCP_INFO=SEMICOLON "tcp" SEMICOLON TCP_PARAMETERS |
|
TCP_PARAMETERS |
TCP_PARAMETERS = TCP_PORT |
|
TCP_PORT |
A text string that represents the decimal value of the TCP port that is used to connect to the requested server instance. TCP_PORT SHOULD be a valid TCP port as specified in [RFC793]; see Note 2. |
|
VIA_INFO |
VIA_INFO=SEMICOLON "via" SEMICOLON VIA_PARAMETERS; see Note 3. |
|
VIA_PARAMETERS |
VIA_PARAMETERS=NETBIOS VIALISTENINFO |
|
VIALISTENINFO |
VIALISTENINFO =1*["," VIANIC ":" VIAPORT]. |
|
VIANIC |
A text string that represents the VIA network interface card (NIC) identifier. VIANIC SHOULD be a valid VIA Adapter NIC number [VIA2002]. |
|
VIAPORT |
A text string that represents the decimal value of the VIA NIC's port. VIAPORT SHOULD be a valid VIA Adapter port number [VIA2002]. |
|
NETBIOS |
A text string that MUST be no greater than 15 bytes and that represents the NetBIOS name of a machine where the server resides. |
|
RPC_INFO |
SEMICOLON "rpc" SEMICOLON RPC_PARAMETERS |
|
RPC_PARAMETERS |
RPC_PARAMETERS=COMPUTERNAME |
|
COMPUTERNAME |
The name of the computer to connect to. SHOULD be no more than 127 MBCS characters. |
|
SPX_INFO |
SPX_INFO=SEMICOLON "spx" SEMICOLON SPX_PARAMETERS |
|
SPX_PARAMETERS |
SPX_PARAMETERS=SERVICENAME |
|
SERVICENAME |
The SPX service name of the server. MUST NOT be greater than 1,024 bytes and SHOULD be no more than 127 MBCS characters. |
|
ADSP_INFO |
ADSP_INFO=SEMICOLON "adsp" SEMICOLON ADSP_PARAMETERS |
|
ADSP_PARAMETERS |
ADSP_PARAMETERS=ADSPOBJECTNAME |
|
ADSPOBJECTNAME |
The AppleTalk service object name. SHOULD be no more than 127 MBCS characters. |
|
BV_INFO |
BV_INFO=SEMICOLON "bv" SEMICOLON ITEMNAME SEMICOLON GROUPNAME SEMICOLON BV_PARAMETERS |
|
BV_PARAMETERS |
BV_PARAMETERS=ITEMNAME SEMICOLON GROUPNAME SEMICOLON ORGNAME |
|
ITEMNAME |
The Banyan VINES item name. SHOULD be no more than 127 MBCS characters. |
|
GROUPNAME |
The Banyan VINES group name. SHOULD be no more than 127 MBCS characters. |
|
ORGNAME |
The Banyan VINES organization name. SHOULD be no more than 127 MBCS characters. |
Note
-
NP_INFO, TCP_INFO, VIA_INFO, RPC_INFO, SPX_INFO, ADSP_INFO, and BV_INFO may be listed in any order and MUST be listed no more than once; multiple protocols can be sent in the response. The TCP_PORT in TCP_INFO MUST be in the range defined by [RFC793].<2>
-
VIA_INFO SHOULD cumulatively be no greater than 128 bytes.
-
The size of the SQL Server Resolution Protocol response MUST be no greater than 1,024 bytes per instance.
