RMVMSG (Remove Message) syntax diagram


Pgm: B,I REXX: B,I
Threadsafe: Yes
          (1)
>>-RMVMSG------------------------------------------------------->
 
>--+-----------------------------------------------------------------------------------------------------+-->
   |          .-*PRV--.  .-*----------------------------------------------------------------------.      |
   +-PGMQ(--+-+-*SAME-+--+------------------------------------------------------------------------+-+--)-+
   |        |            '-program-or-procedure-name--+-----------------------------------------+-' |    |
   |        |                                         | .-*NONE-------.  .-*NONE--------------. |   |    |
   |        |                                         '-+-module-name-+--+--------------------+-'   |    |
   |        |                                                            '-bound-program-name-'     |    |
   |        |             (2)                                                                       |    |
   |        '-+-*ALLINACT------+--------------------------------------------------------------------'    |
   |          '-*EXT-----------'                                                                         |
   '-MSGQ(--+-*PGMQ---------------------------------+--)-------------------------------------------------'
            | .-*LIBL/--------.                     |
            '-+---------------+--message-queue-name-'
              +-*CURLIB/------+
              '-library-name/-'
 
>--+------------------------------------+----------------------->
   |         (3)                        |
   '-MSGKEY(-------&CL-variable-name--)-'
 
>--+--------------------------------+--------------------------->
   |        (4)   .-*BYKEY-----.    |
   '-CLEAR(-------+-*ALL-------+--)-'
                  +-*KEEPUNANS-+
                  +-*OLD-------+
                  '-*NEW-------'
 
>--+----------------------------+------------------------------><
   |          (5)   .-*YES-.    |
   '-RMVEXCP(-------+-*NO--+--)-'
 
 

Notes:

  1. All parameters preceding this point can be specified in positional form.

  2. If PGMQ(*ALLINACT) is specified, the CLEAR parameter must be *ALL.

  3. MSGKEY can be specified only if CLEAR(*BYKEY) is specified.

  4. CLEAR(*KEEPUNANS) is valid only if a message queue name is specified for the MSGQ parameter. CLEAR(*KEEPUNANS) is not valid if *PGMQ is specified for MSGQ.

  5. This parameter is valid only when MSGQ(*PGMQ) is specified.