RTI_TASK_CREDENTIALS allows for the specification of the username and password that should be used when starting up the background task processor. Normally, the currently-logged-in user's credentials are used; however, there are certain environments (such as when Single Sign On (SSO) is being used) where it is desirable/necessary to explicitly specify the username and password of a user defined in the OpenInsight application.
It is a member of the RTI_TASK_xxx programs.
call RTI_TASK_CREDENTIALS(username, password)
The routine has the following parameters:
| Parameter | Description |
|---|---|
| username | The specific username to use when starting up the background task processor |
| options | The specific password for the username |
The credentials passed in via RTI_TASK_CREDENTIALS are consumed by the subsequent RTI_TASK_STARTUP (whether RTI_TASK_STARTUP is called explicitly, or implicitly via RTI_TASK_SUBMIT). This means that you must call RTI_TASK_CREDENTIALS each time you are going to call RTI_TASK_STARTUP (or RTI_TASK_SUBMIT) - the credentials do not "persist."
See Also: RTI_TASK_SUBMIT, RTI_TASK_STARTUP, RTI_TASK_SHUTDOWN, RTI_TASKMANAGER