Welcome to the Cyara Knowledge Center

ChangeDirectory

ChangeDirectory>path

Changes the current directory to the directory specified in path. path can be a literal string or a variable.

Abbreviation : Cha

ChangeDirectory Example

ChangeDirectory>c:\program files\my directory\

FileDate

FileDate>filename,result

Returns the file date of filename in the result variable.

The date returned is in the format YYYYMMDD

filename can include a full path.

Abbreviation : FDT

FileDate Example

FileDate>c:\program files\myfile.exe,MyFileDate

FileSize

FileSize>filename,result

Returns the size of filename in the result variable.

The size is returned in bytes.

filename can include a full path.

Abbreviation : FSZ

FileSize Example

FileSize>c:\program files\myfile.exe,MyFileSize

FileTime

FileTime>filename,result

Returns the file time of filename in the result variable.

The time returned is in the format HHMMSS

filename can include a full path.

Abbreviation : FTM

FileTime Example

FileTime>c:\program files\myfile.exe,MyFileTime

IfDirExists

IfDirExists

IfDirExists>directory_name[,label_name[,false_label_name]]
statements 
[ [Else 
else statements] 
Endif ] 

If directory_name exists the first statements are executed. Otherwise the else statements are executed.

When label names are provided execution jumps to the specified label if the directory specified in directory_name exists. If a second false label is specified, execution will jump to that label if the expression resolves false. Subroutine names can also be specified. When specifying a subroutine name execution will jump to that subroutine and return when the subroutine has completed. If label names are specified Else and Endif are ignored and are unnecessary.

Abbreviation : IFD

IfDirExists Example

IfDirExists>c:\myfolder\temp 
MessageModal>temp folder exists - good 
Else 
	CreateDir>c:\myfolder\temp 
Endif

IfFileExists

IfFileExists

IfFileExists>filename[,label_name[,false_label_name]]
statements 
[ [Else 
else statements] 
Endif ] 

If filename exists the first statements are executed. Otherwise the else statements are executed.

When label names are provided execution jumps to the specified label if the file specified in filename exists. If a second false label is specified, execution will jump to that label if the expression resolves false. Subroutine names can also be specified. When specifying a subroutine name execution will jump to that subroutine and return when the subroutine has completed. If label names are specified Else and Endif are ignored and are unnecessary.

Abbreviation : IFE

IfFileExists Example

IfFileExists>c:\myfolder\myfile.txt
ReadFile>c:\myfolder\myfile.txt,fileContents 
Endif

IfNotFileExists

IfNotFileExists

IfNotFileExists>filename[,label_name[,false_label_name]]
statements 
[ [Else 
else statements] 
Endif ] 

If filename does not exist the first statements are executed. Otherwise the else statements are executed.

When label names are provided execution jumps to the specified label if the file specified in filename does not exist. If a second false label is specified, execution will jump to that label if the expression resolves false (the file exists). Subroutine names can also be specified. When specifying a subroutine name execution will jump to that subroutine and return when the subroutine has completed. If label names are specified Else and Endif are ignored and are unnecessary.

IfNotFileExists Example

IfNotFileExists>c:\myfolder\myfile.txt
WriteLn>c:\myfolder\myfile.txt,wres,This is a New File
Endif