Finding and Replacing Environment Values

Use the Find and Replace page to search for environment values that differ between domains. Environment values are certain predefined fields in the configuration data whose values are very likely to change when you move your configuration from one domain to another (for example, from test to production). Environment values represent entities such as URLs, URIs, file and directory names, server names, e-mails, and such. Also, environment values can be found in alert destinations, proxy services, business services, SMTP Server and JNDI Provider resources, and UDDI Registry entries.

This page behaves differently based on whether or not you are in a session. If you are in a session, you can find and replace environment values. However, if you are outside a session, you can find environment values only; Replace All is disabled.

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Select System Administration > Find & Replace.
  3. In the Find Value field, enter the environment value that you want to locate.
  4. To display a list of environment values in your configuration that contain the value you entered, click Find.
  5. A list of relevant values is displayed, which includes the Owner, Type, and the Environment Value columns.

  6. To locate only items changed in your current session, select the Only Items Changed In Current Session check box.
  7. Select the variable type for which to search, from the Find in Variable Type drop-down list, described in Table 29-1.
  8. Table 29-1 Variable Types 
    Variable Type
    Found In
    Description
    All Types
       
    Alert SNMP Trap
    Alert Destination
    SNMP trap (enable or disable) for an alert destination.
    Alert To Reporting Data
    Alert Destination
    Alert to reporting data (enable or disable) for an alert destination.
    Email Archive Directory
    E-mail proxy
    Archive directory for an e-mail proxy service.
    Email Destination URI
    Alert Destination
    URI in an e-mail alert destination.
    Email Download Directory
    E-mail proxy
    Download directory for an e-mail proxy service.
    Email Error Directory
    E-mail proxy
    Error directory for an e-mail proxy service.
    File Archive Directory
    File proxy
    Archive directory for a file proxy service.
    File Error Directory
    File proxy
    Error directory for a file proxy service.
    File Stage Directory
    File proxy
    Stage directory for a file proxy service.
    FTP Archive Directory
    FTP proxy
    Archive directory for an FTP proxy service.
    FTP Download Directory
    FTP proxy
    Download directory for an FTP proxy service.
    FTP Error Directory
    FTP proxy
    Error directory for an FTP proxy service.
    IMAP Move Folder
    E-mail proxy
    IMAP Move directory for an e-mail proxy service.
    JMS Alert Destination URI
    Alert Destination
    URI in a JMS alert destination.
    JMS Managed Server
    JMS business service
    Managed Server entry in the table of Managed Server vs destination of a JMS business service with a response correlation pattern as Message ID pattern.
    JMS Queue Connection Factory
    JMS proxy or business service
    A response queue connection factory of a JMS proxy or business service with the response correlation pattern as Message ID.
    JMS Response Destination
    JMS business service
    Destination entry in the table of Managed Server vs destination of a JMS business service with a response correlation pattern as Message ID pattern.
    JMS Response URI
    JMS proxy or business service
    The URI of the response queue for JMS proxy or business services using response correlation pattern of JMS Correlation ID.
    JNDI Provider URL
    JNDI Provider
    JNDI Provider URLs.
    Managed Server for Polling
    E-mail, File, FTP, or SFTP proxy service in a clustered domain
    Managed Server for polling in a clustered domain.
    MQ Connection Pool Size
    MQ Connection Resource
    The size of the MQ connection pool.
    MQ Connection Timeout
    MQ Connection Resource
    The time interval after which unused connections are destroyed.
    MQ Host Name
    MQ Connection Resource
    The host name of the MQ queue manager.
    MQ Port Number
    MQ Connection Resource
    The port number of the MQ queue manager listener.
    MQ Manager Channel Name
    MQ Connection Resource
    The queue manager server connection channel name.
    MQ Queue Manager Name
    MQ Connection Resource
    The name of the MQ queue manager.
    MQ Response URI
    MQ proxy and business service
    Proxy or business service URI.
    Secure Connections to JMS Server
    JMS proxy or business service
    If true, ALSB connects to the JMS server and JNDI tree using SSL (t3s); otherwise, connections occur over a clear text (t3) channel.
    Service Retry Count
    Business service
    The number of times endpoint URIs are retried; in other words, the number of failover attempts.
    Service Retry Iteration Interval
    Business service
    The length of time that a business service waits before iterating over the entire set of URIs again.
    Service URI
    Proxy or business service
    Proxy or business service URI.
    Service URI Weight
    Business service
    The individual weights assigned to business service URIs.
    SFTP Archive Directory
    SFTP proxy
    Archive directory for a SFTP proxy service. If direct-streaming is on, the archive directory is present on the remote SFTP server; otherwise, it is present locally.
    SFTP Download Directory
    SFTP proxy
    Download directory for a SFTP proxy service.
    SFTP Error Directory
    SFTP proxy
    Error directory for a SFTP proxy service. If direct-streaming is on, the error directory is present on the remote SFTP server; otherwise, it is present locally.
    SMTP Server URL
    SMTP Server
    SMTP Server URLs.
    Split-Join Work Manager
    Split-Join
    Work Manager name for a split-join resource.
    Tuxedo Access Point Map
    Proxy or business service
    Name and address of the local access point(s) per Managed Server; there is one location per URI.
    Tuxedo Access Point Name
    Business service
    Name of the remote WTC access point associated with the URI.
    Tuxedo Network Address
    Business service
    Network address of the remote WTC access point associated with the URI.
    UDDI Auto Import
    UDDI Registry
    Auto-synchronize property of an imported business service from a UDDI Registry. This property is per registry.
    UDDI Auto Publish
    Proxy service
    Auto-publish property of a proxy service to a UDDI Registry.
    UDDI Inquiry URL
    UDDI Registry
    Inquiry URL for a UDDI Registry.
    UDDI Publish URL
    UDDI Registry
    Publish URL for a UDDI Registry.
    UDDI Security URL
    UDDI Registry
    Security URL for a UDDI Registry.
    UDDI Subscription URL
    UDDI Registry
    Subscription URL for a UDDI Registry.
    WS Error Queue URI
    WS business service
    The URI of the JMS queue for storing error messages.
    Work Manager
    Proxy or business services using DSP, HTTP, JMS, MQ, JPD, SB, Tuxedo, or WS transports
    Work Manager name in all proxy and business services.

  9. To locate environment values located in a particular project, select the project name from the Located in Project drop-down list.
  10. In the Replace with field, enter the new environment value.
  11. To replace the original environment value with the new value, click Replace All.
  12. All occurrences of the environment value you entered in the Find Value field are replaced with the environment value you entered in the Replace with field in the current session.

    Note: Certain environment values are complex XML objects that cannot be found and replaced using the console. However, you can still set these environment values directly by using the ALSBConfigurationMBean from a script. For detailed information about ALSBConfigurationMBean, see the Javadoc for AquaLogic Service Bus Classes. In addition to setting them through the API, you can set complex type environment values using customization files. See Executing Customization Files.
  13. To end the session and deploy the configuration to the run time, click Activate under Change Center.

Related Topics

For detailed information about EnvValueTypes, see the Javadoc for AquaLogic Service Bus Classes. The Java types and location values of these environment values are specified in the javadoc.