com.ibm.as400.access
Class EnvironmentVariableList

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

All Implemented Interfaces:

java.io.Serializable

public class EnvironmentVariableList

extends java.lang.Object

implements java.io.Serializable

The EnvironmentVariableList class represents a list of OS/400 system-level environment variables.

This class can only access system-level environment variables. You must have *JOBCTL special authority to add, change, or delete system-level environment variables.

This example gets the list of environment variables as a java.util.Properties object:

    AS400 system = new AS400("mysystem");
    EnvironmentVariableList evList = new EnvironmentVariableList(system);
    Properties p = evList.getProperties();
 

This example uses an Enumeration to print the list of environment variable names and values:

    AS400 system = new AS400("mysystem");
    EnvironmentVariableList evList = new EnvironmentVariableList(system);
    Enumeration enum = evList.getEnvironmentVariables();
    while (enum.hasMoreElements())
    {
        EnvironmentVariable ev = (EnvironmentVariable)enum.nextElement();
        System.out.println(ev.getName() + "=" + ev.getValue());
    }
 

See Also:

EnvironmentVariable, Serialized Form

Constructor Summary

EnvironmentVariableList()
Constructs a EnvironmentVariableList object.

EnvironmentVariableList(AS400 system)
Constructs a EnvironmentVariableList object.

Method Summary

void	addPropertyChangeListener(java.beans.PropertyChangeListener listener) Adds a PropertyChangeListener.
java.util.Enumeration	getEnvironmentVariables() Returns an enumeration that contains an EnvironmentVariable object for each environment variable on the system.
java.util.Properties	getProperties() Returns a new Properties object which contains an entry for each environment variable in the list.
AS400	getSystem() Returns the server on which the environment variable list exists.
void	removePropertyChangeListener(java.beans.PropertyChangeListener listener) Removes a PropertyChangeListener.
void	setProperties(java.util.Properties properties) Sets the value of each environment variable defined in a Properties object.
void	setProperties(java.util.Properties properties, int stringType) Sets the value of each environment variable defined in a Properties object.
void	setSystem(AS400 system) Sets the server for the environment variable list.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EnvironmentVariableList

public EnvironmentVariableList()

Constructs a EnvironmentVariableList object.

EnvironmentVariableList

public EnvironmentVariableList(AS400 system)

Constructs a EnvironmentVariableList object.

Parameters:

system - The system.

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)

Adds a PropertyChangeListener. The specified PropertyChangeListener's propertyChange() method will be called each time the value of any bound property is changed.

Parameters:

listener - The listener object.

getEnvironmentVariables

public java.util.Enumeration getEnvironmentVariables()
                                              throws AS400SecurityException,
                                                     ErrorCompletingRequestException,
                                                     java.lang.InterruptedException,
                                                     java.io.IOException,
                                                     ObjectDoesNotExistException

Returns an enumeration that contains an EnvironmentVariable object for each environment variable on the system.

Throws:

AS400SecurityException - If a security or authority error occurs.

ErrorCompletingRequestException - If an error occurs before the request is completed.

java.lang.InterruptedException - If this thread is interrupted.

java.io.IOException - If an error occurs while communicating with the server.

ObjectDoesNotExistException - If the object does not exist on the server.

getProperties

public java.util.Properties getProperties()
                                   throws AS400SecurityException,
                                          ErrorCompletingRequestException,
                                          java.lang.InterruptedException,
                                          java.io.IOException,
                                          ObjectDoesNotExistException

Returns a new Properties object which contains an entry for each environment variable in the list.

Returns:

The new Properties object.

Throws:

AS400SecurityException - If a security or authority error occurs.

ErrorCompletingRequestException - If an error occurs before the request is completed.

java.lang.InterruptedException - If this thread is interrupted.

java.io.IOException - If an error occurs while communicating with the server.

ObjectDoesNotExistException - If the object does not exist on the server.

getSystem

public AS400 getSystem()

Returns the server on which the environment variable list exists.

Returns:

The server on which the environment variable list exists. If the server has not been set, null is returned.

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)

Removes a PropertyChangeListener.

Parameters:

listener - The listener object.

setProperties

public void setProperties(java.util.Properties properties)
                   throws AS400SecurityException,
                          ErrorCompletingRequestException,
                          java.lang.InterruptedException,
                          java.io.IOException,
                          ObjectDoesNotExistException

Sets the value of each environment variable defined in a Properties object.

Parameters:

properties - The Properties object.

Throws:

AS400SecurityException - If a security or authority error occurs.

ErrorCompletingRequestException - If an error occurs before the request is completed.

java.lang.InterruptedException - If this thread is interrupted.

java.io.IOException - If an error occurs while communicating with the server.

ObjectDoesNotExistException - If the object does not exist on the server.

setProperties

public void setProperties(java.util.Properties properties,
                          int stringType)
                   throws AS400SecurityException,
                          ErrorCompletingRequestException,
                          java.lang.InterruptedException,
                          java.io.IOException,
                          ObjectDoesNotExistException

Sets the value of each environment variable defined in a Properties object.

Parameters:

properties - The Properties object.

stringType - The environment variable bidi string type, as defined by the CDRA (Character Data Representataion Architecture). See BidiStringType for more information and valid values.

Throws:

AS400SecurityException - If a security or authority error occurs.

ErrorCompletingRequestException - If an error occurs before the request is completed.

java.lang.InterruptedException - If this thread is interrupted.

java.io.IOException - If an error occurs while communicating with the server.

ObjectDoesNotExistException - If the object does not exist on the server.

setSystem

public void setSystem(AS400 system)

Sets the server for the environment variable list. The server cannot be changed once a connection is made to the server.

Parameters:

system - The server on which the environment variable list exists.