Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# 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

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.