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)
  }
 


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 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 loadInformation()
Loads the system pool information.
 o removePropertyChangeListener(PropertyChangeListener)
Removes a property change listener.
 o removeVetoableChangeListener(VetoableChangeListener)
Removes a vetoable change listener.
 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 setMultipleChanges(Vector)
Sets the multiple changes to the system pool.
 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.
 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.

Constructors

 o SystemPool
 public SystemPool()
Constructs a SystemPool object.

 o SystemPool
 public SystemPool(AS400 system,
                   String poolName) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
Constructs a SystemPool object.

Parameters:
system - The AS/400 system.
poolName - The name 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.

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 getActiveToIneligible
 public float getActiveToIneligible()
Returns the rate, in transitions per minute, of transitions of threads from an active condition to an ineligible condition.

Returns:
The rate.
 o getActiveToWait
 public float getActiveToWait()
Returns the rate, in transitions per minute, of transitions of threads from an active condition to a waiting condition.

Returns:
The rate.
 o getDatabaseFaults
 public float getDatabaseFaults()
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.
 o getDatabasePages
 public float getDatabasePages()
Returns the rate, in pages per second, at which database pages are brought into the storage pool.

Returns:
The rate.
 o getDescription
 public String getDescription()
Returns the description of the system pool.

Returns:
The description of the system pool.
 o getMaximumActiveThreads
 public int getMaximumActiveThreads()
Returns the maximum number of threads that can be active in the pool at any one time.

Returns:
The maximum number of threads.
 o getNonDatabaseFaults
 public float getNonDatabaseFaults()
Returns the rate, in page faults per second, of nondatabase page faults against pages other than those designated as database pages.

Returns:
The rate.
 o getNonDatabasePages
 public float getNonDatabasePages()
Returns the rate, in page per second, at which non-database pages are brought into the storage pool.

Returns:
The rate.
 o getPagingOption
 public String getPagingOption()
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.
 o getPoolIdentifier
 public int getPoolIdentifier()
Returns the pool identifier.

Returns:
The pool identifier.
 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()
    
    Returns the amount of main storage, in kilobytes, in the pool.

    Returns:
    The pool size.
     o getReservedSize
     public int getReservedSize()
    
    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.
     o getSubsystemName
     public String getSubsystemName()
    
    Returns the subsystem with which this storage pool is associated. The field will be blank for shared pools.

    Returns:
    The subsystem name.
     o getSystem
     public AS400 getSystem()
    
    Returns the AS/400 system.

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

    Returns:
    The rate.
     o loadInformation
     public void loadInformation() throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Loads the system pool information. The AS/400 system and the system pool name should be set before this method is invoked.

    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 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 setFaults
     public synchronized 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 -2 for each parameter. If you do not want one value to change, you may specify -1 for that 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 synchronized 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 -2 for this parameter. If you do not want this value to change, you may specify -1 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 synchronized 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 -2 for this parameter. If you do not want this value to change, you may specify -1 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 synchronized 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:

  • "Y" - Log change messages.
  • "N" - Do not log change messages.

    The default value for messages logging is "Y".

    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 synchronized 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 synchronized 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 -2 for each parameter. If you do not want each value to change, you may specify -1 for that 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 synchronized 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 -2 for this parameter. If you do not want this value to change, you may specify -1 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 setMultipleChanges
     public synchronized void setMultipleChanges(Vector newValues) throws AS400Exception, AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, InterruptedException, IOException, ObjectDoesNotExistException, PropertyVetoException, UnsupportedEncodingException
    
    Sets the multiple changes to the system pool.

    Parameters:
    newValues - The vector stores the new values for all 10 pool attributes to be set. There should be 10 elements in the vector. In the order, they represent new pool size, new pool activity level, message logging, paging option, priority, minimum pool size %, maximum pool size %, minimum faults, per-thread faults and maximum faults. If you want to set an int value , for example, 300 for the new pool size, you should put a corresponding integer value --new Integer(300) into the vector. If you want to set a float value, for example, 30.123 for the maximum pool size %, you should first time this value by 100, then new a corresponding integer object, so its input value should be new Integer((int)(30.123*100)).
    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 synchronized 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 synchronized 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 -2 for this parameter. If you do not want this value to change, you may specify -1 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 synchronized 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 synchronized 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 synchronized 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. 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 synchronized 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 -2 for this parameter. If you do not want this value to change, you may specify -1 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 synchronized 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