Move your mouse round the image for details.

This Meta-Update script simply lists the elements of Path or a path-like variable, optionally,

[Main] declares script arguments and usage.

[Do] will loop through all delimited string elements in $V, str$ which is set in the AssignInit section.

[Do-File] will add to a CSV file but only -outf was set.

Usage examples:

Path.ini	Do	-go
Path.ini	Do	-go -outf path.txt
Path.ini	Do	-go -var SthScriptPath

Move your mouse round the image for details.

All Meta-Update Sample Scripts have plenty of comments. Feel free to edit. Use the debugger to single-step through the scripts.

[Main] is used to describe arguments, set up server connections, do initial and terminating assignments, and give usage information.

Here, we have one required argument and two optional arguments: -go, -var and outf.

If you don't want a file and want the Path, no arguments are needed. But then, Meta-Update will not be able to display the Usage instructions. Hence, -go is required.

Interestingly, [Do]'s AssignInit could be be moved here and have the same effect.

Move your mouse round the image for details.

All Meta-Update Sample Scripts have plenty of comments. Feel; free to take a copy and edit. Use the debugger to single-step through the scripts.

[ Main ] is used to describe arguments, set up server connections, have initial and terminating assignments, and give usage information.

Here we have one required argument and two optional arguments: -go, -var and outf.

If you don't want a file and want the Path, no arguments are needed. But then, Meta-Update will not be able to display the Usage instructions. Hence, -go is required.

The AssignInit could be either here in [Main] or in [Do] below.

A Control Section can Launch other control sections.

So, for example, a first section can output a People record to a file, then Launch a section that queries this person's rights and saves them in a separate file.

Similarly, when migrating say HelpDesk tickets across releases,

• A first section queries the records to be migrated on the first server.
• That launched section then Launches a series of sections
  • to loop through that ticket's Diary field entries creating or updating appropriate HPD:WorkLog entries,

In this way, trees of dependent data can be handled a complete tree at a time.

Move your mouse round the image for details.

[Do] — a Control Section

[Do] iterates through a list of semi-colon separated strings using a Loop=.

The AssignInit sets up the source string, $V, str$, as either:

• $ENV, Path$, or,
• the passed environment variable $Arg, var$.

The Loop = String iterates through the source string $V, str$ using a semi-colon (Windows) as a delimiter. In each loop, Spath, Text is set to that path element.

The AssignPre simply uses the path element Spath, Text in a message but only if -outf was not set.

With each iteration, we Launch another section [Do-File] to output the file.

Move your mouse round the image for details.

[Do] AssignInit=

Before [Do] starts, all AssignInit sections are processed.

We set a reference variable to either one of

• $ENV, Path$, or,
• use @val to extract the environment variable specified as the argument $Arg, var$ —a double reference.

Note: This AssignInit could be moved to [Main]. An AssignInit can be used repeatedly if a section is Launched repeatedly.

[ Do x6 ]

[ Do ] is a Control Section in this case iterating through a list of semi-colon separated strings.

Move your mouse round the image for details.

[DoFile] — a Control Section

[Do] Launches [Do-File] only if -outf was specified.

Then, it is Launched once per string.

The Output= tells Meta-Update to create a file named by the -outf argument as defined by [File-Def] — a single column CSV file.

[Do-File-asg] assigns the only field defined.

FldHdr causes the first row of the output file to have the field names.