login Action (Oracle Waveset 8.1.1 Resources Reference)

Oracle Waveset 8.1.1 Resources Reference

login Action

The login action negotiates an authenticated session with the host required to manage users in the custom host application. This action must be defined.

Context

The actionContext map will contain the following entries:

Key	Value Type	Value Description
`hostAccess`	com.waveset.adapter.HostAccess	Provides 3270 emulation access to a mainframe.
`action`	java.lang.String	The string `login`.
`user`	java.lang.String	User name of the host application admin user.
`password`	com.waveset.util.EncryptedData	Encrypted object that stores the password of the host application admin user. Use `decryptToString()` to convert to plain text.
`errors`	java.util.List	This is initially an empty list. The script must add java.lang.String objects to this list if any errors are found during processing.
`trace`	com.waveset.adapter.Trace	An object used to trace execution. Scripts can use methods of this class to make itself “debuggable” in a customer environment.

Error Handling

If any application-specific errors are found in a screen or response, the script should add appropriate strings to the errors key. Determining that an error has occurred may require a string search for various known error strings.

The presence of any items in the errors List is considered a login failure. Additionally, any throw from within the script is considered a login failure.