TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


engine:import:setvar2file

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
engine:import:setvar2file [2018/08/14 21:39] – created dcummingengine:import:setvar2file [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 1: Line 1:
-setvar2file+====== SetVar2File ======
  
-==== SetVar2File ==== 
 Set a local variable to a file name that matches the defined criteria. Set a local variable to a file name that matches the defined criteria.
  
-==== Phase ====+===== Phase ====
 This instruction is used by the TapeTrack INI Engine. This instruction is used by the TapeTrack INI Engine.
  
-==== Syntax ==== +===== Syntax ====
-**SetVar2File**//(varname, filter, field, offset);//+ 
 +''SetVar2File(varname, filter, field, offset);'' 
 + 
 +^ Variable ^ Type ^ Description ^ Min Length ^ Max Length ^ Min Value ^ Max Value ^ 
 +|varname| String | The name of the local variable that is to be set.| 1 | 16 | 
 +|filter| String | A filter that matches the file that you want to select.| 1 | 256 | 
 +|Field| String | The field to pre-sort the selected pathnames before selection (NAME, CREATION, LASTACCESS, LASTWRITE or SIZE).| 1 | 16 | 
 +|offset| Integer | The offset within the sorted list to select. 1 is the top, 2 is the second from the top, -1 is the bottom, -2 is 2nd from the bottom.| 1 | 11 | -214748364 | 2147483647 | 
 + 
 +===== Example =====
  
-//string varname;//\\ +Set variable MYFILE to the smallest text file in C:\stuff.
-//string filter;//\\ +
-//string field;//\\ +
-//int offset;//\\+
  
-|varname| The name of the local variable that is to be set.| +<code> 
-|filter| A filter that matches the file that you want to select.| +SetVar2File(MYFILE"C:\stuff\*.txt"SIZE-1); 
-|Field| The field to pre-sort the selected pathnames before selection (NAMECREATIONLASTACCESSLASTWRITE or SIZE).| +WriteMsg("The smallest file is $MYFILE"); 
-|offset| The offset within the sorted list to select. 1 is the top, 2 is the second from the top, -1 is the bottom, -2 is 2nd from the bottom.|+</code>
  
-==== Example ==== +{{tag> import_engine sync_engine}}
-**SetVar2File: Set variable MYFILE to the smallest text file in C:\stuff.** +
-|SetVar2File(MYFILE, "C:\stuff\*.txt", SIZE, -1);| +
-|WriteMsg("The smallest file is $MYFILE");|+
engine/import/setvar2file.1534282780.txt.gz · Last modified: 2025/01/21 22:07 (external edit)