com.ibm.as400.vaccess

Class VJavaApplicationCall

  • All Implemented Interfaces:
    KeyListener, ImageObserver, MenuContainer, Serializable, EventListener
    Deprecated. 
    Use Java Swing instead, along with the classes in package com.ibm.as400.access

    public class VJavaApplicationCall
extends JComponent
implements KeyListener

    Provides a visual interface to 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 system is not handled by this class. As in JavaApplicationCall, the Java program running on the system receives input via standard. The output text area displays output the system 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 system Java environment:

    1. 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.
    2. 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 the system 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 
      set optimize=30

    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 os400.stderr 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();
    See Also:
    Serialized Form

    • Constructor Detail

      • VJavaApplicationCall

        public VJavaApplicationCall()
        Deprecated. 
        Constructs a VJavaApplicationCall object.

      • VJavaApplicationCall

        public VJavaApplicationCall(JavaApplicationCall javaApplicationCall)
        Deprecated. 
        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.

    • Method Detail

      • addNotify

        public void addNotify()
        Deprecated. 
        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

      • addWorkingListener

        public void addWorkingListener(WorkingListener listener)
        Deprecated. 
        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
        Deprecated. 
        Stops all threads.
        Overrides:
        finalize in class Object
        Throws:
        Throwable - If an error occurs during cleanup.

      • getJavaApplicationCall

        public JavaApplicationCall getJavaApplicationCall()
        Deprecated. 
        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()
        Deprecated. 
        Returns a reference to the JTextArea object. Standard output and standard error information from the system 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 system Java program.

      • keyPressed

        public void keyPressed(KeyEvent keyEvent)
        Deprecated. 
        A key is pressed.
        Specified by:
        keyPressed in interface KeyListener
        Parameters:
        keyEvent - The key event.

      • keyReleased

        public void keyReleased(KeyEvent keyEvent)
        Deprecated. 
        The key is released.
        Specified by:
        keyReleased in interface KeyListener
        Parameters:
        keyEvent - The key event.

      • keyTyped

        public void keyTyped(KeyEvent keyEvent)
        Deprecated. 
        The key is typed.
        Specified by:
        keyTyped in interface KeyListener
        Parameters:
        keyEvent - The key event.

      • removeWorkingListener

        public void removeWorkingListener(WorkingListener listener)
        Deprecated. 
        Removes a working listener.
        Parameters:
        listener - The listener.

      • setJavaApplicationCall

        public void setJavaApplicationCall(JavaApplicationCall javaApplicationCall)
                            throws PropertyVetoException
        Deprecated. 
        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.