com.heirloomcomputing.ecs.exec

Interface ICallableProgramGiving

All Superinterfaces:

ICallableProgram

public interface ICallableProgramGiving
extends ICallableProgram

This interface must be implemented by any Java program
which wishes to be called by a COBOL CALL statement.

Example Java:

 public class myprogram implements ICallableProgram {
  public void call();
  public void call(parameterList param);
  public void cancel();
  public String redirectCall();
   ...
 }
 

Example COBOL:

 CALL "myprogram".

 CALL "myprogram" USING VALUE-1 VALUE-2 ... VALUE-N.

 CANCEL "myprogram".

 

Note that all COBOL programs compiled with Elastic COBOL already implement the ICallableProgram interface.

See Also:

parameterList

Method Summary

Modifier and Type	Method and Description
java.lang.Object	callGiving() This is the entry point for the class when CALL'd with no parameters.
java.lang.Object	callGiving(com.heirloomcomputing.ecs.exec.parameterList param) This is the entry point for the class when CALL'd with parameters.

Methods inherited from interface com.heirloomcomputing.ecs.exec.ICallableProgram

call, call, cancel, redirectCall

Method Detail

callGiving

java.lang.Object callGiving()
                     throws java.lang.Throwable

This is the entry point for the class when CALL'd with no parameters. Do all normal processing for the CALL within this method or the next. If you require parameters, just return from this function or throw an exception.

Returns:

an Object indicating the return value of the program

Throws:

java.lang.Throwable - for any CobolException or Java Exception

callGiving

java.lang.Object callGiving(com.heirloomcomputing.ecs.exec.parameterList param)
                     throws java.lang.Throwable

This is the entry point for the class when CALL'd with parameters. Do all normal processing for the CALL within this method or the previous method. If you do not require parameters, just return from this function or throw an exception.

Parameters:

param - - a parameterList of Variables to the program

Returns:

an Object indicating the return value of the program

Throws:

java.lang.Throwable - for any CobolException or Java Exception