Refreshing staff queries, using administrative commands

The results of a staff query are static. Use the administrative commands to refresh staff queries.

Before you begin

Before you begin this procedure, the following conditions must be met:
  • The user ID that you are using must have administrative rights.
  • The application server on which the messages are to be queried or replayed must be running. That is, the -conntype none option of wsadmin cannot be used, because a server connection is required.
  • When security is enabled, you must have operator authority.

Why and when to perform this task

Business Process Choreographer caches the results of staff assignments evaluated against a staff directory, such as an Lightweight Directory Access Protocol (LDAP) server, in the runtime database. If the staff directory changes, you can force the staff assignments to be evaluated again.

Steps for this task

  1. Change to the Business Process Choreographer utilities directory where the scripts are located.
    On Windows® systems, enter:
    cd install_root\ProcessChoreographer\util
    On UNIX® and Linux® systems, enter:
    cd install_root/ProcessChoreographer/util
  2. Force the staff assignment to be evaluated again.

    On Windows systems, enter one of the following commands. The differences between the commands are emphasized:

    install_root\bin\wsadmin -f refreshStaffQuery.jacl 
            -server serverName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]
    
    install_root\bin\wsadmin -f refreshStaffQuery.jacl 
            -node nodeName 
            -server serverName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]
    
    install_root\bin\wsadmin -f refreshStaffQuery.jacl 
            -cluster clusterName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]

    On UNIX and Linux systems, enter one of the following commands. The differences between the commands are emphasized:

    install_root/bin/wsadmin.sh -f refreshStaffQuery.jacl 
            -server serverName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]
    
    install_root/bin/wsadmin.sh -f refreshStaffQuery.jacl 
            -node nodeName 
            -server serverName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]
    
    install_root/bin/wsadmin.sh -f refreshStaffQuery.jacl 
            -cluster clusterName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]

    Where:

    cluster clusterName
    The name of the cluster. Required if the business process container is configured for a WebSphere® cluster.
    node nodeName
    Optional when specifying the server name. This name identifies the node. The default is the local node.
    server serverName
    The name of the server. Required if the cluster name is not specified.
    processTemplate templateName
    The name of the process template. Staff assignments that belong to this process template are refreshed.
    taskTemplate templateName
    The name of the task template. Staff assignments that belong to this process template are refreshed.
    nameSpace nameSpace
    The namespace of the task template.
    userList userName
    A comma-separated list of user names. Staff assignments that contain the specified names are refreshed.
    profileName profileName
    The name of a user-defined profile. Specify this option if you are not working with the default profile.
    Note: If you do not specify any templateName nor userList, all staff queries that are stored in the database are refreshed. You might want to avoid this for performance reasons.
Related concepts
Setting the interval for refreshing staff queries
Related tasks
Refreshing staff queries, using the administrative console

Terms of use | | Broken links

Last updated: Tue Dec 06 04:14:42 2005

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)