Mail Item Information

Command

The following commands output the mail item information:

• To return the information about mail items:

plist -m <queuename> | ALLQUEUES

• To return work queue parameters:

plist -mW <queuename>|ALLQUEUES

• To return Locker, Username, Host, Procnum, Stepname, RQID, and Deadline-time:

plist -mv <queuename> | ALLQUEUES

• To return Case-Description, Case-Starter, Step-Description, Procedure-Description, Step-Flags, Proc-Flags, Arrival-time, and PVer:

plist -mvv <queuename> | ALLQUEUES

Returns

The plist -m, plist -mv, plist -mvv, and plist -mW commands return the following information.

Column

Description

QName

The name of the queue.

RQID

The unique reference assigned internally.

Case#

The case number. It can be the CID or CCR. The CID is the case ID, a unique reference used internally by TIBCO iProcess Engine. The CCR is the case-control record number.

Flags

The meaning for each flag is:

• s mail suspended.
• m item has no memos (for WIS only).
• r item awaiting forwarding (for WIS only).
• T test mail.
• G item is locked for long-term.
• f not available for opening or forwarding.
• U invalid addressee.
• S start step.
• X the deadline.
• D this mail has a deadline.
• P this mail has been purged.
• L item is open and locked by the user.
• N new piece of mail.
• F free record.

Locker

Displayed if the plist -mv or plist -mvv command is used.

The user who has the work item locked (for example, when in group mailbox).

UserName

Displayed if the plist -mv or plist -mvv command is used.

The user who owns this queue, or the group who owns this work item.

Host

Displayed if the plist -mv or plist -mvv command is used.

The node ID, which is associated with the work item.

Procnum

Displayed if the plist -mv or plist -mvv command is used.

The procedure number. The number of times the record is used.

Procname

Displayed if the plist -mv or plist -mvv command is used.

The name of the procedure.

Casenum

Displayed if the plist -mv or plist -mvv command is used.

The Case number.

Stepname

The name of the step.

Pno

Displayed if the plist -mv or plist -mvv command is used.

The place number. It is a unique number allocated to each step.

Deadline-time

Displayed if the plist -mv or plist -mvv command is used.

The date and time when the deadline (if defined) expires on the work item.

Case-Description

Displayed if the plist -mvv command is used.

The description of the case, which the work item belongs to.

Case-Starter

Displayed if the plist -mvv command is used.

The user who started the case, which the work item belongs to.

Step-Description

Displayed if the plist -mvv command is used.

The description of the step.

Procedure-Description

Displayed if the plist -mvv command is used.

The description of the procedure, which generated the work item.

Step-Flags

Displayed if the plist -mvv command is used.

The meaning for each flag is:

• W means withdraw.
• V means view.
• R means rebuild.
• O means outonly.
• F means forward.
• E means edit.
• S means status.
• d means deadline.
• a means action.
• D means document.
• A means address.

Proc-Flags

Displayed if the plist -mvv command is used.

The meaning for each flag is:

• N networks.
• a admin functions.
• s start cases.
• I this procedure is a Sub-procedure.
• H this procedure has a Sub-procedure.
• m management reports.
• M Management reports exist.
• P Auto purge ON.
• W Working days.
• h hidden case description.
• o optional case description.
• 0 field addressee NA.
• T this procedure is a template.
• :WTH this procedure is withdrawn.
• :REL this procedure is released.
• :UNR this procedure is unreleased.
• :INC this procedure is incomplete.
• :MOD this procedure is a model.
• :WIC WITHDRAWN_INC.
• :DEL this procedure is deleted.

Arrival-time

Displayed if the plist -mvv command is used.

The timestamp when the work item is delivered to the queue.

PVer

Displayed if the plist -mvv command is used.

The version number of the procedure, which generated the work item.

Example

The following examples show the output node information of the commands.

• Input the SWDIR/util/plist -m queue command where queue is the name of the queue. The output is shown as follows. 
QName   ReqID   PName   Case#  Stepname  Flags        Case   Description
------------------------------------------------------------------
queue   301     MORT01   201   TAKEAPP  ----S------   Rain
queue   951     MORT01   601   REVAPP   ---------N-   test
queue   952     MORT01   551   REVAPP   ---------N-   test
queue   1051    MORT01   701   TAKEAPP  ----S------   t
queue   1201    MORT01   801   REVAPP   ---------N-   qq
queue   1251    MORT01   651   REVAPP   ---------N-   xxx
• Input the SWDIR/util/plist -mW queue command where queue is the name of the queue. The output is shown as follows. 
QName   ReqID    PName   Case#  Stepname   Flags       Case  Description
------------------------------------------------------------------------
queue    301      MORT01  201    TAKEAPP  ----S------  Rain
        WQParam1 =
        WQParam2 =
        WQParam3 =
        WQParam4 =
queue    951      MORT01  601    REVAPP   ---------N-  test
        WQParam1 =
        WQParam2 =
        WQParam3 =
        WQParam4 =
• Input the SWDIR/util/plist -mv queue command where queue is the name of the queue. The output is shown as follows. 
QName  Flags Locker  UserName Host  Procnum Procname Casenum Stepname Pno RQID     Deadline-time 
-----------------------------------------------------------------------------------
queue  ----S------ swadmin@ipe113 ipe113 3:1   MORT01   201:201 TAKEAPP  3   301      3000/365 23:15
queue  ---------N-                ipe113 3:1   MORT01   601:601 REVAPP  4   951      3000/365 23:15
queue  ---------N-                ipe113 3:1   MORT01   551:551 REVAPP  4   952      3000/365 23:15
queue  ----S------ swadmin@ipe113 ipe113 3:1   MORT01   701:701 TAKEAPP  3   1051     3000/365 23:15
queue  ---------N-                ipe113 3:1   MORT01   801:801 REVAPP  4   1201     3000/365 23:15
queue  ---------N-                ipe113 3:1   MORT01   651:651 REVAPP  4   1251     3000/365 23:15
• Input the SWDIR/util/plist -mvv ALLQUEUES command. The output is shown as follows. 
Flags Locker UserName Host Procnum Procname Casenum Stepname Pno RQID  Deadline-time  Case-Description  Case-Starter  Step-Description  Procedure-Description Step-Flags Proc-Flags  Arrival-time    PVer
-----------------------------------------------------------------------
-------S------  administrator@sql_11_3_0 sql_11_3_0 3:1 SS1 51:51 STEP1 3   51       3000/12/31 23:15 dd1                                   administrator@sql_11_3_0                                    --R---S-aDA ------W:UNR 2012/06/26 10:14 0.0
-------S------  administrator@sql_11_3_0 sql_11_3_0 3:1 SS1 101:101  STEP1    3   101      3000/12/31 23:15 tt2                      administrator@sql_11_3_0                                    --R---S-aDA ------W:UNR 2012/06/26 15:40 0.0