evmitemlistget man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

EvmItemGet(3)							 EvmItemGet(3)

NAME
       EvmItemGet(),  EvmItemListFree(),  EvmItemListGet(),  EvmItemRelease(),
       EvmItemSet(), EvmItemSetVa() - create and manipulate event items

SYNOPSIS
   Library
       EVM Support Library

   Parameters
       event	     The event containing the item to be manipulated.

       item_id	     The identifier  for  the  event  data  item  to  be  set,
		     obtained,	or  released  by the called routine.  Possible
		     values for this operand, and the data  contained  by  the
		     data  item are identified in the following list.  See the
		     EvmEvent(5) manpage for a description of the  event  data
		     items.

       Identifier		Data Item
       ─────────────────────────────────────────────────────
       EvmITEM_NONE		None (Control use)
       EvmITEM_NAME		Event name
       EvmITEM_PRIORITY		Priority
       EvmITEM_PID		Process identifier
       EvmITEM_PPID		Parent process identifier
       EvmITEM_EVENT_ID		Event identifier
       EvmITEM_TIMESTAMP	Time posted
       EvmITEM_REPEAT_COUNT	Repeat count
       EvmITEM_LAST_TIMESTAMP	Last timestamp
       EvmITEM_I18N_MSG_ID	I18N message identifier
       EvmITEM_I18N_SET_ID	I18N message set identifier
       EvmITEM_I18N_CATALOG	I18N catalog
       EvmITEM_HOST_IP		Host IP address
       EvmITEM_HOST_NAME	Host name
       EvmITEM_USER_NAME	User name
       EvmITEM_FORMAT		Event format
       EvmITEM_REF		Reference
       EvmITEM_VAR		Variables
       EvmITEM_KERNEL_ONLY	Kernel distribution Only
       ─────────────────────────────────────────────────────

	      It is also possible to supply a separate item_id for each of the
	      supported variable types.	 In these cases, an extra one  or  two
	      operands (depending on the type) must be supplied in addition to
	      the item_value.  See the description below for more information.
	      The following extended variable item IDs are supported:

       Identifier		 Variable Type	  Parameters
       ───────────────────────────────────────────────────────────────────
       EvmITEM_VAR_CHAR		 EvmTYPE_CHAR	  Name, value
       EvmITEM_VAR_INT16	 EvmTYPE_INT16	  Name, value
       EvmITEM_VAR_INT32	 EvmTYPE_INT32	  Name, value
       EvmITEM_VAR_INT64	 EvmTYPE_INT64	  Name, value
       EvmITEM_VAR_UINT8	 EvmTYPE_UINT8	  Name, value
       EvmITEM_VAR_UINT16	 EvmTYPE_UINT16	  Name, value
       EvmITEM_VAR_UINT32	 EvmTYPE_UINT32	  Name, value
       EvmITEM_VAR_UINT64	 EvmTYPE_UINT64	  Name, value
       EvmITEM_VAR_FLOAT	 EvmTYPE_FLOAT	  Name, value
       EvmITEM_VAR_DOUBLE	 EvmTYPE_DOUBLE	  Name, value
       EvmITEM_VAR_STRING	 EvmTYPE_STRING	  Name, value
       EvmITEM_VAR_STRING_I18N	 EvmTYPE_STRING	  Name, value, I18N msgid

       EvmITEM_VAR_OPAQUE	 EvmTYPE_OPAQUE	  Name, value, size
       ───────────────────────────────────────────────────────────────────

       item_value    The  value	 stored into the item indicated by the associ‐
		     ated item_id.  For this is the location where  the	 value
		     extracted from the event is stored.

       item_count    This  is  the return operand. It is the number of entries
		     in item_list, exclusive of the terminating entry.

DESCRIPTION
       These routines manipulate data in the standard items in an event.

       The routine sets the value of the event data item specified by  item_id
       to the item_value supplied by the caller.

       The  routine  sets  item	 values in the event.  The list of item_id and
       item_value operands is terminated by an instance of item_id of

       The inclusion of extended variable item-IDs simplifies  programming  by
       allowing variable items to be added to an event without first having to
       set up an structure,  or	 to  release  it  afterwards.	To  use	 these
       extended	 item-IDs,  follow  each with the name of the variable, then a
       value of the appropriate type.  In addition, an value must be  followed
       by an I18N message ID, and an value must be followed by a size.

       The routine returns, in the item_value reference argument, the value of
       the event data item specified by item_id.  The caller must use to  free
       any space allocated for the item.

       The routine releases any storage space that was allocated when the data
       item named by item_id was retrieved from an event using

       The routine returns, in the itemList reference argument, a list of  all
       of the items, which are currently defined for the event.	 The last item
       in the list has an item_id value of The number of items	in  the	 list,
       not   including	 the  terminating  null	 identifier,  is  returned  in
       item_count.  The caller is responsible for freeing the memory  used  by
       the list by calling

       The  routine frees the memory used by an item list.  The itemList oper‐
       and is a list of items in an event generated by

RETURN VALUE
       The operation completed without error.

       One of the arguments to the function is invalid.

       A value in a structure member is invalid.

       An operation failed because an attempt to acquire heap memory failed.

       A request specified an item or variable name component in an
	      itemList or a varList that is not part of the event  being  pro‐
	      cessed.

ERRORS
       The value of is not set.

SEE ALSO
   Commands
       evmshow(1).

   Routines
       EvmEventCreate(3),   EvmEventDestroy(3),	 EvmEventFormat(3),  EvmEvent‐
       Post(3).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

								 EvmItemGet(3)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net