[Mpi-forum] MPI-3: MPI_T_... names

Wed Jul 25 02:28:52 CDT 2012

After no objection by the tools chapter committee,
I would change everywhere (tools + appLang) in one svn step:

- from old
    MPI_T_ERR_CANNOTINIT
    MPI_T_ERR_NOTINITIALIZED
    MPI_T_ERR_MEMORY
    MPI_T_ERR_CVAR_SETNOTNOW
    MPI_T_ERR_CVAR_SETNEVER
    MPI_T_ERR_PVAR_NOWRITE
    MPI_T_ERR_PVAR_NOSTARTSTOP
    MPI_T_ERR_PVAR_NOATOMIC
    MPI_T_ERR_INVALIDINDEX
    MPI_T_ERR_INVALIDITEM
    MPI_T_ERR_INVALIDSESSION
    MPI_T_ERR_INVALIDHANDLE
    MPI_T_ERR_OUTOFHANDLES
    MPI_T_ERR_OUTOFSESSIONS
  to new
    MPI_T_ERR_CANNOT_INIT
    MPI_T_ERR_NOT_INITIALIZED
    MPI_T_ERR_MEMORY           (unchanged)
    MPI_T_ERR_CVAR_SET_NOT_NOW
    MPI_T_ERR_CVAR_SET_NEVER
    MPI_T_ERR_PVAR_NO_WRITE
    MPI_T_ERR_PVAR_NO_STARTSTOP
    MPI_T_ERR_PVAR_NO_ATOMIC
    MPI_T_ERR_INVALID_INDEX
    MPI_T_ERR_INVALID_ITEM
    MPI_T_ERR_INVALID_SESSION
    MPI_T_ERR_INVALID_HANDLE
    MPI_T_ERR_OUT_OF_HANDLES
    MPI_T_ERR_OUT_OF_SESSIONS

Best regards
Rolf

