Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 7 Operational Requirements for CA Datacom Access : Adding URT Names

Adding URT Names
You can define multiple URT names for use in a server group identified by a server ID. These URTs are loaded into memory when the server is first initialized. You can also add a new URT name to a server without recycling it.
Populating the URT Table
In the @DATACOM_URTS TDS table, parameterized by a server ID, define the URT names for use in a server associated with this server ID. Populate the table with all possible CA Datacom DBIDs.
A URT name can be associated with one or more DBIDs; all URT modules named in the table must reside in the libraries referenced in either the STEPLIB or HRNEXTR DD statement. Refer to Closing and Opening of URTs.
If you need to associate a new URT name to a server, add the new entry to the @DATACOM_URTS(serverid) table. The new entry is automatically picked up by the server, which does not require recycling.
Example TDS Table

 
EDITING TABLE :
@DATACOM_URTS (DATACOM1)
 
DBID URTNAME
------------- ----------
10 URT010
11 URT010
5000 URT5000

 
Determining the URT to Use
At startup, each server instance uses the multiple-URT method, that is, it attempts to load the URTs referred to in the @DATACOM_URTS(serverid) table. If the latter is empty, the server uses the single-URT method. When the single-URT method is activated, the server cannot use the multiple-URT method until the next session. When loading a URT, the server searches the STEPLIB concatenation of load libraries first and then the load library denoted by the HRNEXTR DD statement.
URT in the Table Definition Method
When a table is accessed that has a URT name associated with it, that URT will be loaded into the server address space and marked as open.
Example 1

 
+DATACOM1 Starting CA‑DATACOM Server DCOM001
+DATACOM1 Starting CA‑DATACOM Server DCOM001
+DATACOM1 Starting CA‑DATACOM Server DCOM001
+DATACOM1 DCOM002 URT name URT010 successfully loaded
+DATACOM1 DCOM001 URT name URT010 successfully loaded
+DATACOM1 DCOM002 URT name URT5000 successfully loaded
+DATACOM1 DCOM000 URT name URT010 successfully loaded
+DATACOM1 DCOM001 URT name URT5000 successfully loaded
+DATACOM1 DCOM000 URT name URT5000 successfully loaded
+DATACOM1 DCOM001 URT=URT010 STATUS=AVAILABLE
+DATACOM1 DCOM000 URT=URT5000 STATUS=AVAILABLE
+DATACOM1 DCOM001 URT=URT5000 STATUS=AVAILABLE
+DATACOM1 DCOM000 URT=URT010 STATUS=AVAILABLE
+DATACOM1 DCOM002 URT=URT5000 STATUS=AVAILABLE

 
At the first database call, the server loads or locates among the already loaded URTs the corresponding URT and uses the same URT for the duration of the transaction. A CA Datacom OPEN is issued and the URT is marked as open and remains open, until it is specifically closed or the server is shut down.
Example 2
The URT5000 in server USR01002 is opened.
+DATACOM1 DCOM002 URT=URT010 STATUS=AVAILABLE
+DATACOM1 DCOM002 URT=URT5000 STATUS=OPEN
+DATACOM1 DCOM001 URT=URT010 STATUS=AVAILABLE
+DATACOM1 DCOM000 URT=URT5000 STATUS=AVAILABLE
+DATACOM1 DCOM001 URT=URT5000 STATUS=AVAILABLE
Multiple-URT Method
When the server starts up, all the URT names specified in the DATACOM_URTS(serverid) table are loaded into the server address space and marked as available. This indicates that the URT is loaded and left unopened.
Single-URT Method
Look for a URT named after the server ID. If one does not exist, look for a URT named S6BDATDB.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved