All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.ibm.as400.access.SystemPool

java.lang.Object
   |
   +----com.ibm.as400.access.SystemPool

public class SystemPool
extends Object
The SystemPool class represents a system pool on an AS/400. It provides facilities for retrieving and changing system pool information. Here is a example:

  try {
      // Creates AS400 object.
      AS400 as400 = new AS400("systemName");
      // Constructs a SystemPool object 
      SystemPool systemPool = new SystemPool(as400,"*SPOOL");
      // Gets system pool attributes.
      System.out.println("Paging option : "+systemPool.getPagingOption());
  } catch (Exception e)
  {
      System.out.println("error : "+e)
  }
 


Variable Index

 o CALCULATE
Constant used to indicate that the AS/400 should calculate a system pool attribute.
 o CALCULATE_INT

Constructor Index

 o SystemPool()
Constructs a SystemPool object.
 o SystemPool(AS400, String)
Constructs a SystemPool object.

Method Index

 o addPropertyChangeListener(PropertyChangeListener)
Adds a listener to be notified when the value of any bound property changes.
 o addVetoableChangeListener(VetoableChangeListener)
Adds a listener to be notified when the value of any constrained property changes.
 o commitCache()
Commits any cached system pool information changes to the AS/400.
 o getActiveToIneligible()
Returns the rate, in transitions per minute, of transitions of threads from an active condition to an ineligible condition.
 o getActiveToWait()
Returns the rate, in transitions per minute, of transitions of threads from an active condition to a waiting condition.
 o getDatabaseFaults()
Returns the rate, shown in page faults per second, of database page faults against pages containing either database data or access paths.
 o getDatabasePages()
Returns the rate, in pages per second, at which database pages are brought into the storage pool.
 o getDescription()
Returns the description of the system pool.
 o getMaximumActiveThreads()
Returns the maximum number of threads that can be active in the pool at any one time.
 o getNonDatabaseFaults()
Returns the rate, in page faults per second, of nondatabase page faults against pages other than those designated as database pages.
 o getNonDatabasePages()
Returns the rate, in page per second, at which non-database pages are brought into the storage pool.
 o getPagingOption()
Returns the value indicating whether the system will dynamically adjust the paging characteristics of the storage pool for optimum performance.
 o getPoolIdentifier()
Returns the pool identifier.
 o getPoolName()
Returns the name of this storage pool.
 o getPoolSize()
Returns the amount of main storage, in kilobytes, in the pool.
 o getReservedSize()
Returns the amount of storage, in kilobytes, in the pool reserved for system use (for example, for save and restore operations).
 o getSubsystemName()
Returns the subsystem with which this storage pool is associated.
 o getSystem()
Returns the AS/400 system.
 o getWaitToIneligible()
Returns the rate, in transitions per minute, of transitions of threads from a waiting condition to an ineligible condition.
 o isCaching()
Returns the current cache status.
 o loadInformation()
Loads the system pool information.
 o refreshCache()
 o removePropertyChangeListener(PropertyChangeListener)
Removes a property change listener.
 o removeVetoableChangeListener(VetoableChangeListener)
Removes a vetoable change listener.
 o setCaching(boolean)
Turns caching on or off.
 o setFaults(float, float, float)
Sets the minimum faults-per-second guideline,the faults per second for each active thread, and the maximum faults-per-second guideline for this storage pool.
 o setMaximumFaults(float)
Sets the maximum faults-per-second guideline to use for this storage pool.
 o setMaximumPoolSize(float)
Sets the maximum amount of storage to allocate to this storage pool (as a percentage of total main storage).
 o setMessageLogging(boolean)
Sets the value indicating whether messages reporting that a change was made are written to the current job's job log and to the QHST message log.
 o setMinAndMaxPoolSize(float, float)
Sets the minimum and maximum amount of storage to allocate to this storage pool (as a percentage of total main storage).
 o setMinimumFaults(float)
Sets the minimum faults-per-second guideline to use for this storage pool.
 o setMinimumPoolSize(float)
Sets the minimum amount of storage to allocate to this storage pool (as a percentage of total main storage).
 o setPagingOption(String)
Sets the value indicating whether the system dynamically adjust the paging characteristics of the storage pool for optimum performance.
 o setPerThreadFaults(float)
Sets the faults per second for each active thread in this storage pool.
 o setPoolActivityLevel(int)
Sets the activity level for the pool.
 o setPoolName(String)
Sets the system pool name.
 o setPoolSize(int)
