OSAClearValues(3sadm)

OSAClearList, OSARemoveAttribute -- remove return list structure

Synopsis

CC ... -lsysadm -lvtcl -ltclx -ltcl -lsocket -lgen -lm

#include <scoadmin/osaStdDef.h>

void OSARemoveAttribute(returnListPtr, attributeToken)

void OSAClearList(returnListPtr)

Description

These procedures allow the C/C++ OSAs to remove all or portions of a previously altered return list structure. OSARemoveAttribute looks for the named attribute in the return list structure and if it is found it removes it and any value(s) associated with it from the return list structure. The given attribute can still be added to the list again at some future time.

OSAClearList removes all attributes and their data from a return list structure. It will also remove any data added to the list by calls to the OSAReturnBoolean and OSAReturnActionData commands. Additional data can still be added to the list at some future time.

It is not recommend that OSAClearList and OSARemoveAttribute be called excessively on the same return list instance, as it will slow down future access time on that return list structure.

Arguments

ofParameterList_cl *returnListPtr: A pointer to the return list data structure. All return values are contained in this structure and are accessed and changed via SCOadmin services library routines.
attributeToken_t attributeToken: The predefined token that represents the attribute to which the given value should be associated with. These tokens are defined in the OSA's CDT.

References

OSAReturnValues(3sadm)