NAME

       VistaIOSetProgramName - register a program name for error messages

SYNOPSIS

       void VistaIOSetProgramName (name)
              VistaIOStringConst name

ARGUMENTS

       name      Specifies the program's name as a null-terminated string, or is NULL to indicate
                 that no program name should be registered.

DESCRIPTION

       VistaIOSetProgramName determines what, if any, program name will be included in subsequent
       error messages composed by VistaIOError (3), VistaIOSystemError(3), VistaIOWarning(3), and
       VistaIOSystemWarning(3).

       Initially, no program name is  registered.  If  VistaIOSetProgramName  is  called  with  a
       string, that string is registered as the program name.  If VistaIOSetProgramName is called
       with an argument of NULL, any previously-registered name is forgotten.

EXAMPLES

              int main (argc, argv)
              int argc;
              char *argv[];
              {
                   ...
                   VistaIOSetProgramName (argv[0]);
                   ...
              }

SEE ALSO

       VistaIOError(3), VistaIOWarning(3), VistaIOSetErrorHandler(3),
       VistaIOSetWarningHandler(3),

NOTES

       VistaIOSetProgramName   does   not  make  its  own  copy  of  the  string  it  is  passed.
       Consequently, storage used for the string must be maintained by the caller.

AUTHOR

       Art Pope <pope@cs.ubc.ca>

       Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>