Sets the size of the system pool in kilobytes, where one kilobyte is 1024 bytes.
 o setPriority(int)
Sets the priority of this pool relative the priority of the other storage pools.
 o setSystem(AS400)
Sets the AS/400 system.
 o toString()
Return the pool name.

Variables

 o CALCULATE
 public static final float CALCULATE
Constant used to indicate that the AS/400 should calculate a system pool attribute.

 o CALCULATE_INT
 public static final int CALCULATE_INT

Constructors

 o SystemPool
 public SystemPool()
Constructs a SystemPool object.

 o SystemPool
 public SystemPool(AS400 system,
                   String poolName)
Constructs a SystemPool object.

Parameters:
system - The AS/400 system.
poolName - The name of the system pool.

Methods

 o addPropertyChangeListener
 public void addPropertyChangeListener(PropertyChangeListener listener)
Adds a listener to be notified when the value of any bound property changes.

Parameters:
listener - The listener.
 o addVetoableChangeListener
 public void addVetoableChangeListener(VetoableChangeListener listener)
Adds a listener to be notified when the value of any constrained property changes.

Parameters:
listener - The listener.
 o commitCache
 public synchronized void commitCache() throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Commits any cached system pool information changes to the AS/400. If caching is not enabled, this method does nothing.

Throws: AS400Exception
If the AS/400 system returns an error message.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ConnectionDroppedException
If the connection is dropped unexpectedly.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
See Also:
isCaching, refreshCache, setCaching
 o getActiveToIneligible
 public float getActiveToIneligible() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the rate, in transitions per minute, of transitions of threads from an active condition to an ineligible condition.

Returns:
The rate.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getActiveToWait
 public float getActiveToWait() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the rate, in transitions per minute, of transitions of threads from an active condition to a waiting condition.

Returns:
The rate.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getDatabaseFaults
 public float getDatabaseFaults() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the rate, shown in page faults per second, of database page faults against pages containing either database data or access paths. A page fault is a program notification that occurs when a page that is marked as not in main storage is referred to be an active program. An access path is the means by which the system provides a logical organization to the data in a database file.

Returns:
The rate.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getDatabasePages
 public float getDatabasePages() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the rate, in pages per second, at which database pages are brought into the storage pool.

Returns:
The rate.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getDescription
 public String getDescription()
Returns the description of the system pool.

Returns:
The description of the system pool.
 o getMaximumActiveThreads
 public int getMaximumActiveThreads() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the maximum number of threads that can be active in the pool at any one time.

Returns:
The maximum number of threads.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getNonDatabaseFaults
 public float getNonDatabaseFaults() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the rate, in page faults per second, of nondatabase page faults against pages other than those designated as database pages.

Returns:
The rate.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getNonDatabasePages
 public float getNonDatabasePages() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the rate, in page per second, at which non-database pages are brought into the storage pool.

Returns:
The rate.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getPagingOption
 public String getPagingOption() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the value indicating whether the system will dynamically adjust the paging characteristics of the storage pool for optimum performance. The following special values may be returned. *FIXED: The system does not dynamically adjust the paging characteristics. *CALC: The system dynamically adjusts the paging characteristics. USRDFN: The system does not dynamically adjust the paging characteristics for the storage pool but uses values that have been defined through an API.

Returns:
The value indicating whether the system will dynamically adjust the paging characteristics of the storage pool for optimum performance.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getPoolIdentifier
 public int getPoolIdentifier() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
Returns the pool identifier.

Returns:
The pool identifier.
Throws: AS400SecurityException
If a security or authority error occurs.
Throws: ErrorCompletingRequestException
If an error occurs before the request is completed.
Throws: InterruptedException
If this thread is interrupted.
Throws: IOException
If an error occurs while communicating with the AS/400.
Throws: ObjectDoesNotExistException
If the AS/400 object does not exist.
Throws: UnsupportedEncodingException
If the character encoding is not supported.
 o getPoolName
 public String getPoolName()
