%DUMP RUNQ--List Jobs in PSL Queue


List the items found in the Agent's run queue

Syntax

 %DUMP RUNQ

Parameters

This command has no parameters.

Description

Lists items found in the Agent’s run queue. Each item is detailed in the format below:

rtcell:runq_id (proc=rtcell_id, obj id=obj_id, pid=pid, active=active)
proc_type (proc_details)
pipes:agent->proc=(agt_read,agt_write) proc->agent=(proc_read,proc_write)
has executed:exec_occurred has sent output:output_sent
exec time:next_exec repeat interval:interval

Field

Description

runq_id 

pointer to item’s position in run queue 

rtcell_id 

pointer to rtcell associated with queued item 

obj_id 

numeric object ID of namespace object to which this item belongs, or none 

pid 

process ID in the Agent’s process list. The process ID only appears when the item is actually executing. It displays -1 at other times. 

active 

True if rtcell is active, False if rtcell is not active 

proc_type 

One of the following:

  • PARAMETER
  • RECOVERY ACTION
  • COMMAND
  • A_LWP
  • PSL_COMMAND 

proc_details 

The details that are given for a process vary according to the type of process:

  • PARAMETER

`app`inst`param (type=type state=state)

  • RECOVERY ACTION

`app`inst`alarm_type`action_name

  • COMMAND

`app`inst`command_text (type=type)

  • A_LWP

( function_pointer ( data_pointer ))

  • PSL_COMMAND

( process_number ) 

agt_read 

read handle from agent to piped process, -1 if none 

agt_write 

write handle from agent to piped process, -1 if none 

proc_read 

read handle from piped process to agent, -1 if none 

proc_write 

write handle from piped process to agent, -1 if none 

exec_occurred 

Yes if this item has executed at least once, No otherwise 

output_sent 

no longer used, displays No. 

next_exec 

time rtcell is scheduled to execute next, in seconds from Epoch, followed by relative number of seconds from now 

interval 

interval in seconds between executions of the rtcell. 

Warning

Note

The %DUMP RUNQ command is one of a series of dump commands available from the command line. Use the %DUMP command (no argument) to obtain a list of items that can be dumped. 

 

Where to go from here

PSL-External-Commands

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC PATROL Agent 11.0