RETRIEVE

Use

RETRIEVE ( <parameter> , <command interface> ).

This command reads data that was written, by a STORE command, in a log during an earlier (see below for an exception) execution of a test script, and assigns the data to a parameter. The parameter name need not be identical to that used earlier by the STORE command. The parameter can be a simple parameter, a structured parameter, or a table parameter.

The data values are displayed in the log in a similar manner to the LOG command, but with the addition of the selection criteria (used to find the relevant log containing the STORE command) that you specified in the command interface, and the selection values used.

You enter selection criteria as fixed values, parameters, or eCATT special variables (such as &USER). You can also leave any of the selection fields empty, in which case they will be ignored. An asterisk at the end of a selection value stands for any characters (for example, ‘I_PAR*’).

Selection Field

Description

PARAM

Name of the stored parameter. If this field is empty, the name of the target parameter is used.

SCRIPT

The script containing the STORE command.

VARID

Variant from a test configuration.

LOGID

Log number.

STARTUSER

User that executed the test. (SY-UNAME, not remote user).

SYSDATACONT

System data container.

TARGETSYSTEM

Target system.

DESTINATION

RFC destination.

MASTERSCRIPT

Name of the highest level test script in the execution that contained the STORE command.

STARTDATE

Start date.

TARGETSYSID

System ID of the target system (SY-SYSID 3 characters).

TARGETCLIENT

Client of the target system.

TARGETLANGU

Logon language of the target system.

If more than one log entry satisfies the selection criteria, the latest one in the newest log will be selected.

If the structures of the parameters in the STORE and RETRIEVE commands are different, eCATT assigns values between fields of the same name in a similar manner to the ABAP command MOVE-CORRESPONDING.

You can retrieve data from the current execution by entering &LOGID in the LOGID field.