| SimCon Home | Reference 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	No

Default:

RECORD/REPLAY calls are numbered sequentially by default.

Example:

! 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

See also:

INSERT RECORD / REPLAY