Skip to content

Latest commit

 

History

History
39 lines (37 loc) · 1.53 KB

plugins.md

File metadata and controls

39 lines (37 loc) · 1.53 KB
Raw

Plugins

This facility allows users to write their own plugin java modules which are able to examine and process 3270 input screens. Modifiable screen fields may be altered, the cursor may be moved and any command or function key may be pressed. Plugins can be executed automatically after each screen is displayed, on request by the user, or both.

Creation

Implement the Plugin interface or extend DefaultPlugin.

package com.bytezone.dm3270.plugins;

public interface Plugin
{
  default void activate ()
  {}
  default void deactivate ()
  {}
  default boolean doesAuto ()
  {
    return false;
  }
  default boolean doesRequest ()
  {
    return false;
  }
  default void processAuto (PluginData data)
  {}
  default void processRequest (PluginData data)
  {}
}

Linking

Use the Plugin Manager to connect the class name to a command name. The command will appear as a menu item on the Plugins menu.

Plugin Manager

Plugins

Plugins Menu

Plugins

Activation

Select the plugin from the plugins menu to activate it (plugins that are defined as Active are automatically activated). If the plugin returns true from doesRequest() then it will be assigned a command key (0-9) which will be attached to a new menu entry. This new command can be triggered by the user at any time.
Plugins

Examples

See the dm3270Plugins project for some example code.