diag_rm_obj

Purpose

Deletes objects from an object class.

Syntax


#include  <diag/diagodm.h>
#include  <sys/cfgodm.h>
#include  <diag/DiagODM.h>

void diag_rm_obj ( 
                                void        *classp,
                                char        *criteria)

Description

The diag_rm_obj subroutine deletes objects from an object class.
Note: init_dgodm must be called before starting this subroutine.

Parameters

Parameter Description
classp Class symbol identifier returned from a diag_open_class subroutine. If the diag_open_class subroutine has not been called, then this is the structure name of the class normally defined in either diag/diagodm.h file, diag/DiagODM.h file or sys/cfgodm.h file.
criteria String containing the qualifying criteria for selecting objects to delete.

Return Value

Upon successful completion, the number of objects deleted is returned. If the subroutine fails, a -1 is returned.