com.neeve.server.mon
Interface ISrvMonSysStats

All Superinterfaces:
IRogValidatable
All Known Implementing Classes:
SrvMonSysStats

@Generated(value="com.neeve.adm.AdmGenerator",
           date="Wed Mar 28 10:54:31 EDT 2018")
@AdmGenerated(compatLevel="3.8.0",
              admVersion="nvx-adm v3.7.265 (build 0)",
              date="3/28/18 10:54 AM",
              buildInfo="nvx-talon-3.7.265 (nvx-codegen-plugin)")
public interface ISrvMonSysStats
extends IRogValidatable

Groups together stats related to the JVM / System on which the server is running.


Method Summary
 void addDiskStats(SrvMonSysDiskStats val)
          Adds the provided value to the list of 'diskStats' values.
 void clearAvailableProcessors()
          Clears the value of 'availableProcessors' Field Description The number of processors available to the Java virtual machine
 void clearDiskStats()
          Clears the value of 'diskStats' Field Description Holds disk related stats.
 void clearGcStats()
          Clears the value of 'gcStats' Field Description Holds GC related stats.
 void clearJitStats()
          Clears the value of 'jitStats' Field Description Holds JIT (Just In Time compiler) related stats.
 void clearMemoryStats()
          Clears the value of 'memoryStats' Field Description Holds memory related stats.
 void clearProcessCpuLoad()
          Clears the value of 'processCpuLoad' Field Description Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).
 void clearSystemCpuLoad()
          Clears the value of 'systemCpuLoad' Field Description Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).
 void clearSystemLoadAverage()
          Clears the value of 'systemLoadAverage' Field Description The system load average for the last minute.
 void clearThreadStats()
          Clears the value of 'threadStats' Field Description Holds thread related stats.
 int getAvailableProcessors()
          Gets the value of 'availableProcessors' Field Description The number of processors available to the Java virtual machine
 SrvMonSysDiskStats[] getDiskStats()
          Gets the value of 'diskStats' If the field is not set this method will return null.
 SrvMonSysDiskStats[] getDiskStatsEmptyIfNull()
          Gets the value of 'diskStats' or an empty array if the value is null or not set.
 XIterator<SrvMonSysDiskStats> getDiskStatsIterator()
          Gets the value of 'diskStats' as iterator of values.
 SrvMonSysGCStats getGcStats()
          Gets the value of 'gcStats' Field Description Holds GC related stats.
 void getGcStatsTo(SrvMonSysGCStats val)
          Copies the value of SrvMonSysGCStats into the provided value.
 SrvMonSysJITStats getJitStats()
          Gets the value of 'jitStats' Field Description Holds JIT (Just In Time compiler) related stats.
 void getJitStatsTo(SrvMonSysJITStats val)
          Copies the value of SrvMonSysJITStats into the provided value.
 SrvMonSysMemoryStats getMemoryStats()
          Gets the value of 'memoryStats' Field Description Holds memory related stats.
 void getMemoryStatsTo(SrvMonSysMemoryStats val)
          Copies the value of SrvMonSysMemoryStats into the provided value.
 double getProcessCpuLoad()
          Gets the value of 'processCpuLoad' Field Description Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).
 double getSystemCpuLoad()
          Gets the value of 'systemCpuLoad' Field Description Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).
 double getSystemLoadAverage()
          Gets the value of 'systemLoadAverage' Field Description The system load average for the last minute.
 SrvMonSysThreadStats getThreadStats()
          Gets the value of 'threadStats' Field Description Holds thread related stats.
 void getThreadStatsTo(SrvMonSysThreadStats val)
          Copies the value of SrvMonSysThreadStats into the provided value.
 boolean hasAvailableProcessors()
          Checks for the presence of 'availableProcessors' Field Description The number of processors available to the Java virtual machine
 boolean hasGcStats()
          Checks for the presence of 'gcStats' Field Description Holds GC related stats.
 boolean hasJitStats()
          Checks for the presence of 'jitStats' Field Description Holds JIT (Just In Time compiler) related stats.
 boolean hasMemoryStats()
          Checks for the presence of 'memoryStats' Field Description Holds memory related stats.
 boolean hasProcessCpuLoad()
          Checks for the presence of 'processCpuLoad' Field Description Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).
 boolean hasSystemCpuLoad()
          Checks for the presence of 'systemCpuLoad' Field Description Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).
 boolean hasSystemLoadAverage()
          Checks for the presence of 'systemLoadAverage' Field Description The system load average for the last minute.
 boolean hasThreadStats()
          Checks for the presence of 'threadStats' Field Description Holds thread related stats.
 void lendDiskStats(SrvMonSysDiskStats val)
          Adds the provided value to the list of 'diskStats' values and acquires a reference to it.
 void lendDiskStats(SrvMonSysDiskStats[] val)
          Lends the value of 'diskStats' Field Description Holds disk related stats.
 void lendDiskStatsFrom(XIterator<SrvMonSysDiskStats> val)
          Sets the value of 'diskStats' by lending the values from the provided iterator.
 void lendGcStats(SrvMonSysGCStats val)
          'Lends' a reference of the SrvMonSysGCStats to the message for this field.
 void lendJitStats(SrvMonSysJITStats val)
          'Lends' a reference of the SrvMonSysJITStats to the message for this field.
 void lendMemoryStats(SrvMonSysMemoryStats val)
          'Lends' a reference of the SrvMonSysMemoryStats to the message for this field.
 void lendThreadStats(SrvMonSysThreadStats val)
          'Lends' a reference of the SrvMonSysThreadStats to the message for this field.
 void setAvailableProcessors(int val)
          Sets the value of 'availableProcessors' Field Description The number of processors available to the Java virtual machine
 void setDiskStats(SrvMonSysDiskStats[] val)
          Sets the value of 'diskStats' Field Description Holds disk related stats.
 void setDiskStatsFrom(XIterator<SrvMonSysDiskStats> val)
          Sets the value of 'diskStats' using the values from the provided iterator.
 void setGcStats(SrvMonSysGCStats val)
          Sets the value of 'gcStats' Field Description Holds GC related stats.
 void setJitStats(SrvMonSysJITStats val)
          Sets the value of 'jitStats' Field Description Holds JIT (Just In Time compiler) related stats.
 void setMemoryStats(SrvMonSysMemoryStats val)
          Sets the value of 'memoryStats' Field Description Holds memory related stats.
 void setProcessCpuLoad(double val)
          Sets the value of 'processCpuLoad' Field Description Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).
 void setSystemCpuLoad(double val)
          Sets the value of 'systemCpuLoad' Field Description Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).
 void setSystemLoadAverage(double val)
          Sets the value of 'systemLoadAverage' Field Description The system load average for the last minute.
 void setThreadStats(SrvMonSysThreadStats val)
          Sets the value of 'threadStats' Field Description Holds thread related stats.
 SrvMonSysDiskStats[] takeDiskStats()
          Takes the value of 'diskStats' Field Description Holds disk related stats.
 SrvMonSysGCStats takeGcStats()
          'Takes' a reference to the gcStats field from the message.
 SrvMonSysJITStats takeJitStats()
          'Takes' a reference to the jitStats field from the message.
 SrvMonSysMemoryStats takeMemoryStats()
          'Takes' a reference to the memoryStats field from the message.
 SrvMonSysThreadStats takeThreadStats()
          'Takes' a reference to the threadStats field from the message.
 
