HP 3000 Manuals

TEST Output [ HP Transact Reference Manual ] MPE/iX 5.0 Documentation


HP Transact Reference Manual

TEST Output 

Normally, the output from TEST is sent to the file TRANOUT (your terminal
in a session or the line printer in a batch job).  If you want to change
the test destination, you can precede the test number parameter with a
minus sign.  Then the output goes to TRANDUMP (the formal file-designator
for the destination of the test mode output).  By default, TRANDUMP is
assigned to the line printer.  You can change the assignment of TRANDUMP
to a different device by using a file equation.

For example, if you are executing in a command sequence, you can direct
the test mode to the line printer by preceding the mode numeral
designation with a minus sign:

     >TEST -25                 <---to request test mode 25 with output to TRANDUMP 

If you are not in a command sequence, you can accomplish the same results
with the following procedure:

     Ctrl Y                    <---to stop execution 
       *CONTROL (Y) BREAK

     >TEST -25                 <---to request test mode 25 with output to TRANDUMP 

     >RESUME                   <---enter command to resume execution 

You could also direct the test mode output to a disk file you create
specifically for that purpose.  For example, to send the test output to
the file TEST:

     :BUILD TEST; REC=-80,,F,ASCII   <---create a file for test output 
     :FILE TRANDUMP=TEST             <---equate file TRANDUMP with file TEST 
     :RUN TRANSACT.PUB.SYS 

     SYSTEM NAME> MYPROG,,-25        <---send test output to TRANDUMP(=TEST) 

Another method to accomplish this is to defer test mode by setting the
output priority for TRANDUMP to 1.  For example:

     :FILE TRANDUMP; DEV=,1          <---defer test mode output 
     :RUN TRANSACT.PUB.SYS 

     SYSTEM NAME> MYPROG,,-25 

After executing VTEST, you can run SPOOK5.PUB.SYS to examine the test
mode information saved in a spool file.

If you use test mode for statements that access a VPLUS forms file, you
should either direct the test output to a terminal other than the one
where the VPLUS forms are displayed, or direct the forms to a different
terminal.  Otherwise, the test output will appear on the terminal screen
with the forms.  You could also defer test output as shown above.

For example, you can direct the test output to another terminal whose
logical device number is 19, as shown:

     :FILE TRANDUMP; DEV=19    <---direct test output to ldev 19 
     :RUN TRANSACT.PUB.SYS 

     SYSTEM NAME> VTEST,,-34   <---run VTEST in mode 34; output to TRANDUMP 

An alternative procedure is to direct the VPLUS forms to another
terminal, while the test results are sent to your terminal.  To redirect
the VPLUS forms, use the TRANVPLS formal file designator:

     :FILE TRANVPLS; DEV=19    <---direct VPLUS forms to ldev 19 
     :RUN TRANSACT.PUB.SYS 

     SYSTEM NAME> VTEST,,34    <---run your program with test mode 34 

Now, the test mode output and character mode output appear at your
terminal, but the VPLUS forms output appears on another terminal
identified by its logical device number.

Table 10-1 lists the allowed test parameters and their functions.

          Table 10-1.  Numeric Parameters for the Test Facility 

-------------------------------------------------------------------------
|              |                                                        |
|              |                                                        |
|  Parameter   |                        Function                        |
|              |                                                        |
|              |                                                        |
-------------------------------------------------------------------------
|              |                                                        |
|    (none)    | Switches off existing test mode.                       |
|              |                                                        |
-              -                                                        -
-------------------------------------------------------------------------
|              |                                                        |
|      1       | Displays data block with information about the file or |
|              | database operations only if an error occurs.           |
|              |                                                        |
-              -                                                        -
-------------------------------------------------------------------------
|              |                                                        |
|      2       | Displays each instruction address, the level for that  |
|              | instruction, and the compiler code at that address.    |
|              |                                                        |
-              -                                                        -
-------------------------------------------------------------------------
|              |                                                        |
|      3       | Displays each instruction address, the level for that  |
|              | instruction, the compiler code at that address, the    |
|              | space used by the list and data registers, and the     |
|              | amount of remaining processor work space.              |
|              |                                                        |
-              -                                                        -
-------------------------------------------------------------------------
|              |                                                        |
|      4       | Displays each instruction address, the level for that  |
|              | instruction, the compiler code at that address, the    |
|              | instruction timings, and the HP3000 data stack         |
|              | pointers Z, S, Q, and DL.                              |
|              |                                                        |
-              -                                                        -
-------------------------------------------------------------------------
|              |                                                        |
|      22      | Displays each instruction address, the level for that  |
|              | instruction, the compiler code at that address, and    |
|              | the data block for any instructions that perform       |
|              | database and file operations.  This parameter does not |
|              | operate for the FILE verb.  The data block includes    |
|              | the values and offsets of items in the key and         |
|              | argument registers used by the database or file        |
|              | operation.                                             |
|              |                                                        |

