2.2.5 SVR_RESP

  • Article

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 [MSDN-NP].

    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.