10. MODIFICATION › 10.3 Primary Execution Modules › VMTRDR Reader Interrogation and SMSG Handling Routine

VMTRDR Reader Interrogation and SMSG Handling Routine

+--------+
| VMTRDR |  Reader Interrogation and Special Message Handling
+--------+

The VMTRDR utility is called by VMTWAITR.  It examines spool
files in the reader to determine that they are valid VM
Account or VM Monitor files and returns information about
valid files.  It also receives special messages sent through
CP SMSG command via Virtual Machine Communication Facility
(VMCF).


VMTRDR PARAMETERS

The parameters for VMTRDR provide a means of receiving VMCF
external interrupts, as well as waiting for the arrival of VM
Account and VM Monitor reader files in CMS.  This program
operates only in CMS.  Parameters are passed by means of the
CMS extended parameter list.

The minimum abbreviation for all parameters is the initial
character, unless otherwise noted.  All parameters are in
keyword format.


PARAMETERS

CLASS=c          This parameter restricts the reader files to
                 be examined to those whose class is
                 specified here.  Valid values of c are A-Z,
                 0-9, or *.  The default is * (any).

RESET=Y|N        This parameter indicates that the "file
                 seen" indicator for files processed should
                 be turned off.  The default is Y (Yes).

STACK=Y|N        This parameter indicates whether or not
                 program responses should be returned via the
                 CMS program stack.  The default is N (No).

TYPE=Y|N         This parameter indicates whether or not
                 program response should be displayed at the
                 CMS console.  The default is Y (Yes).

WAIT=Y|N         This parameter indicates whether or not
                 the program should wait for a VM Monitor or
                 Account reader file, if one is not available
                 in the reader.  The default is N (No).

ACTID=userid     This parameter specifies a virtual machine
                 from which VM Account data can be accepted.
                 This is used when the data is preprocessed
                 by another virtual machine and then
                 rewritten (punched) to the VM spool by that
                 virtual machine.  If this parameter is
                 omitted, VM Account data will not be
                 accepted from another virtual machine but
                 only from the CP.

SMSG=Y|N         This parameter indicates whether or not the
                 program should wait for a special message
                 sent via VMCF.  The default is N (No).  The
                 minimum abbreviation for SMSG is SM.

ECMODE=Y|N       This parameter identifies whether or not the
                 virtual machine runs at extended control
                 mode.  The default is N (No).

STOP=Y|N         This parameter indicates whether or not to
                 stop waiting after all outstanding special
                 messages or reader files have been
                 processed.  If there is no valid VM Account
                 or VM Monitor file in the reader and no
                 special messages enqueued, the program exits
                 immediately.  The default is N (No).  The
                 minimum abbreviation for STOP is ST.