RES ,C Replay captured session in COMPARE mode (Regression test)

In the Compare Mode of the Restore the messages received from the communication partner are compared to those of the stored in the LOG file.

RES [file | lib ( [t/] element) | element] , C [, A] [, HC=file [, params] ]

C Compare Mode. The messages received from the communication partner are compared to the values in the LOG file. The LOG file must have been created with LOG file,IO.

A Automatic Regression. The Compare dialog runs automatically, i.e. to the end without user input. The parameter HC= should also be used with this A parameter.

Standard: No automatic regression test. The user must acknowledge each difference in the output of the tested programs.

HC=file [, params]

Store all output that differs from the captured Master dialog in a hardcopy file. The differing screen masks are stored in the specified file in the form NEW and DIF. All optional params (parameters) of the normal HC command can be given, e.g. T(Time Stamp) or L(Laser format).

Execution of the Compare Mode:

The Restore process runs automatically, i.e. the same as the normal Batch Restore (Version 1).

If differences are detected between the output messages contained in the LOG file and the actual messages, the user is informed via a message in the system line (Line 25) of the terminal. The Restore process is interrupted in a similar fashion to Step Mode.

The following K/F keys control the subsequent execution:

K3 Pressing the K3 key will switch the display from the current, actual output message to the output message stored in the LOG file. The respective messages are flagged by NEW and OLD in the system line. Pressing K3 again will result in a differential screen being displayed, wherein all positions in NEW are replaced by spaces, except where NEW differs from OLD. This screen is flagged in the system line with DIF.

K1 Pressing the K1 key during the NEW/OLD/DIF display causes the entire Restore process to be aborted.

DUE1 Acknowledging the NEW/OLD/DIF message with the DUE1/ENTER key will continue the Restore process.

F2 Pressing the F2 key will present the user with with a menu for additional test options.

SN Skip New: The next output provided by the communication partner is compared to that presently obtained from the LOG file. This option is functionally equivalent to removing the output of the communication partner from the comparison message stream.

SO Skip Old: The next message contained in the LOG file is compared with the current message from the communication partner. This option is functionally equivalent to removing the output of the LOG file from the comparison message stream.

E Edit: Here, the user invokes the Compare Editor (see below). Using the Compare Editor, the output messages stored in the LOG file can be edited. In particular, fields can be removed from the comparison process (masked) by overwriting them with '#'. Upon leaving the Editor (by pressing the DUE1 key) the last comparison step is repeated.

R Return: Exit the "Test Options" menu.

Note:

The automatic Regression test mode is not tied to a terminal, and can be run in Batch mode. In this case, the masks are saved in the Hardcopy protocol not in a 1 to 1 screen format.

Example:

Command sequence to run the automatic Regression test in Batch:

/SYSFILE SYSDTA=(SYSCMD)
/SETSW ON=(1,4)
/EXEC CFS
*002 FILE=NO
OC1/LOGON ......
RES file,C,A,HC=CFS.HARDCOPY,O
LOGOFF NOSPOOL
END