Skip to Content

Displaying destination queue information

This section explains how to display and browse destination shared queues information at your terminal without building a command set. This method does not let you print reports.

Warning

Note

You can select sort and format options by placing the cursor on the View option at the top of the panel and pressing Enter.

The ISPF interface provides online help for all panels, pop-up panels, and fields. For information about accessing the online help system, see Online-help.

To display and browse destination shared queues information at your terminal without building a command set, perform the following procedure.

To display destination queue information

  1. On the Message Advisor Primary Menu, type 2 in the choice entry field.

  2. Type the IMSID for which you want to display destination information in the IMSID field and press Enter.The Destination Selection pop-up panel is displayed below.

     File  Session  Display  View  Help                                           
    ------------------------------------------------------------------------------
                         Destination Selection - Shared Queues                    
    Command ===> _________________________________________________________________
                                                                                  
      IMSID . . . . R61P +                                                         
                       ---- SHARED client queues -------- or ---- LOCAL queues ----
      Selection . . __ 1. All DESTs        6. LTERM ready    12. All LOCAL         
                       2. All TRANs        7. APPC           13. CNT-  Local LTERMs
                       3. TRAN Ready       8. REMOTE         14. SMB-  Local TRANs
                       4. TRAN Suspend     9. OTMA           15. HELD- Conversation
                       5. TRAN Serial     10. All TERMs   or ---- PRIVATE queues --
                                          11. Staging queues 16. COLDQ
      Global queues _  1. Both structures                    17. LOCKQ
                       2. Primary structure only             18. ControlQ
                       3. Overflow structure only                                  
                                                                                  
    Destination (use '?' or '*' for masking, use quotes if lowercase/special chars)
      Dest. . . __________________________________________________________________
      Affinity  ____________ (&NONE, &IMSID, &ORPHAN, or &EXISTS are also allowed)
      Select messages ________ through ________ (queue position range)
      Entryid ____________________________ (use 8-char DRRN for local queues)

    Select View pulldown for Sort and Format options.
  3. Determine the queue type of the destination information that you want to review. For shared client queues, select a number in the range 1 to 11; for local IMS messages (in a shared queues environment), select a number in the range 12 to 15; for private queues, select a number in the range 16 to 18.
    1. Verify that the IMSID in the IMSID field is accurate.
    2. Type the number that matches the kind of information you want to view in the Selection field.
    3. If you selected to view a global destination, specify the structures that you want to view in the Global queues field.

    4. Type a destination that is valid for your site in the Dest field (to display all destinations for this IMSID, leave this field blank).

      Warning

      Note

      To display messages that have been identified as errors, use option 9 on the Primary Menu. For more information, see Using-the-Message-Advisor-Analyzer-Facility.

      Masking is allowed in the Dest field: ? replaces one character in a multicharacter string; * replaces the rest of the string.

    5. Type an affinity in the Affinity field to display messages with a specific affinity. Masking is allowed

    6. Type values in the Select messages ______ through ______ field to process a range of messages.When you enter a range of messages to be processed, the QPOSITION keyword is used to select only those messages. The counts on the Destination List pop-up panel will include only messages in the specified range and the Display messages option will only select those messages.

      For example, if transaction PART has 100 messages queued but you enter a range of 1 through 10, PART will display with a count of 10. If you type a D to dequeue PART, only the first 10 messages will be dequeued.

      If you enter only the first number, only one message is processed for each destination.

    7. Press Enter.The Destination List pop-up panel is displayed below.

      .-----------------------------------------------------------------------------.
      |                              Destination List                               |
      | Command ===> ____________________________________________ Scroll ===> HALF  |
      |                                                                             |
      | Type one or more action codes.  Then press Enter.                           |
      | A   S=Display messages                                  Row 00001 of 00024  |
      | c   D=Dequeue/reset        F=Deq/force  N=Deq/nolog          More:       +  |
      | t Type   Destination  Msgs.   Recs.   Segs. --- % Used --- Info    Affinity |
      |                                             Overflow Prim.                  |
      | _ TRAN1  TESTMSC2         4       4      4           0.00% TESTMSC2         |
      | _ TRAN1  PART             8       8      8           0.03% DFSSAM02  DGW7   |
      | _ TSERL4 RCUTC10          6       6      6           0.01% RCUDB10   DGW7   |
      | _ LTRM5  DGW3            24      24     24           0.05%                  |
      | _ LTRM5  INPROGE          6       6      6           0.01%                  |
      | _ LTRM5  WAIT0001        30      30     30           0.12%                  |
      | _ LTRM5  ZZZZ0001       202     202    202           0.86%                  |
      | _ LTRM5  DGW4             4       4      4           0.00%                  |
      | _ LTRM5  SMASTER         56      56     63           0.14%                  |
      | _ LTRM5  WAIT0002        30      30     30           0.12%                  |
      | _ LTRM5  ZZZZ0002       303     303    303           1.29%                  |
      | _ APPC7  SYNC             8       8      8           0.03% SYNC      DGW7   |
      | _ APPC7  ASYNC            8      17     36           0.19% ASYNC     DGW7   |
      | _ APPC7  ASFDASDF >       2       2      2           0.00% JUNK      DGW7   |
      | _ APPC7  SYNC             4       4      4           0.01% SYNC      &ORPHAN|
      | _ APPC7  ASYNC            4      10     22           0.11% ASYNC     &ORPHAN|
      | _ APPC7  DFSASYNC >       8       8      8           0.05% OMVSBDR1  DGW7   |
      | _ APPC7  JUNK             1       1      1           0.00% JUNK      &ORPHAN|
      | _ APPC7  ASFDASDF >       1       1      1           0.00% JUNK      &ORPHAN|
      | _ APPC7  DFSASYNC >       4       4      4           0.02% OMVSBDR1  &ORPHAN|
      | _ APPC7  JUNK             2       2      2           0.00% JUNK      DGW7   |
      | _ OTMA9  DGWITOC7         4       7     17           0.09% OTM2TEST  DGW7   |
      '-----------------------------------------------------------------------------'
      Warning

      Note

      The % Used column in shows the percentage of messages in the Overflow and Primary structures. (Primary entries are displayed first; Overflow entries are displayed at the bottom of the destination list.)

      A greater than symbol following a destination indicates that more information exists and can be displayed by scrolling to the right.

      Orphaned APPC and OTMA destinations are identified in the Affinity column.

  4. To select an entry from the list of destinations in the Destination List pop-up panel, type S in the selection field next to the destination and press Enter.The Message List pop-up panel is displayed with a list of queued messages.

                                      Message List

    Type one or more action codes.  Then press Enter.
      S=Hex display       H=Hex display   P=Prefix display D=Dequeue/reset     F=Deq/force       N=Deq/nolog        Line 00001 of 00004
    Dest . . : TESTMSC2
    Q Type . : TRAN1
    Act Q#   MSG#  Size Origin         Timestamp      Format   User ID
     _  1     1-1   431 DGW3      2003/055 17:54:51.9          DGW3
     _  1     2-1   431 DGW3      2003/055 17:54:51.9          DGW3
     _  1     3-1   431 DGW3      2003/055 17:54:51.9          DGW3
     _  1     4-1   431 DGW3      2003/055 17:54:51.9          DGW3
  5. View the message record in hexadecimal mode or formatted mode.

    • To view the message record in hexadecimal mode, type S in the Act field and press Enter.

      The message record is displayed in hexadecimal mode.

                                   Message Display
       Dest: TESTMSC2
       Q-Type Q# MSG#    Size Origin        Timestamp        Format   User ID
       TRAN1  1   1-1     431 DGW3      2003/055 17:54:51.9           DGW3
                                                                Line 00001 of 00051
       Entryid. . : 020004E3BA070752073D2202                              More:   +
         Structure Entry Controls ----------------------------
         000000 01000000 00000623 00000048 020004E3 / .................T  /
         000010 BA070752 073D2202 00000000 00000000 / ..................  /
         000020 01E3C5E2 E3D4E2C3 F2404040 40404040 / .TESTMSC2           /
         000030 00000000 00000000 00000000 00000000 / ..................  /

         Adjunct Data ----------------------------------------
         000000 01E3C5E2 E3D4E2C3 F2404040 40404040 / .TESTMSC2           /
         000010 C4C7E6F7 40404040 B90839CF 0EF49A27 / DGW7    .....4..    /
         000020 C4C7E6F7 40404040 BA034ADB C2FD99A0 / DGW7    ....B.r.    /
         000030 00000000 00000000 00000000 00000000 / ................    /

         CQS Prefix ------------------------------------------
         000000 000001CF 00000020 00010200 80000000 / ................    /
         000010 BA034ADB C34ECE67 BA034ADB C34ECE67 / ....C.......c...    /

         Message Prefix---------------------------------------

                --- Basic Prefix ------------------

    • To view the message prefix in formatted mode, type P in the Act field and press Enter.

      The message record is displayed in formatted mode.

                                       Message Display
         Command ===> _                                            Scroll ===> HALF
         Dest: DISBURSE
         Q-Type Q#   MSG# Size Origin         Timestamp      Format   User ID
         TRAN1  1     1-1  431 USR4      2003/286 11:53:30.1          USR4
                                                                Line 00001 of 00053
         Entryid 02000511BA2A4A75EE1B9302                                 More:   +

           BASIC PREFIX

           Message record length  . . . . . . . . . . : 431
           Message record type (01 or 03) . . . . . . : 01
           Message chain position . . . . . . . . . . : Only record
           Queue number . . . . . . . . . . . . . . . : 1
           Message prefix length  . . . . . . . . . . : 414
           Originating IMSID  . . . . . . . . . . . . : IMSA
           Processing IMSID . . . . . . . . . . . . . : IMSA

           SYSTEM SEGMENT

           Origin name  . . . . . . . . . . . . . . . : USR4
           Destination name . . . . . . . . . . . . . : DISBURSE
           MFS format name  . . . . . . . . . . . . . :

           SECURITY SEGMENT

           RACF user ID . . . . . . . . . . . . . . . : USR4
           SAF group name . . . . . . . . . . . . . . : CC105511

           WORKLOAD MANAGER SEGMENT

           Service classification token . . . . . . . : 00048000
           Message arrival timestamp  . . . . . . . . : 2003/286-11:53:29.2

           SYSTEM EXTENSION SEGMENT

           System extended timestamp  . . . . . . . . : 2003/286-11:53:30.1

           MSC EXTENSION SEGMENT

           MSC extended clock time  . . . . . . . . . :
           Origin system ID . . . . . . . . . . . . . :       1
           Destination system ID  . . . . . . . . . . :       1

           TRANSACTION MANAGEMENT ROUTER SEGMENT

           Origin system ID . . . . . . . . . . . . . :       1
           Origin name  . . . . . . . . . . . . . . . : USR4
           Destination system ID  . . . . . . . . . . :       1
           Destination ID . . . . . . . . . . . . . . : DISBURSE
           Source IMS Release level . . . . . . . . . : R8.1
           Highest IMS Level to process message . . . : R8.1
  6. Press END until the Primary Menu is displayed.

Related topic

Displaying-messages-for-shared-queues




 

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

Message Advisor for IMS 1.7