asyncrpc

Long-running remote procedure calls (RPCs) are implemented by using an asynchronous mechanism to avoid timeouts. With the asyncrpc command, you can manage these long-running, asynchronous workflow RPC tasks, such as pelog or peverify.

Every time a workflow initiates an asynchronous task on behalf of a client request, it creates an asynchronous record to track the overall status, and creates a list of detailed messages for the task.

Syntax

asyncrpc {List | Clear | Abort | Attach} [<ID>]

Action to perform Syntax
List. List asynchronous tasks. asyncrpc list [<ID>]
Clear. Delete all records that are associated with a particular asynchronous task. asyncrpc clear <ID>
Abort. Stop a running task. asyncrpc abort <ID>
Attach. View the status of a running task. asyncrpc attach <ID>

Parameters

Parameter Description
list [<ID>] List one or more asynchronous tasks. If an ID is not specified, all asynchronous tasks are listed.
For each asynchronous task, the list parameter outputs the following items in a table:
  • ID: An assigned internal ID, which you can use to query for single asynchronous task.
  • Status: The status of the asynchronous task:
    • Request-Execution
    • Executing
    • Processed
    • Exception received
    • Failed
    • Request-Abort
    • Aborted
    • Completed
  • Start Time: The time when the asynchronous task is started.
  • Last Update: The time when the asynchronous task ended. The duration between the start and end time determines how the time span of this task.
  • Tasks/Regions: The name of the asynchronous task and the number of the region it operates on. Tasks that are not region-bounded display n/a instead of a region number.
  • Client: The client and host IP that starts this task.
Example output:
ID   Status      Start Time            Last Update          Tasks/Regions            Client
======================================================================================================================
1    Completed   2015/06/05 16:53:23   2015/06/05 16:53:25  CacheAllUsersGroups/n/a  Started by peadmin on 9.39.8.152.
2    Completed   2015/06/05 16:57:23   2015/06/05 16:57:25  UserInconsistency/n/a    Started by peadmin on 9.39.8.152.
clear <ID> Delete all records that are associated with the specified asynchronous task.
abort <ID> Stop the specified running task.
attach <ID> View the status of the specified asynchronous task.