fpt: Start numbering or record/replay calls

fpt and WinFPT Reference Manual - Command-line Commands

| SimCon Home | Ref Manual Home |

NUMBER RECORD / REPLAY CALLS

Syntax:

NUMBER RECORD [/] REPLAY [CALLS] FROM [:] <integer>

Function:

The command INSERT RECORD / REPLAY instructs fpt to instrument the code to capture or to replay data at I/O and other interfaces. For example, the statement

READ(8)(CLREC(I),I=1,5)

is instrumented to read

IF (REPLAY_IO(173,8)) THEN READ (RR_LUN_FOR_REPLAY,*)(CLREC(I),I=1,5) ELSE READ (8)(CLREC(I),I=1,5) ENDIF IF (RR_INPUT_RECORD_F) THEN WRITE (RR_LUN_TO_RECORD_INPUT,*)(CLREC(I),I=1,5) ENDIF

Replaying of the READ statement from previously captured data is controlled by the function REPLAY_IO. The first argument to this function is a sequence number which is used to identify the call-site. The second argument is the logical unit number.

A problem arises when record/replay is used in a large program under development. Every time an I/O statement is changed, all of the sequence numbers in the entire program may change. The entire program must then be rebuilt, and data captured in previous runs becomes unusable. The command NUMBER RECORD/REPLAY CALLS is used to force the numbering to a known value at the start of a file. Changes in numbering are then limited to a small area of code which has changed.

The command is written in the FSP file which describes the program, immediately before the file for which the numbering is to be set.

Where to Use this Command

Operating system command line	No
Configuration file, config.fsp	No
Specification (fsp) files, *.fsp	Yes
Interactively, to FPT> prompt	No
Interactive command files	No
Embedded in the Fortran code	Yes

Default

All RECORD/REPLAY calls are numbered sequentially by default.

Examples

! hsim1.fsp 22-Aug-02 AHM % primary input directory: /home/john/helisim/hsim1 % number record / replay calls from : 1000 hsim1.f % number record / replay calls from : 1200 getdat.f % number record / replay calls from : 2000 aero.f % number record / replay calls from : 3000 trotor.f eng1.f fuel.f % number record / replay calls from : 3200 contr.f laws.f % insert record/replay ! End of hsim1.fsp