The update action updates a user in the host application. If the update action is not defined, then users on the host application cannot be updated.
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. |
adapter |
com.waveset.object.ScriptedHostResourceAdapter |
Adapter instance |
action |
java.lang.String |
The string update. |
id |
java.lang.String |
Account ID of the user to modify |
password |
java.lang.String |
If present, this is the new decrypted password for the user. |
attributes |
java.lang.Map |
Map of attributes to update on the existing user. The key identifies the attribute to set, and the value is the decrypted value to which the attribute should be set. |
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 an update failure. Additionally, any throw from within the script is considered an update failure.