Refreshing staff query results, 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 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 subdirectory where the administration scripts are located.
    On Windows® systems, enter:
    cd install_root\ProcessChoreographer\admin
    On Linux® and UNIX® systems, enter:
    cd install_root/ProcessChoreographer/admin
  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 –lang jython -f refreshStaffQuery.py 
            -server serverName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]
    
    install_root\bin\wsadmin –lang jython -f refreshStaffQuery.py 
            -node nodeName 
            -server serverName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]
    
    install_root\bin\wsadmin –lang jython -f refreshStaffQuery.py 
            -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 –lang jython -f refreshStaffQuery.py 
            -server serverName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]
    
    install_root/bin/wsadmin.sh –lang jython -f refreshStaffQuery.py 
            -node nodeName 
            -server serverName 
           [-processTemplate templateName | 
           (-taskTemplate templateName [-nameSpace nameSpace]) | 
            -userList username{,username}...]
           [-profileName profileName]
    
    install_root/bin/wsadmin.sh –lang jython -f refreshStaffQuery.py 
            -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 task 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.

Example

Note: The jacl version of the refresh staff query script, refreshStaffQuery.jacl, is deprecated. It is available in the util subdirectory of the ProcessChoreographer directory and it takes the same parameters as described here, but the –lang jython option must be omitted.
Related tasks
Refreshing staff query results, using the administrative console

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