All Packages Class Hierarchy This Package Previous Next Index
Class com.ibm.as400.vaccess.VJavaApplicationCall
java.lang.Object
|
+----java.awt.Component
|
+----java.awt.Container
|
+----javax.swing.JComponent
|
+----com.ibm.as400.vaccess.VJavaApplicationCall
- public class VJavaApplicationCall
- extends JComponent
- implements KeyListener
The VJavaApplicationCall class provides a visual interface to
com.ibm.as400.access.JavaApplicationCall. The visual interface
consists of two components: an input field where the program
to run is specified and input is sent to the program, and
an output text area where the output from the program is displayed.
GUI output generated by the Java program running on the AS/400
is not handled by this class.
As in JavaApplicationCall, the Java program running on the AS/400
receives input via standard. The output text area displays output
the AS/400 java program writes to standard out and standard error.
GUI input/output must be handled via another mechanism such as
Remote AWT.
There are two ways to set up the AS/400 Java environment:
- VJavaApplicationCall
must have a JavaApplicationCall object. After creating the JavaApplicationCall
object, the application can set environment parameters on the JavaApplicationCall,
object, then construct
the VJavaApplicationCall object passing it the JavaApplicationCall object.
The advantage to this method is the application sets up the environment instead
of the user.
-
The environment can be set up via
set commands entered in the GUI.
For additional information on these commands,
see the on-line help for the Java command. Valid commands are:
- Classpath - the value of the CLASSPATH environment variable. Directories are separated by colons.
- DefaultPort - the default port for communicating standard in, standard out and standard error between the client and AS/400 java environment.
- FindPort - indicates if the client should search for a free port if the default port is in use.
- Interpret - indicates if all Java class files should be run interpretively.
- Optimize - the optimization level for classes not yet optimized.
- Options - additional options used when running the Java class.
- SecurityCheckLevel - the level of warnings given for directories in the CLASSPATH that have public write authority.
- GarbageCollectionFrequency - the relative frequency that garbage collection runs.
- GarbageCollectionInitialSize - the initial size, in kilobytes, of the garbage collection heap.
- GarbageCollectionMaximumSize - the maximum size, in kilobytes, that the garbage collection heap can grow to.
- GarbageCollectionPriority - the priority of the tasks running garbage collection.
For example, to send the optimization level to 30, enter
You start the Java application using the java command. The
syntax for this command is much like the syntax when running the command
on the client. It is
java [-classpath=value] [-verbose] [-Dproperty=value -Dproperty=value [...]] class [parm1 parm2 [...]]]
Note, this class correctly sets the standard in, standard out and standard
error properties so os400.stdin, os400.stdout
or os400stderr properties are ignored.
For example, to run Java application
java -classpath=/myClasses:/myClasses/lib/package.jar myProgram parm1 parm2
To use this class you simply create a frame to contain the class
then call the load() method to run the start the application. For example,
AS400 system = new AS400("myAS400");
JavaApplicationCall javaCall = new JavaApplicationCall(system);
VJavaApplicationCall vJavaCall = new VJavaApplicationCall(javaCall);
JFrame f = new JFrame ("JavaApplicationCallExample");
f.getContentPane().setLayout(new BorderLayout ());
f.getContentPane().add("Center", vJavaCall);
f.pack();
f.show();
-
VJavaApplicationCall()
- Constructs a VJavaApplicationCall object.
-
VJavaApplicationCall(JavaApplicationCall)
- Constructs a VJavaApplicationCall object.
-
addErrorListener(ErrorListener)
- Adds a listener to be notified when an error occurs.
-
addNotify()
- Notification to VJavaApplicationCall that it now has a parent component.
-
addPropertyChangeListener(PropertyChangeListener)
- Adds a listener to be notified when the value of any bound property
changes.
-
addVetoableChangeListener(VetoableChangeListener)
- Adds a listener to be notified when the value of any constrained
property changes.
-
addWorkingListener(WorkingListener)
- Adds a listener to be notified when work starts and stops on potentially long running operations.
-
finalize()
- Stops all threads.
-
getJavaApplicationCall()
- Returns the access class which defines the Java application to run.
-
getOutputText()
- Returns a reference to the JTextArea object.
-
keyPressed(KeyEvent)
- A key is pressed.
-
keyReleased(KeyEvent)
- The key is released.
-
keyTyped(KeyEvent)
- The key is typed.
-
removeErrorListener(ErrorListener)
- Removes an error listener.
-
removePropertyChangeListener(PropertyChangeListener)
- Removes a property change listener.
-
removeVetoableChangeListener(VetoableChangeListener)
- Removes a vetoable change listener.
-
removeWorkingListener(WorkingListener)
- Removes a working listener.
-
setJavaApplicationCall(JavaApplicationCall)
- Sets the JavaApplicationCall object.
VJavaApplicationCall
public VJavaApplicationCall()
- Constructs a VJavaApplicationCall object.
VJavaApplicationCall
public VJavaApplicationCall(JavaApplicationCall javaApplicationCall)
- Constructs a VJavaApplicationCall object. A JavaApplicationCall
object defines the Java program to run.
- Parameters:
- javaApplicationCall - The access class which defines the
Java application to run.
addErrorListener
public void addErrorListener(ErrorListener listener)
- Adds a listener to be notified when an error occurs.
- Parameters:
- listener - The listener.
- See Also:
- removeErrorListener
addNotify
public void addNotify()
- Notification to VJavaApplicationCall that it now has a parent component.
The windowing system calls this method
when VJavaApplicationCall gets a parent frame. When called
VJavaApplicationCall
requsts input focus be given to the input field.
Since this method is
called by Swing at the appropriate time, application code should not
call this method.
- Overrides:
- addNotify in class JComponent
addPropertyChangeListener
public void addPropertyChangeListener(PropertyChangeListener listener)
- Adds a listener to be notified when the value of any bound property
changes.
- Parameters:
- listener - The listener.
- Overrides:
- addPropertyChangeListener in class JComponent
- See Also:
- removePropertyChangeListener
addVetoableChangeListener
public void addVetoableChangeListener(VetoableChangeListener listener)
- Adds a listener to be notified when the value of any constrained
property changes.
- Parameters:
- listener - The listener.
- Overrides:
- addVetoableChangeListener in class JComponent
- See Also:
- removeVetoableChangeListener
addWorkingListener
public void addWorkingListener(WorkingListener listener)
- Adds a listener to be notified when work starts and stops on potentially long running operations.
- Parameters:
- listener - The listener.
finalize
protected void finalize() throws Throwable
- Stops all threads.
- Throws: Throwable
- If an error occurs during cleanup.
- Overrides:
- finalize in class Object
getJavaApplicationCall
public JavaApplicationCall getJavaApplicationCall()
- Returns the access class which defines the Java application to run.
- Returns:
- The the com.ibm.as400.access.JavaApplicationCall object
which defines the Java application to run.
getOutputText
public JTextArea getOutputText()
- Returns a reference to the JTextArea object. Standard output and
standard error information from the AS/400 Java program are displayed
in this text area. The
application can use the reference to the JTextArea to modify
attributes such as the size of the text area
or the font used to display text in the text area.
- Returns:
- The JTextArea object which displays standard output
and standard error from the AS/400 Java program.
keyPressed
public void keyPressed(KeyEvent keyEvent)
- A key is pressed.
- Parameters:
- keyEvent - The key event.
keyReleased
public void keyReleased(KeyEvent keyEvent)
- The key is released.
- Parameters:
- keyEvent - The key event.
keyTyped
public void keyTyped(KeyEvent keyEvent)
- The key is typed.
- Parameters:
- keyEvent - The key event.
removeErrorListener
public void removeErrorListener(ErrorListener listener)
- Removes an error listener.
- Parameters:
- listener - The listener.
- See Also:
- addErrorListener
removePropertyChangeListener
public void removePropertyChangeListener(PropertyChangeListener listener)
- Removes a property change listener.
- Parameters:
- listener - The listener.
- Overrides:
- removePropertyChangeListener in class JComponent
- See Also:
- addPropertyChangeListener
removeVetoableChangeListener
public void removeVetoableChangeListener(VetoableChangeListener listener)
- Removes a vetoable change listener.
- Parameters:
- listener - The listener.
- Overrides:
- removeVetoableChangeListener in class JComponent
- See Also:
- addVetoableChangeListener
removeWorkingListener
public void removeWorkingListener(WorkingListener listener)
- Removes a working listener.
- Parameters:
- listener - The listener.
setJavaApplicationCall
public void setJavaApplicationCall(JavaApplicationCall javaApplicationCall) throws PropertyVetoException
- Sets the JavaApplicationCall object.
- Parameters:
- javaApplicationCall - A com.ibm.as400.access.JavaApplicationCall
object which defines the Java application to call.
- Throws: PropertyVetoException
- If the change is voted.
All Packages Class Hierarchy This Package Previous Next Index