TAA Tools
RUNMNUCMD       RUN MENU COMMAND                       TAACMEW

The Run  Menu Command command  provides the  functions of QCMDEXC  with
additional  functions  provided by  the  QCAPCMD API.    The additional
functions  include: 1)  Prompting for  the command  on missing required
parameters or some invalid entries  and 2) Limited user checking.   The
command can be  useful when attempting to simulate a  command line on a
menu.

A typical command would be:

             RUNMNUCMD    CMD(SNDMSG TOUSR(xxx))

Because  the SNDMSG  command  requires the  MSG parameter,  the command
prompt  would appear  with  text  describing  the  fact  that  the  MSG
parameter is required.

This is  as opposed  to QCMDEXC  which would  fail and  send an  escape
message.

RUNMNUCMD will run the command as entered (or after prompting).

It is valid to use selective prompting when entering the command.

RUNMNUCMD escape messages you can monitor for
---------------------------------------------

      CPF6801    Command was cancelled

Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   CMD           The  command string to be  run.  Up to  5000 bytes may
                 be entered.

   CMDLINE       Whether to run the  command as if  on a command  line.
                 *YES is the default  to operate as if the  command was
                 entered  on  a  command  line.   This  means  that  1)
                 Limited  user checking  is performed  and 2) Prompting
                 for   missing    required   parameters   or    invalid
                 parameters occurs.

                 For an  understanding of  the 'Limited  user checking'
                 function,  see the CRTUSRPRF  command LMTCPB parameter
                 and the CRTCMD command ALWLMTUSR parameter.

                 *NO may  be specified  to operate  as  if QCMDEXC  was
                 called.

   SRCTYPE       The type  of source entered.   *CLP is the  default to
                 use system syntax checking.

                 *CLP38  may  entered to  use the  syntax  checking for
                 S/38.

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     RSNALLMSG       Resend all messages
     SNDESCINF       Send escape information

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   RUNMNUCMD     *CMD                   TAACMEW       QATTCMD
   TAACMEWC      *PGM       CLP         TAACMEWC      QATTCL
					

Added to TAA Productivity tools September 1, 2004


Home Page Up to Top