Controlling RRSAF connections

You can start or restart a Resource Recovery Services attachment facility (RRSAF) connection at any time after Resource Recovery Services (RRS) is started.

About this task

Begin general-use programming interface information.If RRSAF is not started, an IDENTIFY request fails with reason code X'00F30091'.

Application programs can use the following RRSAF functions to control connections to Db2:

IDENTIFY
Establishes the task (TCB) as a user of the named Db2 subsystem. When the first task within an address space issues a connection request, the address space is initialized as a user of Db2.
SIGNON
Provides a user ID and, optionally, one or more secondary authorization IDs that are to be associated with the connection. Invokes the sign-on exit routine. Optionally, lets a thread join a global transaction.
AUTH SIGNON
Provides a user ID, an access control environment element (ACEE), and, optionally, one or more secondary authorization IDs that are to be associated with the connection. Invokes the sign-on exit routine.
CREATE THREAD
Allocates a plan. If you provide a plan name, Db2 allocates that plan. If you provide a collection name, Db2 allocates a special plan named ?RRSAF and a package list that contains the collection name.

After CREATE THREAD completes, Db2 can execute SQL statements.

TERMINATE THREAD
Deallocates the plan.
TERMINATE IDENTIFY
Removes the task as a user of Db2. If this is the last or only task in the address space with a Db2 connection, the TERMINATE IDENTIFY command terminates the address space connection to Db2.
TRANSLATE
Returns an SQL code and printable text, in the SQLCA, that describes a Db2 error reason code.

End general-use programming interface information.