-              -                                                        -
-------------------------------------------------------------------------
|              |                                                        |
|      23      | Displays the instruction address, the level for that   |
|              | instruction, the compiler code at that address, and    |
|              | the data block for any instructions that perform       |
|              | database or file operations.  The display follows a    |
|              | multiple record operation.  This parameter does not    |
|              | operate for the FILE verb.                             |
|              |                                                        |
|              | The data block includes the values and offsets of      |
|              | items in the list, data, key, argument, match, and     |
|              | update registers specifically used by the database or  |
|              | file operation.                                        |
|              |                                                        |
-              -                                                        -
-------------------------------------------------------------------------

          Table 10-1.  Numeric Parameters for Test Facility (continued) 

--------------------------------------------------------------------------------------------
|                              |                                                           |
|                              |                                                           |
|          Parameter           |                         Function                          |
|                              |                                                           |
|                              |                                                           |
--------------------------------------------------------------------------------------------
|                              |                                                           |
|              24              | Displays the instruction address, the level for that      |
|                              | instruction, the compiler code at that address, and the   |
|                              | data block for any instructions that perform database and |
|                              | file operations.  Does not operate for the FILE verb.     |
|                              |                                                           |
|                              | The data block includes the values and offsets of items   |
|                              | in the list, data, key, argument, match, and update       |
|                              | registers specifically used by the database or file       |
|                              | operation.                                                |
|                              |                                                           |
|                              | This display is issued only when an accessed record meets |
|                              | the selection criteria in the match register.  If there   |
|                              | are no selection criteria for this operation or if the    |
|                              | NOMATCH option is in effect, the display is issued for    |
|                              | every record retrieved by the database or file operation. |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|              25              | Displays the instruction address, the level for that      |
|                              | instruction, the compiler code at that address, and the   |
|                              | data block for any instructions that perform database and |
|                              | file operations.  This parameter does not operate for the |
|                              | FILE verb.                                                |
|                              |                                                           |
|                              | Displays the values and offsets of items in the list,     |
|                              | data, key, argument, match, and update registers for      |
|                              | items specifically used by the database or file           |
|                              | operation.                                                |
|                              |                                                           |
|                              | This display is issued for every record accessed by the   |
|                              | database or file operation .                              |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|              34              | Displays the instruction address, the level for that      |
|                              | instruction, the compiler code for that address, and the  |
|                              | contents of the VPLUS buffer following an instruction     |
|                              | generated by a statement that references a VPLUS form.    |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|              42              | Displays instruction address and compiler code for that   |
|                              | address only if the instruction is not listed in the      |
|                              | compiler listing.                                         |
|                              |                                                           |
|                              | Displays contents of the list and data registers whenever |
|                              | the content of the list register (not the data register)  |
|                              | changes.                                                  |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|              43              | Displays the instruction address, the level for that      |
|                              | instruction, the compiler code, and the contents of the   |
|                              | list and data register for every instruction.  This       |
|                              | parameter does not operate for the OUTPUT verb.           |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------

          Table 10-1.  Numeric Parameters for Test Facility (continued) 

--------------------------------------------------------------------------------------------
|                              |                                                           |
|                              |                                                           |
|          Parameter           |                         Function                          |
|                              |                                                           |
|                              |                                                           |
--------------------------------------------------------------------------------------------
|                              |                                                           |
|              44              | Displays the instruction address, the level for that      |
|                              | instruction, the compiler code, and the contents of the   |
|                              | list, data, key, argument, match, and update registers    |
|                              | for every instruction.                                    |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|             101              | Lists the data and work space recovery statistics for     |
|                              | every command sequence.                                   |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|             102              | Lists the data and work space recovery statistics for the |
|                              | entire program.                                           |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|             121              | Issues an overlay trace whenever a program switches       |
|                              | segments.                                                 |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|             122              | Issues a trace whenever a file is locked or unlocked.     |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------
|                              |                                                           |
|             123              | Issues a work space recovery message whenever recovery is |
|                              | needed.                                                   |
|                              |                                                           |
-                              -                                                           -
--------------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation