Export (0) Print
Expand All

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 section 2.2.6.


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:

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  

  1. NP_INFO, TCP_INFO, VIA_INFO, RPC_INFO, SPX_INFO, ADSP_INFO, and BV_INFO<1> can be listed in any order, and each token that is listed MUST NOT be listed more than one time. 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.

  3. The size of the SQL Server Resolution Protocol response MUST be no greater than 1,024 bytes per instance.

 
Show:
© 2015 Microsoft