[gpfsug-discuss] -Y option for many commands, precious few officially!

Tue Mar 28 18:17:11 BST 2017

For the benefit of those on digest, here's Carl's list again in plain text
(I hope). I have also notified our documentation team that this is of great
interest to clients, so they are aware.

   In the 4.2.3 draft documentation, the -y option information has been
   added to a number of commands:

   -Y option

   Added the -Y option to the following commands:

   mmblock	mmhealth	mmlsfileset	mmlsnodeclass	mmnetverify
   mmcloudgateway	mmkeyserv	mmlsfs	mmlsnsd	mmnfs
   mmdf	mmlscluster	mmlslicense	mmlspolicy	mmrepquota
   mmdiag	mmlsconfig	mmlsmgr	mmlsquota	mmsmb
   mmgetstate	mmlsdisk	mmlsmount	mmlssnapshot	mmuserauth

Alecia A. Ramsay, PMP®
Program Manager, New Technology Introduction
IBM Systems - Storage
aleciarm at us.ibm.com
work: 919-435-6494; mobile: 651-260-4928
http://ibm.biz/NewTechnologyIntroduction

From:	Carl Zetie/Fairfax/IBM at IBMUS
To:	gpfsug-discuss at spectrumscale.org
Date:	03/28/2017 01:03 PM
Subject:	Re: [gpfsug-discuss] -Y option for many commands,	precious
            few officially!
Sent by:	gpfsug-discuss-bounces at spectrumscale.org

I checked the draft documentation for 4.2.3, and here is the list of what
is planned.

As usual -- please remember this is an Intention not a commitment, and
subject to change between now and the release.

regards,
Carl

-Y option
      Added the -Y option to the following commands:

 mmblock        mmhealth    mmlsfileset mmlsnodeclass mmnetverify 

 mmcloudgateway mmkeyserv   mmlsfs      mmlsnsd       mmnfs       

 mmdf           mmlscluster mmlslicense mmlspolicy    mmrepquota  

 mmdiag         mmlsconfig  mmlsmgr     mmlsquota     mmsmb       

 mmgetstate     mmlsdisk    mmlsmount   mmlssnapshot  mmuserauth  

