User Input File Requirements

Transaction Argument Files

A Transaction Argument File contains argument values for a particular parameter type that will be passed to a transaction procedure that requires an argument of that type during the execution of a transaction. Each parameter declared in the Transaction Prototype File corresponds to a Transaction Argument File, except for the first parameter with parameter type "Connection". The user must provide the path to the directory ( Transaction Argument Files Directory ) that contains all the transaction argument files before an experiment begins.

   File Name Restriction

TransactionProcedureParameterName + ".arg"

The name of a Transaction Argument File must agree with the parameter name declared in Transaction Prototype File. For example, if the Transaction Prototype File contains the following transaction signature:

int Login (Connection con, String user, String password ) ;
then the user must provide the argument file "user.arg" for the parameter "user", and the argument file "password.arg" for the parameter "password". If the same parameter appears in more than one transaction prototype, only one argument file for that parameter is required.

Note: No argument file is needed for the first parameter "con" of type "Connection" in the above transaction prototype.

   Content Convention

One argument value per line.

   Sample Files (With arguments)

int Login (Connection con, String user, String password ) ;

( File name: user.arg )

Amy
Cathy
Helen
Brian
John
( File name: courses.arg )
CSE100
ESE320
EGL210
BIO151
MAT309

   Sample Files (Without arguments)

int Login (Connection con) ;

For this case, in the "Argument Files Directory" filed just fill the arbitrary path that is a empty folder. (no files under this folder)


Back to User Input File Requirements

Back to Help Contents