Data Warehouse Center Application Integration Guide

AgentSite.tag

Use this template to define an agent site:

• From which the agent accesses the data sources or target warehouses.
• On which a Data Warehouse Center program runs.

You can use one of the following agent site types:

• An agent site that is already defined in the warehouse control database.

  To use an existing agent site, replace all occurrences of the *AgentSite token with the agent site name.

• The default agent site.

  To use the default agent site, replace all occurrences of the *AgentSite token with ISV_DEFAULTAGENTSITE.

• A new agent site that you define using the AgentSite.tag template.

  To define a new agent site, specify values for the tokens in the AgentSite.tag template. Replace all occurrences of the *AgentSite token with the name of the new agent site.

Tokens

Table 14 provides information about each token in the template.

Table 14. AgentSite.tag tokens

Token	Description	Allowed values
Entity parameters
*AgentSite	The name of a new agent site, or the name of the default agent site, if the agent is not new. If you specify a new name, it must be unique within the warehouse control database. This token is required, but you can specify the default agent site, ISV_DEFAULTAGENTSITE	A text string, up to 80 bytes in length. If you do not want to create a new agent site, use ISV_DEFAULTAGENTSITE for the default agent site.
*AgentSiteContact	The name of the person or organization responsible for this agent.	A text string.
*AgentSiteDescription	The short description of the agent site. This token is optional.	A text string, up to 254 bytes in length.
*AgentSiteNotes	The long description of the agent site. This token is optional.	A text string, up to 32700 bytes in length.
*AgentSiteOSType	The type of operating system that runs on the agent site. This token is required.	One of the following values: ISV_windowsNT Windows NT(R) ISV_AIX AIX(R) ISV_os2 OS/2(R) ISV_as400 AS/400 ISV_Solaris SUN ISV_MVS MVS
*AgentSiteTCP/IPHostname	The TCP/IP host name of the agent site. This token is required.	A text string, up to 200 bytes in length.
*AgentSiteUserid	The user ID under which the agent runs. This token is required.	A text string, up to 36 bytes in length.
Relationship parameters
*CurrentCheckPointID++	An index, starting with 0, that increases each time it is substituted in a token. This token is required.	A numeric value.

Examples of values

Table 15 provides example values for each token to illustrate the kind of metadata you might provide for each token.

Table 15. Example values for AgentSite.tag tokens

Token	Example value
*AgentSite	My agent site
*AgentSiteContact	DEPT W24A
*AgentSiteDescription	This is the description of my agent site
*AgentSiteNotes	These are the notes for my agent site.
*AgentSiteOSType	ISV_Solaris
*AgentSiteTCP/IPHostname	CHI11W71.stl.ibm.com
*AgentSiteUserid	VWADMIN
*CurrentCheckPointID++	1