Methods inherited from interface com.neeve.rog.IRogValidatable
getValidationErrors, isValid
 

Method Detail

setAvailableProcessors

void setAvailableProcessors(int val)
Sets the value of 'availableProcessors'

Field Description

The number of processors available to the Java virtual machine

Parameters:
val - The value to set.

getAvailableProcessors

int getAvailableProcessors()
Gets the value of 'availableProcessors'

Field Description

The number of processors available to the Java virtual machine

Returns:
The number of processors available to the Java virtual machine

clearAvailableProcessors

void clearAvailableProcessors()
Clears the value of 'availableProcessors'

Field Description

The number of processors available to the Java virtual machine

See Also:
setAvailableProcessors(int)

hasAvailableProcessors

boolean hasAvailableProcessors()
Checks for the presence of 'availableProcessors'

Field Description

The number of processors available to the Java virtual machine

See Also:
getAvailableProcessors()

setSystemLoadAverage

void setSystemLoadAverage(double val)
Sets the value of 'systemLoadAverage'

Field Description

The system load average for the last minute.

Parameters:
val - The value to set.

getSystemLoadAverage

double getSystemLoadAverage()
Gets the value of 'systemLoadAverage'

Field Description

The system load average for the last minute.

Returns:
The system load average for the last minute.

clearSystemLoadAverage

void clearSystemLoadAverage()
Clears the value of 'systemLoadAverage'

Field Description

The system load average for the last minute.

See Also:
setSystemLoadAverage(double)

hasSystemLoadAverage

boolean hasSystemLoadAverage()
Checks for the presence of 'systemLoadAverage'

Field Description

The system load average for the last minute.

See Also:
getSystemLoadAverage()

setProcessCpuLoad

void setProcessCpuLoad(double val)
Sets the value of 'processCpuLoad'

Field Description

Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).

Parameters:
val - The value to set.

getProcessCpuLoad

double getProcessCpuLoad()
Gets the value of 'processCpuLoad'

Field Description

Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).

Returns:
Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).

clearProcessCpuLoad

void clearProcessCpuLoad()
Clears the value of 'processCpuLoad'

Field Description

Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).

See Also:
setProcessCpuLoad(double)

hasProcessCpuLoad

boolean hasProcessCpuLoad()
Checks for the presence of 'processCpuLoad'

Field Description

Holds recent cpu usage by the process (on a 0.0 to 1.0 scale).

See Also:
getProcessCpuLoad()

setSystemCpuLoad

void setSystemCpuLoad(double val)
Sets the value of 'systemCpuLoad'

Field Description

Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).

Parameters:
val - The value to set.

getSystemCpuLoad

double getSystemCpuLoad()
Gets the value of 'systemCpuLoad'

Field Description

Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).

Returns:
Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).

clearSystemCpuLoad

void clearSystemCpuLoad()
Clears the value of 'systemCpuLoad'

Field Description

Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).

See Also:
setSystemCpuLoad(double)

hasSystemCpuLoad

boolean hasSystemCpuLoad()
Checks for the presence of 'systemCpuLoad'

Field Description

Holds recent cpu usage by the system (on a 0.0 to 1.0 scale).

See Also:
getSystemCpuLoad()

setMemoryStats

void setMemoryStats(SrvMonSysMemoryStats val)
Sets the value of 'memoryStats'

Field Description

Holds memory related stats.

Parameters:
val - The value to set.

lendMemoryStats

void lendMemoryStats(SrvMonSysMemoryStats val)
'Lends' a reference of the SrvMonSysMemoryStats to the message for this field.

Field Description

Holds memory related stats.

NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message. This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().

To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.

Parameters:
val - the value to 'lend' to lend.

getMemoryStats

SrvMonSysMemoryStats getMemoryStats()
Gets the value of 'memoryStats'

Field Description

Holds memory related stats.

Returns:
Holds memory related stats.

getMemoryStatsTo

void getMemoryStatsTo(SrvMonSysMemoryStats val)
Copies the value of SrvMonSysMemoryStats into the provided value.

IF the value is not set, then the contents of the provided SrvMonSysMemoryStats are cleared.

Parameters:
val - the value to copy into
See Also:
SrvMonSysMemoryStats.copyInto(SrvMonSysMemoryStats)

takeMemoryStats

SrvMonSysMemoryStats takeMemoryStats()
'Takes' a reference to the memoryStats field from the message.

Field Description

Holds memory related stats.

NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed i.e. the act of getting an entity does not transfer ownership of the entity to the application A message disposes of its reference to its contained entities when it is disposed itself.

An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.

Returns:
a 'taken' reference to the field or null if the field is not set.

hasMemoryStats

boolean hasMemoryStats()
Checks for the presence of 'memoryStats'

Field Description

Holds memory related stats.

See Also:
getMemoryStats()

clearMemoryStats

void clearMemoryStats()
Clears the value of 'memoryStats'

Field Description

Holds memory related stats.

See Also:
setMemoryStats(SrvMonSysMemoryStats)

setGcStats

void setGcStats(SrvMonSysGCStats val)
Sets the value of 'gcStats'

Field Description

Holds GC related stats.

Parameters:
val - The value to set.

lendGcStats

void lendGcStats(SrvMonSysGCStats val)
'Lends' a reference of the SrvMonSysGCStats to the message for this field.

Field Description

Holds GC related stats.

NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message. This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().

To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.

Parameters:
val - the value to 'lend' to lend.

getGcStats

SrvMonSysGCStats getGcStats()
Gets the value of 'gcStats'

Field Description

Holds GC related stats.

Returns:
Holds GC related stats.

getGcStatsTo

void getGcStatsTo(SrvMonSysGCStats val)
Copies the value of SrvMonSysGCStats into the provided value.

IF the value is not set, then the contents of the provided SrvMonSysGCStats are cleared.

Parameters:
val - the value to copy into
See Also:
SrvMonSysGCStats.copyInto(SrvMonSysGCStats)

