VMS Help DCE, dce_intro, dce_svc_intro, dce_svc_set_progname  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   dce_svc_set_progname - Sets an application's program name

 SYNOPSIS

   #include <dce/dce.h>

   void dce_svc_set_progname( char *program_name,
                              error_status_t *status );

 PARAMETERS

   Input

   program_name
          A string containing the name that is to be included in the
          text of all serviceability messages that the application
          generates during the session.

   Output

   status
          Returns the status code from this operation. The status code
          is a value that indicates whether the routine completed
          successfully and if not, why not.

 DESCRIPTION

   This function sets the application's program name, which is included
   in serviceability messages.  This allows serviceability messages
   from more than one application to be written to the same file and
   still be distinguishable as to their separate origins.

   If dce_svc_set_progname() is not called, the application's generated
   serviceability messages will be identified by its process ID.

 EXAMPLES

   Suppose an application sets its program name to be "demo_program",
   as shown:

        dce_svc_set_progname("demo_program", &status);

   Serviceability messages generated by the program will as a result
   look like the following:

        1994-04-05-20:13:34.500+00:00I----- demo_program NOTICE app
                                            main.c 123 0xa444e208
        message text

   If the application does not set its program name, its generated
   serviceability messages will have the following form:

        1994-04-05-20:13:34.500+00:00I----- PID#9467 NOTICE app main.c
                                            123 0xa444e208
        message text

 ERROR CODES

   See dce_svc_register.

 RELATED INFORMATION

   Functions: dce_printf
              dce_svc_printf
              DCE_SVC_DEBUG