###############################################################################
#
# @(#)11        1.3  src/examples/svc/hello_svc/readme, examples.src, os2dce21.dss, 960602a.1  5/12/96  10:12:17
#
# COMPONENT_NAME:  examples.src
#
# FUNCTIONS: hello_svc readme
#
# ORIGINS: 72/27
#
# (C) COPYRIGHT International Business Machines Corp. 1995
#  All Rights Reserved
#  Licensed Materials - Property of IBM
#
#  US Government Users Restricted Rights - Use, duplication or
#  disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
#
# @OSF_COPYRIGHT@
# COPYRIGHT NOTICE
# Copyright (c) 1990, 1991, 1992, 1993, 1994 Open Software Foundation, Inc.
# ALL RIGHTS RESERVED (DCE).  See the file named COPYRIGHT.DCE in the
# src directory for the full copyright text.
#
###############################################################################

-------------------------------------------------------------------------------
opt\dcelocal\examples\svc\hello_svc
-------------------------------------------------------------------------------

				
		DCE Sample Application "hello_svc"


The hello_svc program is a very simple demo/test of the DCE Serviceability API.
When executed, it does nothing more than print a "Hello world" message to
standard error via the serviceability interface.

The program was developed during the writing of the OSF DCE Application Devel-
opment Guide chapter on Serviceability, and is included in the DCE 1.1 Beta
release as a very simple demo of the interface.

Refer to the main Examples Readme file in opt\dcelocal\examples
for information on how to build this example.


Once you have built hello_svc, run it by typing

  --->  hello_svc

with no arguments. You should see two messages similar to the following:

1995-06-08-01:46:17.160+00:00I----- hello_svc NOTICE hel main hello_svc.c 139 0x0f4e2680
Hello world
1995-06-08-01:46:17.160+00:00I----- hello_svc NOTICE hel main hello_svc.c 139 0x0f4e2680
Hello world


(The message is printed twice because it is routed to standard error twice:
once via a call to dce_svc_routing() within the program, and also by the
"attributes" field in the message definition in the hel.sams file.)

For more information on Serviceability functionality, see the IBM DCE
Application Development Guide -- Core Components volume. See also the
(dcecp log object, through which the DCE components' serviceability routes
and settings are managed) reference page in the IBM DCE Command Reference.


