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

[Rolf Rabenseifner]

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)