Description

   The CLI$PRESENT routine examines the parsed command string to
   determine whether the entity referred to by the entity_desc
   argument is present.

   When CLI$PRESENT tests whether a qualifier is present, the
   condition value indicates whether the qualifier is used globally
   or locally. You can use a global qualifier anywhere in the
   command line; you use a local qualifier only after a parameter.
   A global qualifier is defined in the command definition file
   with PLACEMENT=GLOBAL; a local qualifier is defined with
   PLACEMENT=LOCAL.

   When you test for the presence of a global qualifier, CLI$PRESENT
   determines if the qualifier is present anywhere in the command
   string. If the qualifier is present in its positive form,
   CLI$PRESENT returns CLI$_PRESENT; if the qualifier is present
   in its negative form, CLI$PRESENT returns CLI$_NEGATED.

   You can test for the presence of a local qualifier when you are
   parsing parameters that can be followed by qualifiers. After you
   call CLI$GET_VALUE to fetch the parameter value, call CLI$PRESENT
   to determine whether the local qualifier is present. If the local
   qualifier is present in its positive form, CLI$PRESENT returns
   CLI$_LOCPRES; if the local qualifier is present in its negative
   form, CLI$PRESENT returns CLI$_LOCNEG.

   A positional qualifier affects the entire command line if
   it appears after the verb but before the first parameter. A
   positional qualifier affects a single parameter if it appears
   after a parameter. A positional qualifier is defined in the
   command definition file with the PLACEMENT=POSITIONAL clause.

   To determine whether a positional qualifier is used globally,
   call CLI$PRESENT to test for the qualifier before you call
   CLI$GET_VALUE to fetch any parameter values. If the positional
   qualifier is used globally, CLI$PRESENT returns either CLI$_
   PRESENT or CLI$_NEGATED.

   To determine whether a positional qualifier is used locally,
   call CLI$PRESENT immediately after a parameter value has been
   fetched by CLI$GET_VALUE. The most recent CLI$GET_VALUE call to
   fetch a parameter defines the context for a qualifier search.
   Therefore, CLI$PRESENT tests whether a positional qualifier was
   specified after the parameter that was fetched by the most recent
   CLI$GET_VALUE call. If the positional qualifier is used locally,
   CLI$PRESENT returns either CLI$_LOCPRES or CLI$_LOCNEG.