takeGcStats

SrvMonSysGCStats takeGcStats()
'Takes' a reference to the gcStats field from the message.

Field Description

Holds GC related stats.

NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed i.e. the act of getting an entity does not transfer ownership of the entity to the application A message disposes of its reference to its contained entities when it is disposed itself.

An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.

Returns:
a 'taken' reference to the field or null if the field is not set.

hasGcStats

boolean hasGcStats()
Checks for the presence of 'gcStats'

Field Description

Holds GC related stats.

See Also:
getGcStats()

clearGcStats

void clearGcStats()
Clears the value of 'gcStats'

Field Description

Holds GC related stats.

See Also:
setGcStats(SrvMonSysGCStats)

setJitStats

void setJitStats(SrvMonSysJITStats val)
Sets the value of 'jitStats'

Field Description

Holds JIT (Just In Time compiler) related stats.

Parameters:
val - The value to set.

lendJitStats

void lendJitStats(SrvMonSysJITStats val)
'Lends' a reference of the SrvMonSysJITStats to the message for this field.

Field Description

Holds JIT (Just In Time compiler) related stats.

NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message. This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().

To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.

Parameters:
val - the value to 'lend' to lend.

getJitStats

SrvMonSysJITStats getJitStats()
Gets the value of 'jitStats'

Field Description

Holds JIT (Just In Time compiler) related stats.

Returns:
Holds JIT (Just In Time compiler) related stats.

getJitStatsTo

void getJitStatsTo(SrvMonSysJITStats val)
Copies the value of SrvMonSysJITStats into the provided value.

IF the value is not set, then the contents of the provided SrvMonSysJITStats are cleared.

Parameters:
val - the value to copy into
See Also:
SrvMonSysJITStats.copyInto(SrvMonSysJITStats)

takeJitStats

SrvMonSysJITStats takeJitStats()
'Takes' a reference to the jitStats field from the message.

Field Description

Holds JIT (Just In Time compiler) related stats.

NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed i.e. the act of getting an entity does not transfer ownership of the entity to the application A message disposes of its reference to its contained entities when it is disposed itself.

An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.

Returns:
a 'taken' reference to the field or null if the field is not set.

hasJitStats

boolean hasJitStats()
Checks for the presence of 'jitStats'

Field Description

Holds JIT (Just In Time compiler) related stats.

See Also:
getJitStats()

clearJitStats

void clearJitStats()
Clears the value of 'jitStats'

Field Description

Holds JIT (Just In Time compiler) related stats.

See Also:
setJitStats(SrvMonSysJITStats)

setThreadStats

void setThreadStats(SrvMonSysThreadStats val)
Sets the value of 'threadStats'

Field Description

Holds thread related stats.

Parameters:
val - The value to set.

lendThreadStats

void lendThreadStats(SrvMonSysThreadStats val)
'Lends' a reference of the SrvMonSysThreadStats to the message for this field.

Field Description

Holds thread related stats.

NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message. This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().

To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.

Parameters:
val - the value to 'lend' to lend.

getThreadStats

SrvMonSysThreadStats getThreadStats()
Gets the value of 'threadStats'

Field Description

Holds thread related stats.

Returns:
Holds thread related stats.

getThreadStatsTo

void getThreadStatsTo(SrvMonSysThreadStats val)
Copies the value of SrvMonSysThreadStats into the provided value.

IF the value is not set, then the contents of the provided SrvMonSysThreadStats are cleared.

Parameters:
val - the value to copy into
See Also:
SrvMonSysThreadStats.copyInto(SrvMonSysThreadStats)

takeThreadStats

SrvMonSysThreadStats takeThreadStats()
'Takes' a reference to the threadStats field from the message.

Field Description

Holds thread related stats.

NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed i.e. the act of getting an entity does not transfer ownership of the entity to the application A message disposes of its reference to its contained entities when it is disposed itself.

An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.

Returns:
a 'taken' reference to the field or null if the field is not set.

hasThreadStats

boolean hasThreadStats()
Checks for the presence of 'threadStats'

Field Description

Holds thread related stats.

See Also:
getThreadStats()

clearThreadStats

void clearThreadStats()
Clears the value of 'threadStats'

Field Description

Holds thread related stats.

See Also:
setThreadStats(SrvMonSysThreadStats)

setDiskStats

void setDiskStats(SrvMonSysDiskStats[] val)
Sets the value of 'diskStats'

Field Description

