Re: [drinks] SOAP document - Gen-ART comment regarding minorVer..

"Bhatia, Vikas" <vbhatia@tnsi.com> Fri, 05 June 2015 00:27 UTC

Return-Path: <vbhatia@tnsi.com>
X-Original-To: drinks@ietfa.amsl.com
Delivered-To: drinks@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8A0471ACDC6 for <drinks@ietfa.amsl.com>; Thu, 4 Jun 2015 17:27:35 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.212
X-Spam-Level:
X-Spam-Status: No, score=-0.212 tagged_above=-999 required=5 tests=[BAYES_20=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, J_CHICKENPOX_44=0.6, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01] autolearn=ham
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id THhSCO--P5Qq for <drinks@ietfa.amsl.com>; Thu, 4 Jun 2015 17:27:33 -0700 (PDT)
Received: from relayus.tnsi.com (relayus.tnsi.com [208.224.248.44]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 65D6A1ACDC5 for <drinks@ietf.org>; Thu, 4 Jun 2015 17:27:33 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=tnsi.com; i=@tnsi.com; q=dns/txt; s=tnsi; t=1433464053; x=1465000053; h=from:to:subject:date:message-id:references:in-reply-to: content-transfer-encoding:mime-version; bh=SxrkmG6PeQZ/tpUwlI83exjmNrj9BaREMWLlX3v01b8=; b=L+QPWpnr22qaJaz/QeSx9VGiMWHvquTTlW1rkVQVUiabPjU8oYeYTnpY hIQKX1AaFBRXmx+Pi29pZkiPIDX187ajjzja3yiT3KlXscfk0fbLTmd0y G0gsHaNOwUCz0xR07zQscW8jQZwDoTJZJtd9+sbHjNAbtUg6RZ1bHKFFh dOoKL9GYqR3zPC93P+OkWspZwEDyPMnpiU1pCQrCrLb7ANv1gIjs0FAay vmCWxO83ujT/5/pPCfU/3Q5s4BxOAcscnuStI9Wg7vD3S+qJrg67lKhrt 1sFwhJIixRDnRn4KxXjvuF1tVpO1gS2RjktE4aAlbH5jHI/nkeTmS9cbG w==;
Authentication-Results: relayus.tnsi.com; dkim=neutral (message not signed) header.i=none
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A2CsBACx7HBV/xUIEaxRCoNkXgbAKAqFLUoCgXsBAQEBAQGBC4QiAQEBBAEBATc0FwQCAQgNBAQBAR8JBycfCQgBAQQBEgiIKgjbXAEBAQEBBQEBAQEBAQEXBItDhCkLAQEFTQUGhCcFkxqMU4N1gnSPOIEFgxZvAYELOoEBAQEB
X-IPAS-Result: A2CsBACx7HBV/xUIEaxRCoNkXgbAKAqFLUoCgXsBAQEBAQGBC4QiAQEBBAEBATc0FwQCAQgNBAQBAR8JBycfCQgBAQQBEgiIKgjbXAEBAQEBBQEBAQEBAQEXBItDhCkLAQEFTQUGhCcFkxqMU4N1gnSPOIEFgxZvAYELOoEBAQEB
X-IronPort-AV: E=Sophos;i="5.13,555,1427756400"; d="scan'208";a="5094738"
Received: from unknown (HELO asbwcexcmbx01.win2k.corp.tnsi.com) ([172.17.8.21]) by relayus.tnsi.com with ESMTP/TLS/AES256-SHA; 05 Jun 2015 01:27:31 +0100
Received: from asbwcexcmbx01.win2k.corp.tnsi.com (172.17.8.21) by asbwcexcmbx01.win2k.corp.tnsi.com (172.17.8.21) with Microsoft SMTP Server (TLS) id 15.0.1044.25; Fri, 5 Jun 2015 01:27:31 +0100
Received: from asbwcexcmbx01.win2k.corp.tnsi.com ([fe80::f1b8:5d9c:79d4:7f09]) by asbwcexcmbx01.win2k.corp.tnsi.com ([fe80::f1b8:5d9c:79d4:7f09%16]) with mapi id 15.00.1044.021; Fri, 5 Jun 2015 01:27:30 +0100
From: "Bhatia, Vikas" <vbhatia@tnsi.com>
To: Alexander Mayrhofer <alexander.mayrhofer@nic.at>, "drinks@ietf.org" <drinks@ietf.org>
Thread-Topic: [drinks] SOAP document - Gen-ART comment regarding minorVer..
Thread-Index: AdCS9TaLxxvH2qKeS6C5SJLIuf6+7wML6rcw
Date: Fri, 5 Jun 2015 00:27:30 +0000
Message-ID: <1b713e5915d44a05942335b3e5b8128e@asbwcexcmbx01.win2k.corp.tnsi.com>
References: <19F54F2956911544A32543B8A9BDE075467F86BE@NICS-EXCH2.sbg.nic.at>
In-Reply-To: <19F54F2956911544A32543B8A9BDE075467F86BE@NICS-EXCH2.sbg.nic.at>
Accept-Language: en-US, en-GB
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-ms-exchange-transport-fromentityheader: Hosted
x-originating-ip: [172.17.100.104]
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
Archived-At: <http://mailarchive.ietf.org/arch/msg/drinks/s0uYQCanlW1bMATV1QNZI-yfcWY>
Subject: Re: [drinks] SOAP document - Gen-ART comment regarding minorVer..
X-BeenThere: drinks@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: IETF DRINKS WG <drinks.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/drinks>, <mailto:drinks-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/drinks/>
List-Post: <mailto:drinks@ietf.org>
List-Help: <mailto:drinks-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/drinks>, <mailto:drinks-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 05 Jun 2015 00:27:35 -0000

Hi Alex,

As far as I recall, framework document only specifies the data type "MinorVerType" - and defers to the implementation Protocol (SPP over SOAP being one) for using the this type in minor versions.

The following definition in section 7.2.9.1 of the latest SPP protocol over SOAP  document seems closer to accuracy:

   o  minorVer: Zero or one minor version identifier, indicating the
      minor version of the SPP Protocol over SOAP API that the client is
      attempting to use.  This is used in conjunction with the major
      version identifier in the XML namespace to identify the version of
      SPP Protocol over SOAP that the client is using.  If the element
      is not present, the server assumes that the client is using the
      latest minor version of SPP Protocol over SOAP supported by the
      SPPF server for the given major version.  The versions of SPP
      Protocol over SOAP supported by a given SPPF server can be
      retrieved by the client using this same spppServerStatusRequest
      without passing in the minorVer element.

I like the idea of moving the definition to a common place, the last sentence above "The versions of ..." would probably need to be reworded a little I guess.

Thanks,
Vikas

-----Original Message-----
From: drinks [mailto:drinks-bounces@ietf.org] On Behalf Of Alexander Mayrhofer
Sent: Wednesday, May 20, 2015 8:05 AM
To: drinks@ietf.org
Subject: [drinks] SOAP document - Gen-ART comment regarding minorVer..

Hello,

Roni Even performed the Gen-ART review of draft-ietf-drinks-spp-protocol-over-soap (see https://www.ietf.org/mail-archive/web/ietf/current/msg91403.html).

Specifically, he asked about the definition of the minorVer element:

"There are two schemas used, the sppf:base and sppf:soap each have a version number. When talking about supported version and about response codes on supported version, is it referring to the base or soap version? There is some text in the minorVer section but it is not clear enough."

Our definition in the document is:

             minorVer: Zero or one minor version identifier, indicating the minor
              version of the SPPF API that the client is attempting to use. This is
              used in conjunction with the major version identifier in
              the XML namespace to identify the version of SPPF that the client
              is using.  If the element is not present, the server assumes that
              the client is using the latest minor version supported by the SPPF
              server for the given major version. The versions supported by a
              given SPPF server can be retrieved by the client using the
              Get Server Details Operation described in <xref target="servermenuopn"/>.

I have to admit, I can't remember what the intention was. Could someone help me creating updated text that fixes Roni's feedback?

Also, the definition is repeated in the text several times. I would move the definition to a dedicated section, and then only refer to that section in the individual objects - I guess that would be fine with the other authors?

Thanks,
Alex

_______________________________________________
drinks mailing list
drinks@ietf.org
https://www.ietf.org/mailman/listinfo/drinks

________________________________

This e-mail message is for the sole use of the intended recipient(s)and may
contain confidential and privileged information of Transaction Network Services.
Any unauthorized review, use, disclosure or distribution is prohibited. If you
are not the intended recipient, please contact the sender by reply e-mail and destroy all copies of the original message.