----- Original Message -----
> From: "Bronis R. de Supinski" <bronis at llnl.gov>
> To: "Main MPI Forum mailing list" <mpi-forum at lists.mpi-forum.org>
> Sent: Tuesday, July 24, 2012 1:03:07 PM
> Subject: Re: [Mpi-forum] MPI-3: MPI_T_... names
> I have no strong opinion on this issue.
> 
> On Tue, 24 Jul 2012, Rolf Rabenseifner wrote:
> 
> > I started a new email-trunk, because this mail is mainly about
> > names.
> >
> > The problem with MPI_T_... names is that they are partially
> > very long:
> >
> > Current longest MPI_T constants:
> >
> > 123456789012345678901234567890
> > MPI_T_PVAR_CLASS_HIGHWATERMARK (30)
> > MPI_T_PVAR_CLASS_LOWWATERMARK (29)
> > MPI_T_VERBOSITY_MPIDEV_DETAIL (29)
> >
> > The system is classes of constants are named with underscores,
> > e.g. MPI_T_PVAR_CLASS, the end-names without underscores,
> > e.g. HIGHWATERMARK.
> >
> > In the error codes, your right, they
> > - should change from
> >    MPI_T_ERR_INVALIDINDEX
> >    MPI_T_ERR_INVALIDITEM
> >    MPI_T_ERR_INVALIDSESSION
> >    MPI_T_ERR_INVALIDHANDLE
> >  to
> >    MPI_T_ERR_INVALID_INDEX
> >    MPI_T_ERR_INVALID_ITEM
> >    123456789012345678901234567890
> >    MPI_T_ERR_INVALID_SESSION (25)
> >    MPI_T_ERR_INVALID_HANDLE
> >  because the class name is MPI_T_ERR_INVALID_
> >
> > - and also
> >    MPI_T_ERR_OUTOFHANDLES
> >    MPI_T_ERR_OUTOFSESSIONS
> >  to
> >    MPI_T_ERR_OUT_OF_HANDLES
> >    MPI_T_ERR_OUT_OF_SESSIONS
> > - and they may change
> >    MPI_T_ERR_CANNOTINIT
> >    MPI_T_ERR_NOTINITIALIZED
> >    MPI_T_ERR_MEMORY
> >    MPI_T_ERR_CVAR_SETNOTNOW
> >    MPI_T_ERR_CVAR_SETNEVER
> >    MPI_T_ERR_PVAR_NOWRITE
> >    MPI_T_ERR_PVAR_NOSTARTSTOP
> >    MPI_T_ERR_PVAR_NOATOMIC
> >  to
> >    MPI_T_ERR_CANNOT_INIT
> >    MPI_T_ERR_NOT_INITIALIZED
> >    MPI_T_ERR_MEMORY
> >    MPI_T_ERR_CVAR_SET_NOT_NOW
> >    MPI_T_ERR_CVAR_SET_NEVER
> >    MPI_T_ERR_PVAR_NO_WRITE
> >    123456789012345678901234567890
> >    MPI_T_ERR_PVAR_NO_STARTSTOP (27)
> >    MPI_T_ERR_PVAR_NO_ATOMIC
> >
> > All the other MPI_T_... names seem to be fine.
> >
> > Bets regards
> > Rolf
> >
> > ----- Original Message -----
> >> From: "Alexander Supalov" <alexander.supalov at intel.com>
> >> To: "Martin Schulz" <schulzm at llnl.gov>, "Main MPI Forum mailing
> >> list" <mpi-forum at lists.mpi-forum.org>
> >> Sent: Tuesday, July 24, 2012 9:35:13 AM
> >> Subject: Re: [Mpi-forum] MPI-3: MPI_T_ERR_... and MPI_ERR_LASTCODE
> >> Hi everybody,
> >>
> >> I see that that my innocent remarks re. Annex A have lead to a lot
> >> of
> >> discussion. What I'm going to say may resemble Bart Simpson's "I
> >> didn't do it", but I think I have to:
> >>
> >> When commenting on the MPI_T_* names, I meant only their
> >> composition
> >> that differed from most other comparable MPI constant names in that
> >> it
> >> was 1) using contractions and 2) not using underscores to separate
> >> different words. The MPI_T_CANTINIT was but one example of this. I
> >> proposed to change all MPI_T_* names to follow the more traditional
> >> rules (i.e., 1) do not use contractions and 2) do use underscores),
> >> which lead to the MPI_T_CANNOT_INIT proposal that should be
> >> consistently followed up on for every other MPI_T_* name. The
> >> MPI_ERR_LASTCODE was mentioned as a counterexample of a known MPI
> >> constant name that was not following this set of rules either. Oh
> >> well, this is an old one and we won't change it. At no time did I
> >> intend the MPI_T series to become a part of the MPI_ERR series,
> >> although I must admit that they look really close when you start
> >> thinking about them. We will probably have enough time for this
> >> contemplation in the MPI 3.1 time frame.
> >>
> >> To sum up, my proposal now is:
> >>
> >> 1) Consider replacing contractions in all MPI_T_* names
> >> 2) Consider using underscores in all MPI_T_* names
> >> 3) Drop the MPI_ERR and MPI_T connection idea
> >>
> >> And if 1) and 2) are considered too invasive at this point, I won't
> >> go
> >> nuts either: after all, these are just constant names.
> >>
> >> Best regards.
> >>
> >> Alexander
> >
> > --
> > Dr. Rolf Rabenseifner . . . . . . . . . .. email
> > rabenseifner at hlrs.de
> > High Performance Computing Center (HLRS) . phone
> > ++49(0)711/685-65530
> > University of Stuttgart . . . . . . . . .. fax ++49(0)711 /
> > 685-65832
> > Head of Dpmt Parallel Computing . . .
> > www.hlrs.de/people/rabenseifner
> > Nobelstr. 19, D-70550 Stuttgart, Germany . (Office: Allmandring 30)
> > _______________________________________________
> > mpi-forum mailing list
> > mpi-forum at lists.mpi-forum.org
> > http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi-forum
> >
> _______________________________________________
> mpi-forum mailing list
> mpi-forum at lists.mpi-forum.org
> http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi-forum

-- 
Dr. Rolf Rabenseifner . . . . . . . . . .. email rabenseifner at hlrs.de
High Performance Computing Center (HLRS) . phone ++49(0)711/685-65530
University of Stuttgart . . . . . . . . .. fax ++49(0)711 / 685-65832
Head of Dpmt Parallel Computing . . . www.hlrs.de/people/rabenseifner
Nobelstr. 19, D-70550 Stuttgart, Germany . (Office: Allmandring 30)