10. MODIFICATION › 10.3 Primary Execution Modules › VMTWAITR Wait for an Event

VMTWAITR Wait for an Event

+----------+
| VMTWAITR |  Wait for an Event
+----------+

VMTWAITR can be used as a model for running VMTXMIT in a
disconnected virtual machine.  VMTWAITR uses VMTRDR to
interrogate the CMS reader and/or receive special messages
sent from other virtual machines via the CP SMSG command.

The format for the VMTWAITR EXEC is:

    VMTWAITR <options>

    where options is one or more of the following:

    RESET    - reset the status of reader files so that they
               can be reexamined and then exit (see note
               below).
    RUN      - inhibit exit on RESET option
    DISC     - disconnect (implies RUN)
    DEBUG    - turn on tracing in VMTRDR for problem analysis
    CONSole  - turn on the console spool file, overriding the
               parameter setting in VMTXMIT PARMS.
    NOCONS   - turn off the console spool file, overriding
               the parameter setting in VMTXMIT PARMS.

    Notes:
    1.  VMTRDR places each file in "seen" state as it
        examines them to reduce processing overhead on
        subsequent searches of the CMS reader for files that
        are eligible for processing.

    2.  VMTWAITR accepts a number of commands issued from
        other virtual machines via the message text of the CP
        SMSG command.  See Section 9.1.2 for details.