Previous section.

Systems Management; Event Management Service (XEMS)
Copyright © 1997 The Open Group

Registration Interface

The registration interface allows registration with XEMS for applications that are not suppliers or consumers. Systems Management: Event Management Service - ems_register
Previous section.

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

NAME

ems_register - register with XEMS

SYNOPSIS

#include <xems.h>

void ems_register(
    ems_netname_t *      hostname,
    ems_handle_t *       handle,
    ems_error_t *        status);

DESCRIPTION

This routine registers with EMS by obtaining an EMS handle. The EMS handle is then used to on future calls to the Event Service.

PARAMETERS

Input

hostname

the name of the host machine where an Event Service is running. If the hostname is NULL, then the local host is assumed

Output

handle

returns an EMS handle to use for future calls to EMS routines.

status

returns the status code from this routine which indicates whether the routine completed successfully or, if not, why not.

RETURN VALUE

The possible status codes are:


ems_s_status_ok
ems_s_unsupported_nameservice

Systems Management: Event Management Service - ems_unregister
Previous section.

NAME

ems_unregister - unregister with XEMS.

SYNOPSIS

#include <xems.h>

void ems_unregister(
    ems_handle_t *         handle,
    ems_error_t *          status);

DESCRIPTION

This routine unregisters an EMS handle with EMS. The resources held by the XEMS handle are freed, and handle is assigned NULL. The handle can be one obtained by ems_register() or ems_consumer_register().

PARAMETERS

Input

handle

the EMS handle to unregister.

Output

handle

assigns NULL to handle.

status

returns the status code from this routine which indicates whether the routine completed successfully or, if not, why not.

RETURN VALUE

The possible status codes are:


ems_s_status_ok
ems_s_invalid_handle

Contents Next section Index