M prefix (full-screen mode)

The M prefix command, which you enter through the prefix area of the Source window, adds an operand or operands on that line to the Monitor window.

>>-M--+-+---------+----------+--;------------------------------><
      | '-integer-'          |      
      | .-,-------.          |      
      | V         |          |      
      +---integer-+----------+      
      '-integer-- - -integer-'      

integer

Identifies specific operands to be monitored. If you do not specify an integer, Debug Tool monitors all operands. If you enter a single number or the form 1,2,3, Debug Tool monitors the specified operand or operands. If you use the form 1-4, Debug Tool monitors operands 1 through 4.

For programs other than assembler and disassembly, integer identifies the position of a variable on a line, beginning from the left. The first variable on the line is position 1, the second variable on the line is position 2, and this pattern repeats until there are no more variables. If a variable is on the line more than once, only the first instance of the variable is assigned a position number. If no integer is specified, all the variables on the line are added to the Monitor window.

For assembler and disassembly programs, integer identifies operands of the machine instruction. Debug Tool numbers them from left to right with the first operand numbered operand 1, the second operand numbered operand 2, and repeating the pattern until there are no more operands. If you do not specify an integer, Debug Tool adds all operands referenced explicitly or implicitly by the instruction to the Monitor window. If you specify any form of integer, Debug Tool adds only the operands explicitly referenced by the specified operand or operands to the Monitor window.

Usage notes

• For C/C++, integer values cannot be specified.
• The M prefix command can be entered only on lines that have valid statements.
• You can enter the M prefix command on multiple lines.
• The M prefix command works only for the following compile units:
  • Assembler or disassembly compile units
  • Enterprise COBOL compile units
  • Enterprise PL/I compile units compiled with Enterprise PL/I for z/OS®, Version 3.6 or 3.7 with the PTF for APAR PK70606 applied, or later
  • C/C++ compile units, compiled with the z/OS 2.1 XL C/C++ compiler or later, with DEBUG(FORMAT(DWARF)) option.
• You cannot use the M prefix command on a line that is in a block that is not currently active.
• The following notes apply when you use the M prefix command in an assembler or disassembly program:
  • When you specify integer, it applies to an entire machine instruction operand, not to a single symbol. For example, in the following instruction, operand 1 is the storage referenced by “SYM1-SYM2(LEN,R8)” and operand 2 is the storage referenced by SOURCE:

    MVC  SYM1-SYM2(LEN,R8),SOURCE

  • Debug Tool uses the current values in a register to evaluate any registers referenced by an instruction. When you reference an instruction that is not the instruction where the program is suspended, the current values in a register might differ from what the values would be if Debug Tool stopped the program at the instruction you referenced.
  • When you specify an explicit base or index register in an operand, Debug Tool computes the effective address of the storage location when you enter the M prefix command. Debug Tool does not recompute the effective address while it monitors the operand.
  • When you specify a single symbol as a machine instruction operand, Debug Tool uses the current value of any base register and the currently active USING as Debug Tool monitors the operand.
  • The M prefix command cannot access mask fields, immediate data fields, and any other constants imbedded in the machine instructions. However, Debug Tool does number these fields when it numbers the operands.
  • For instructions that might be coded using extended mnemonics (BC, BCR, and BRC), Debug Tool cannot determine whether the base form or the extended mnemonic was used. Therefore, you can use both 1 and 2 to refer to the operand representing the branch target.

Example

The following example uses the following lines of code:

...
             293     move 0 to c; move 0 to b; move 0 to IND; move  b  to a;
...
             319     if a + b < b + c
             320        then move ind to c;
             321     end-if;
...

To add the variable c on line 293 to the Monitor window, enter the M1 command in the prefix area of line 293.

...
200          L    R6,=X'31BA4038'
201          STM  R1,R4,0(R6)
202          TM   X'01',FLAGS
203
...

Refer to the following topics for more information related to the material discussed in this topic.

• Related references
• MONITOR command