Class TerminalProps

    • Constructor Detail

      • TerminalProps

        public TerminalProps()
        Creates the terminal properties container without a name. The name must be set in all cases using the setPropertyAtom call.
      • TerminalProps

        public TerminalProps​(Atom propertyAtom)
        Creates the terminal properties container with the specified name. All system-reserved names for components begins with "$".
        Parameters:
        propertyAtom - the name of the component, unique within it's parent.
    • Method Detail

      • onPropDisposed

        protected void onPropDisposed()
        Called when the property is disposed of.
      • isPreStarted

        public boolean isPreStarted()
        Returns if the terminal session should be pre-started when a user session is started.
        Returns:
        The flag to prestart session or not.
      • getDescription

        public java.lang.String getDescription()
        Gets the description of the terminal session configuration.
        Returns:
        The description set, or null for none.
      • getDescription

        public boolean getDescription​(java.lang.String descr)
        Sets the description of the terminal session configuration.
        Parameters:
        descr - The description to set, or null to remove it.
        Returns:
        true for changed, false for no change.
      • getTerminalType

        public TerminalProps.Type getTerminalType()
        Gets the terminal type.
        Returns:
        The terminal type (if none is set, 3270 is default).
      • setTerminalType

        public void setTerminalType​(TerminalProps.Type type)
        Sets the terminal type.
        Parameters:
        type - The terminal type.
      • getEEMFileName

        public java.lang.String getEEMFileName()
        Gets the EEM file name.
        Returns:
        null for none (default), otherwise the file name that is relative the root of the server.
      • setEEMFileName

        public void setEEMFileName​(java.lang.String fn)
        Sets the EEM file name. The file name should be relative the root directory of the server.
        Parameters:
        fn - The EEM file name or empty string for none.
      • getCaptureFileName

        public java.lang.String getCaptureFileName()
        Gets the EE file name, used when the host session is displaying a single captured screen.
        Returns:
        File name or null for none.
      • setCaptureFileName

        public void setCaptureFileName​(java.lang.String fn)
        Sets the EE file name, used when the host session is displaying a single captured screen.
        Parameters:
        fn - The file name for EE capture.
      • isUserSmartInsertModeEnabled

        public boolean isUserSmartInsertModeEnabled()
        Checks if smart-insert mode is enabled (spaces are treated like null's at the end of the field).
        Returns:
        true if enabled (default), false otherwise.
      • setUserSmartInsertMode

        public void setUserSmartInsertMode​(boolean enabled)
        Sets the smart-insert mode (spaces are treated like null's at the end of the field).
        Parameters:
        enabled - The enabled flag.
      • isUser3270BoxDrawingEnabled

        public boolean isUser3270BoxDrawingEnabled()
        Checks if 3270 box drawing is enabled.
        Returns:
        true if enabled (default), false otherwise.
      • setUser3270BoxDrawingEnabled

        public void setUser3270BoxDrawingEnabled​(boolean enabled)
        Sets if 3270 box drawing is enabled.
        Parameters:
        enabled - The enabled flag.
      • isUserPCInsertModeEnabled

        public boolean isUserPCInsertModeEnabled()
        Checks if PC Insert mode is enabled.
        Returns:
        true if enabled (default), false otherwise.
      • setUserPCInsertModeEnabled

        public void setUserPCInsertModeEnabled​(boolean enabled)
        Sets if PC Insert mode is enabled.
        Parameters:
        enabled - The enabled flag.
      • isTypeAheadEnabled

        public boolean isTypeAheadEnabled()
        Checks if type-ahead is enabled for this session.
        Returns:
        true if enabled (default), false otherwise.
      • setTypeAheadEnabled

        public void setTypeAheadEnabled​(boolean enabled)
        Sets if type-ahead is enabled for this session.
        Parameters:
        enabled - The enabled flag.
      • isClientLocalFieldEditing

        public boolean isClientLocalFieldEditing()
        Checks if client-local field editing is enabled for this session.
        Returns:
        true if enabled (default), false otherwise.
      • setClientLocalFieldEditing

        public void setClientLocalFieldEditing​(boolean enabled)
        Sets if client-local field editing is enabled for this session.
        Parameters:
        enabled - The enabled flag.
      • isPrinterAssociated

        public boolean isPrinterAssociated()
        Checks if a 3270 printer is associated.
        Returns:
        true if associated, false (default) otherwise.
      • setPrinterAssociated

        public void setPrinterAssociated​(boolean associate)
        Sets if a 3270 printer is associated.
        Parameters:
        associate - true if associated, false otherwise.
      • getPrinterSettings

        public boolean getPrinterSettings​(TerminalPrinterSettings pojo)
        Gets the printer properties container and initializes the TerminalPrinterSettings POJO class members accordingly.
        Parameters:
        pojo - The printer properties instance.
        Returns:
        true if successfully completed the operation, i.e. the printer properties were defined in the TerminalProps.
      • setPrinterSettings

        public boolean setPrinterSettings​(TerminalPrinterSettings pojo)
        Sets the printer properties container from a TerminalPrinterSettings POJO.
        Parameters:
        pojo - The printer properties instance.
        Returns:
        true if successfully completed the operation, i.e. the printer properties were defined in the TerminalProps.
      • getKeyboardRemapper

        public KeyboardRemapper getKeyboardRemapper()
        Gets the keyboard mapper to use. This method creates a new KeyboardRemapper instance every time this method is called, so use it carefully!
        Returns:
        A new instance of the KeyboardRemapper.
      • createTerminalHost

        public TerminalHost createTerminalHost​(AppSessionGyro appGyro)
        Creates a terminal host that becomes associated with this property.
        Parameters:
        appGyro - The application gyro for the session.
        Returns:
        A new instance of the terminal session, or the previously started one.
      • getCreatedTerminalHost

        public TerminalHost getCreatedTerminalHost()
        Gets the terminal host that has been created from this property for the application session gyro instance using createTerminalHost(AppSessionGyro).
        Returns:
        The terminal host created, or null for none.