%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

FieldDescription
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. 

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

Was this page helpful? Yes No Submitting... Thank you

Comments