Holds disk related stats.

Parameters:
val - The value to set.

setDiskStatsFrom

void setDiskStatsFrom(XIterator<SrvMonSysDiskStats> val)
Sets the value of 'diskStats' using the values from the provided iterator.

This method will call XIterator.toFirst() before and after setting the values, meaning that all values from the iterator will be set and the iterator will be reset on return.

This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'diskStats' accessor can copy the values without iteration.

Field Description

Holds disk related stats.

NOTE:
Passing a null or empty list has the same affect as calling setDiskStats(SrvMonSysDiskStats[]) with a value of null.

Parameters:
val - the values to set.

lendDiskStatsFrom

void lendDiskStatsFrom(XIterator<SrvMonSysDiskStats> val)
Sets the value of 'diskStats' by lending the values from the provided iterator.

This method will call XIterator.toFirst() before and after setting the values, meaning that all values from the iterator will be set and the iterator will be reset on return.

This method will acquire references to each non null value in the provided iterator making it suitable for cases where the values come from another message that may be disposed.

This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'diskStats' accessor can copy the values without iteration.

Field Description

Holds disk related stats.

NOTE:
Passing a null or empty list has the same affect as calling setDiskStats(SrvMonSysDiskStats[]) with a value of null.

Parameters:
val - the values to set.

addDiskStats

void addDiskStats(SrvMonSysDiskStats val)
Adds the provided value to the list of 'diskStats' values.

This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'diskStats' accessor can copy the values without iteration.

For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.

Field Description

Holds disk related stats.

Parameters:
val - the value to add.

lendDiskStats

void lendDiskStats(SrvMonSysDiskStats val)
Adds the provided value to the list of 'diskStats' values and acquires a reference to it.

Lending of an added value is useful in cases where a field is being added from a source message to provide dispose of the source value when the source message is disposed.

This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'diskStats' accessor can copy the values without iteration.

For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.

Field Description

Holds disk related stats.

Parameters:
val - the value to add.

getDiskStatsIterator

XIterator<SrvMonSysDiskStats> getDiskStatsIterator()
Gets the value of 'diskStats' as iterator of values.

This method will always return a non null iterator value. The returned iterator is not threadsafe, and the caller may not hold on to it beyond the pooling lifespan of this object. Depending on the implementation, the same iterator instance may be returned by this object on each call to avoid garbage. Each time this method is called the iterator is reset by calling its toFirst() method. Callers should therefore be especially careful about calling this method while iterating on the iterator returned by this method.

The elements returned by this iterator are owned by and pooled along with this object. The caller. must call acquire() on each returned object that this object intends to keep beyond the lifespan. of this object (unless the element is lent to another object in which that object will acquire it then).

This method is zero garbage for Xbuf generated classes, and this method is optimized such that passing the returned iterator to another object's setXXX(XIterator method can perform a direct copy of the underlying values without iteration.

Field Description

Holds disk related stats.

Returns:
An iterator containing this field values.

lendDiskStats

void lendDiskStats(SrvMonSysDiskStats[] val)
Lends the value of 'diskStats'

Field Description

Holds disk related stats.

NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message. This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().

To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.

Parameters:
val - the value to 'lend' to lend.

getDiskStats

SrvMonSysDiskStats[] getDiskStats()
Gets the value of 'diskStats'

If the field is not set this method will return null.

Field Description

Holds disk related stats.

Returns:
Holds disk related stats. If the field is not set this method will return null.

getDiskStatsEmptyIfNull

SrvMonSysDiskStats[] getDiskStatsEmptyIfNull()
Gets the value of 'diskStats' or an empty array if the value is null or not set.

Field Description

Holds disk related stats.

Returns:
Holds disk related stats. or an empty array if null if not set.
See Also:
getDiskStats()

takeDiskStats

SrvMonSysDiskStats[] takeDiskStats()
Takes the value of 'diskStats'

Field Description

Holds disk related stats.

NOTE:
A nested entity reference returned by getDiskStats() is only valid until the entity is disposed i.e. the act of getting an entity does not transfer ownership of the entity to the application A message disposes of its reference to its contained entities when it is disposed itself.

An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.

Returns:
a 'taken' reference to the field or null if the field is not set.

clearDiskStats

void clearDiskStats()
Clears the value of 'diskStats'

Field Description

Holds disk related stats.

See Also:
setDiskStats(SrvMonSysDiskStats[])


Copyright © 2016 Neeve Research, LLC. All Rights Reserved.