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>

VistaIO Version 1.2.14                            24 April 1993                         VistaIOSetProgramName(3)