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.