Carl Zetie
Offering Manager for Spectrum Scale, IBM
carlz at us.ibm.com

 ----- Original message -----
 From: gpfsug-discuss-request at spectrumscale.org
 Sent by: gpfsug-discuss-bounces at spectrumscale.org
 To: gpfsug-discuss at spectrumscale.org
 Cc:
 Subject: gpfsug-discuss Digest, Vol 62, Issue 70
 Date: Tue, Mar 28, 2017 12:38 PM

 Send gpfsug-discuss mailing list submissions to
 gpfsug-discuss at spectrumscale.org

 To subscribe or unsubscribe via the World Wide Web, visit
 http://gpfsug.org/mailman/listinfo/gpfsug-discuss
 or, via email, send a message with subject or body 'help' to
 gpfsug-discuss-request at spectrumscale.org

 You can reach the person managing the list at
 gpfsug-discuss-owner at spectrumscale.org

 When replying, please edit your Subject line so it is more specific
 than "Re: Contents of gpfsug-discuss digest..."

 Today's Topics:

    1. Re: -Y option for many commands, precious few officially!
       (Luis Bolinches)
    2. Re: -Y option for many commands, precious few officially!
       (Jonathon A Anderson)
    3. Re: -Y option for many commands, precious few officially!
       (Simon Thompson (Research Computing - IT Services))
    4. Re: -Y option for many commands, precious few officially!
       (Jonathon A Anderson)

 ----------------------------------------------------------------------

 Message: 1
 Date: Tue, 28 Mar 2017 16:22:04 +0000
 From: "Luis Bolinches" <luis.bolinches at fi.ibm.com>
 To: gpfsug-discuss at spectrumscale.org
 Cc: gpfsug-discuss at spectrumscale.org
 Subject: Re: [gpfsug-discuss] -Y option for many commands, precious
 few officially!
 Message-ID:
 <OF1049606E.44BBC8FA-ON002580F1.0059D11B-002580F1.0059E971 at notes.na.collabserv.com>

 Content-Type: text/plain; charset="us-ascii"

 An HTML attachment was scrubbed...
 URL: <
 http://gpfsug.org/pipermail/gpfsug-discuss/attachments/20170328/694119bd/attachment-0001.html
 >

 ------------------------------

 Message: 2
 Date: Tue, 28 Mar 2017 16:24:19 +0000
 From: Jonathon A Anderson <jonathon.anderson at colorado.edu>
 To: gpfsug main discussion list <gpfsug-discuss at spectrumscale.org>
 Subject: Re: [gpfsug-discuss] -Y option for many commands, precious
 few officially!
 Message-ID: <99B1AC2E-91B4-4A7F-B270-8FDDC49918EA at colorado.edu>
 Content-Type: text/plain; charset="utf-8"

 Looks great. I look forward to its maturity.

 ~jonathon

 On 3/28/17, 10:22 AM, "gpfsug-discuss-bounces at spectrumscale.org on behalf
 of Luis Bolinches" <gpfsug-discuss-bounces at spectrumscale.org on behalf of
 luis.bolinches at fi.ibm.com> wrote:

     Hi

     While I understand the frustration of tiem that could be used
 otherwise. depending of what you are plannig with script wrapping I would
 recommend you seriously take a look to the REST API

 http://files.gpfsug.org/presentations/2017/Ehningen/23_-_SSUG17DE_-_Alexander_Wolf-Reber_-_Spectrum_Scale_ReST_API.pdf

     --
     Yst?v?llisin terveisin / Kind regards / Saludos cordiales /
 Salutations

     Luis Bolinches
     Lab Services
     http://www-03.ibm.com/systems/services/labservices/

     IBM Laajalahdentie 23 (main Entrance) Helsinki, 00330 Finland
     Phone: +358 503112585

     "If you continually give you will continually have." Anonymous

     ----- Original message -----
     From: Jonathon A Anderson <jonathon.anderson at colorado.edu>
     Sent by: gpfsug-discuss-bounces at spectrumscale.org
     To: gpfsug main discussion list <gpfsug-discuss at spectrumscale.org>
     Cc:
     Subject: Re: [gpfsug-discuss] -Y option for many commands, precious
 few officially!
     Date: Tue, Mar 28, 2017 7:17 PM

     I had a bit of a run-in with a gpfs developer at a conference once
 when I complained about how command output changes frequently, breaking
 customer scripts. He was confused why we weren?t
      using `-Y`, and didn?t believe me that it?s simply not documented
 anywhere!

     `-Y` output is essential for interfacing programmatically with GPFS,
 and I don?t understand why it?s not mentioned in any of the guides or
 manpages. (Though apparently, according to this thead, it?s since appeared
 in some newer manpages.)

     ~jonathon

     On 3/28/17, 10:14 AM, "gpfsug-discuss-bounces at spectrumscale.org on
 behalf of Marc A Kaplan" <gpfsug-discuss-bounces at spectrumscale.org on
 behalf of makaplan at us.ibm.com> wrote:

         Just looking/scanning the latest (4.2.2) Spectrum Scale Command
 (and Programming) Reference I only found a few commands that officially
 are documented as supporting a -Y option:  mmnfs, mmsmb, mmuserauth.

         But as many of you have discovered, -Y is accepted and yields
 "interesting" output for many of the mmXXXX commands.
         Moreover the output *seems to* have easily discernible patterns
 that can be parsed by simple programs.

         I believe there is no guarantee that the exact command output
 formats will not change from release to release, so, as a practical
 matter, if you're going to parse command output, you're probably better
 off parsing the -Y output,
          even if that is not officially supported.

     _______________________________________________
     gpfsug-discuss mailing list
     gpfsug-discuss at spectrumscale.org
     http://gpfsug.org/mailman/listinfo/gpfsug-discuss

     Ellei edell? ole toisin mainittu: / Unless stated otherwise above:
     Oy IBM Finland Ab
     PL 265, 00101 Helsinki, Finland
     Business ID, Y-tunnus: 0195876-3
     Registered in Finland

 ------------------------------

 Message: 3
 Date: Tue, 28 Mar 2017 16:37:12 +0000
 From: "Simon Thompson (Research Computing - IT Services)"
 <S.J.Thompson at bham.ac.uk>
 To: gpfsug main discussion list <gpfsug-discuss at spectrumscale.org>
 Subject: Re: [gpfsug-discuss] -Y option for many commands, precious
 few officially!
 Message-ID: <D5004FA9.399EC%s.j.thompson at bham.ac.uk>
 Content-Type: text/plain; charset="us-ascii"

 I thought the header rows defined what the format of the output was. Its a
 bit weird as there can be multiple header rows for different content
 rows ...

 Simon

 From: <gpfsug-discuss-bounces at spectrumscale.org<
 mailto:gpfsug-discuss-bounces at spectrumscale.org>> on behalf of Marc A
 Kaplan <makaplan at us.ibm.com<mailto:makaplan at us.ibm.com>>
 Reply-To: "gpfsug-discuss at spectrumscale.org<
 mailto:gpfsug-discuss at spectrumscale.org>"
 <gpfsug-discuss at spectrumscale.org<mailto:gpfsug-discuss at spectrumscale.org
 >>
 Date: Tuesday, 28 March 2017 at 17:14
 To: "gpfsug-discuss at spectrumscale.org<
 mailto:gpfsug-discuss at spectrumscale.org>"
 <gpfsug-discuss at spectrumscale.org<mailto:gpfsug-discuss at spectrumscale.org
 >>
 Subject: Re: [gpfsug-discuss] -Y option for many commands, precious few
 officially!

 Just looking/scanning the latest (4.2.2) Spectrum Scale Command (and
 Programming) Reference I only found a few commands that officially are
 documented as supporting a -Y option:  mmnfs, mmsmb, mmuserauth.

 But as many of you have discovered, -Y is accepted and yields
 "interesting" output for many of the mmXXXX commands.
 Moreover the output *seems to* have easily discernible patterns that can
 be parsed by simple programs.

 I believe there is no guarantee that the exact command output formats will
 not change from release to release, so, as a practical matter, if you're
 going to parse command output, you're probably better off parsing the -Y
 output, even if that is not officially supported.

 -------------- next part --------------
 An HTML attachment was scrubbed...
 URL: <
 http://gpfsug.org/pipermail/gpfsug-discuss/attachments/20170328/2c551c41/attachment-0001.html
 >

 ------------------------------

 Message: 4
 Date: Tue, 28 Mar 2017 16:37:47 +0000
 From: Jonathon A Anderson <jonathon.anderson at colorado.edu>
 To: gpfsug main discussion list <gpfsug-discuss at spectrumscale.org>
 Subject: Re: [gpfsug-discuss] -Y option for many commands, precious
 few officially!
 Message-ID: <DEB4F27D-8814-4514-AC65-D5DA4F55178B at colorado.edu>
 Content-Type: text/plain; charset="utf-8"

 Sure; but that only helps if you know the flag even exists.

 ~jonathon

 On 3/28/17, 10:37 AM, "gpfsug-discuss-bounces at spectrumscale.org on behalf
 of Simon Thompson (Research Computing - IT Services)"
 <gpfsug-discuss-bounces at spectrumscale.org on behalf of
 S.J.Thompson at bham.ac.uk> wrote:

     I thought the header rows defined what the format of the output was.
 Its a bit weird as there can be multiple header rows for different content
 rows ...

     Simon

     From: <gpfsug-discuss-bounces at spectrumscale.org> on behalf of Marc A
 Kaplan <makaplan at us.ibm.com>
     Reply-To: "gpfsug-discuss at spectrumscale.org"
 <gpfsug-discuss at spectrumscale.org>
     Date: Tuesday, 28 March 2017 at 17:14
     To: "gpfsug-discuss at spectrumscale.org"
 <gpfsug-discuss at spectrumscale.org>
     Subject: Re: [gpfsug-discuss] -Y option for many commands, precious
 few officially!

     Just looking/scanning the latest (4.2.2) Spectrum Scale Command (and
 Programming) Reference I only found a few commands that officially are
 documented as supporting a -Y option:  mmnfs, mmsmb, mmuserauth.

     But as many of you have discovered, -Y is accepted and yields
 "interesting" output for many of the mmXXXX commands.
     Moreover the output *seems to* have easily discernible patterns that
 can be parsed by simple programs.

     I believe there is no guarantee that the exact command output formats
 will not change from release to release, so, as a practical matter, if
 you're going to parse command output, you're probably better off parsing
 the -Y output,
      even if that is not officially supported.

 ------------------------------

 _______________________________________________
 gpfsug-discuss mailing list
 gpfsug-discuss at spectrumscale.org
 http://gpfsug.org/mailman/listinfo/gpfsug-discuss

 End of gpfsug-discuss Digest, Vol 62, Issue 70
 **********************************************

_______________________________________________
gpfsug-discuss mailing list
gpfsug-discuss at spectrumscale.org
http://gpfsug.org/mailman/listinfo/gpfsug-discuss

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://gpfsug.org/pipermail/gpfsug-discuss_gpfsug.org/attachments/20170328/a61db5b6/attachment-0002.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: graycol.gif
Type: image/gif
Size: 105 bytes
Desc: not available
URL: <http://gpfsug.org/pipermail/gpfsug-discuss_gpfsug.org/attachments/20170328/a61db5b6/attachment-0002.gif>