Returns the name of this storage pool. The name may be a number, in which case it is a private pool associated with a subsystem. The following special values may be returned:

  • *MACHINE The specified pool definition is defined to be the machine pool.
  • *BASE The specified pool definition is defined to be the base system pool, which can be shared with other subsystems.
  • *INTERACT The specified pool definition is defined to be shared pool used for interactive work.
  • *SPOOL The specified pool definition is defined to be the shared pool used for spooled writers.
  • *SHRPOOL1 - *SHRPOOL10 The specified pool definition is defined to be a shared pool. For v4r3, this is *SHRPOOL60.

    Returns:
    The pool name.
  •  o getPoolSize
     public int getPoolSize() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
    
    Returns the amount of main storage, in kilobytes, in the pool.

    Returns:
    The pool size.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o getReservedSize
     public int getReservedSize() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
    
    Returns the amount of storage, in kilobytes, in the pool reserved for system use (for example, for save and restore operations). The system calculates this amount by using storage pool sizes and activity levels.

    Returns:
    The reserved size.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o getSubsystemName
     public String getSubsystemName() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
    
    Returns the subsystem with which this storage pool is associated. The field will be blank for shared pools.

    Returns:
    The subsystem name.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o getSystem
     public AS400 getSystem()
    
    Returns the AS/400 system.

    Returns:
    The AS/400 system.
     o getWaitToIneligible
     public float getWaitToIneligible() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
    
    Returns the rate, in transitions per minute, of transitions of threads from a waiting condition to an ineligible condition.

    Returns:
    The rate.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o isCaching
     public boolean isCaching()
    
    Returns the current cache status. The default behavior is no caching.

    Returns:
    true if caching is enabled, false otherwise.
    See Also:
    commitCache, refreshCache, setCaching
     o loadInformation
     public void loadInformation() throws AS400SecurityException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, UnsupportedEncodingException
    
    Loads the system pool information. The AS/400 system and the system pool name should be set before this method is invoked. Note: This method is equivalent to the refreshCache() method.

    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o refreshCache
     public synchronized void refreshCache()
    
     o removePropertyChangeListener
     public void removePropertyChangeListener(PropertyChangeListener listener)
    
    Removes a property change listener.

    Parameters:
    listener - The listener.
     o removeVetoableChangeListener
     public void removeVetoableChangeListener(VetoableChangeListener listener)
    
    Removes a vetoable change listener.

    Parameters:
    listener - The listener.
     o setCaching
     public synchronized void setCaching(boolean cache)
    
    Turns caching on or off. If caching is turned off, the next get() or set() will go to the system.

    Parameters:
    cache - true if caching should be used when getting and setting information to and from the AS/400; false if every get or set should communicate with the AS/400 immediately. Any cached changes that are not committed when caching is turned off will be lost. The default behavior is no caching.
    See Also:
    commitCache, isCaching, refreshCache
     o setFaults
     public void setFaults(float minValue,
                           float perValue,
                           float maxValue) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the minimum faults-per-second guideline,the faults per second for each active thread, and the maximum faults-per-second guideline for this storage pool. The sum of mimimum faults and per-thread faults must be less than the value of the maximum faults parameter. Each value is used by the system if the performance adjustment (QPFRADJ) system value is set to 2 or 3. If you want the system to calculate the priority, you must specify SystemPool.CALCULATE for each parameter.

    Parameters:
    minValue - The new minimum faults-per-second guideline.
    perValue - The new faults per second for each active thread.
    maxValue - The new maximum faults-per-second guideline.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setMaximumFaults
     public void setMaximumFaults(float value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the maximum faults-per-second guideline to use for this storage pool. The sum of mimimum faults and per-thread faults must be less than the value of the maximum faults parameter. This value is used by the system if the performance adjustment (QPFRADJ) system value is set to 2 or 3. If you want the system to calculate the priority, you must specify SystemPool.CALCULATE for this parameter.

    Parameters:
    value - The new maximum faults-per-second guideline.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setMaximumPoolSize
     public void setMaximumPoolSize(float value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the maximum amount of storage to allocate to this storage pool (as a percentage of total main storage). This value cannot be less than the minimum pool size % parameter value. This value is used by the system if the performance adjustment (QPFRADJ) system value is set to 2 or 3. If you want the system to calculate the priority, you must specify SystemPool.CALCULATE for this parameter.

    Parameters:
    value - The new maximum pool size.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setMessageLogging
     public void setMessageLogging(boolean log) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the value indicating whether messages reporting that a change was made are written to the current job's job log and to the QHST message log. This affects the logging of change-related messages only; it does not affect the logging of error messages. Valid values are:

  • true - Log change messages.
  • false - Do not log change messages.

    The default value for messages logging is true.

    Parameters:
    value - The value indicating whether messages reporting that a change was made are written to the current job's job log and to the QHST message log.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
  •  o setMinimumFaults
     public void setMinimumFaults(float value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the minimum faults-per-second guideline to use for this storage pool. This value is used by the system if the performance adjustment (QPFRADJ) system value is set to 2 or 3. If you want the system to calculate the priority, you must specify -2 for this parameter. If you do not want this value to change, you may specify -1 for this parameter.

    Parameters:
    value - The new minumum faults-per-second guideline.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setMinAndMaxPoolSize
     public void setMinAndMaxPoolSize(float minValue,
                                      float maxValue) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the minimum and maximum amount of storage to allocate to this storage pool (as a percentage of total main storage). Maximum value cannot be less than the minimum pool size % parameter value. Each value is used by the system if the performance adjustment (QPFRADJ) system value is set to 2 or 3. If you want the system to calculate the priority, you must specify SystemPool.CALCULATE for each parameter.

    Parameters:
    minValue - The new minimum pool size.
    maxValue - The new maximum pool size.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setMinimumPoolSize
     public void setMinimumPoolSize(float value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the minimum amount of storage to allocate to this storage pool (as a percentage of total main storage). This value cannot be greater than the maximum pool size % parameter value. This value is used by the system if the performance adjustment (QPFRADJ) system value is set to 2 or 3. If you want the system to calculate the priority, you must specify SystemPool.CALCULATE for this parameter.

    Parameters:
    value - The new minimum pool size.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setPagingOption
     public void setPagingOption(String value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the value indicating whether the system dynamically adjust the paging characteristics of the storage pool for optimum performance. Valid values are:

  • *SAME - The paging option for the storage pool is not changed.
  • *FIXED - The system will not dynamically adjust the paging characteristics; system default values are used.
  • *CALC - The system will dynamically adjust the paging characteristics.

    Parameters:
    value - The value indicating whether the system dynamically adjust the paging characteristics of the sorage pool for optimum performance.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
  •  o setPerThreadFaults
     public void setPerThreadFaults(float value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the faults per second for each active thread in this storage pool. Each job is comprised of one or more threads. The system multiples this number by the number of active threads that it finds in the pool. This result is added to the minimum faults parameter to calculate the faults-per-second guideline to use for this pool. This value is used by the system if the performance adjustment (QPFRADJ) system value is set to 2 or 3. If you want the system to calculate the priority, you must specify SystemPool.CALCULATE for this parameter.

    Parameters:
    value - The new faults.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setPoolActivityLevel
     public void setPoolActivityLevel(int value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the activity level for the pool. The activity level of the machine pool can not be changed.

    Parameters:
    value - The new activity level for the pool.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setPoolName
     public void setPoolName(String poolName) throws PropertyVetoException
    
    Sets the system pool name.

    Parameters:
    poolName - The name of the system pool.
    Throws: PropertyVetoException
    If the change is vetoed.
     o setPoolSize
     public void setPoolSize(int value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the size of the system pool in kilobytes, where one kilobyte is 1024 bytes. The minimum value is 32 kilobytes. For V4R3 and later, the minimum is 256.

    Parameters:
    value - The new size of the system pool.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setPriority
     public void setPriority(int value) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the priority of this pool relative the priority of the other storage pools. Valid values are 1 through 14. The priority for the *MACHINE pool must be 1. This value is used by the system if the performance adjustment (QPFRADJ) system value is set to 2 or 3. If you want the system to calculate the priority, you must specify SystemPool.CALCULATE_INT for this parameter.

    Parameters:
    value - The new priority.
    Throws: AS400Exception
    If the AS/400 system returns an error message.
    Throws: AS400SecurityException
    If a security or authority error occurs.
    Throws: ConnectionDroppedException
    If the connection is dropped unexpectedly.
    Throws: ErrorCompletingRequestException
    If an error occurs before the request is completed.
    Throws: InterruptedException
    If this thread is interrupted.
    Throws: IOException
    If an error occurs while communicating with the AS/400.
    Throws: ObjectDoesNotExistException
    If the AS/400 object does not exist.
    Throws: PropertyVetoException
    If the change is vetoed.
    Throws: UnsupportedEncodingException
    If the character encoding is not supported.
     o setSystem
     public void setSystem(AS400 system) throws PropertyVetoException
    
    Sets the AS/400 system.

    Parameters:
    system - The AS/400 system.
    Throws: PropertyVetoException
    If the change is vetoed.
     o toString
     public String toString()
    
    Return the pool name.

    Returns:
    The pool name.
    Overrides:
    toString in class Object

    All Packages  Class Hierarchy  This Package  Previous  Next  Index