Move your mouse round the image for details.

This Meta-Update controls server logging. You can configure the script to have a default extension and path or specify both in the argument.

[Main] declares script arguments and usage.

[Do] turns off logging, and if logging is to be turned on, it Launches [DoOn] to set the log file and turn on logging.

[Do]'s AssignInit] turns off logging (unless already off) by setting the automatic field DEBUG_MODE in the Tag: AR_INFO.

[Do] is an example of a Control Section with no iteration. You can use these to update sequences of records.

[DoOn] is Launched by [Do] if and only if logging is not to be turned off.

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, do initial and terminating assignments, and give usage information.

Here we have one required argument and two optional arguments: -log, -off and -dbg.

Use -log to set log files.
Use -off to turn off logging.
Use -dbg to override the configured log level

Usage examples:

SwLogs.ini   Do
	-log my
SwLogs.ini   Do
	-log /home/ARS/logs/my.log
SwLogs.ini   Do
	-dbg 16 -log my

Move your mouse round the image for details.

[Do] — a Control Section

[Do] is a Control Section that does not loop. It does the section once only.

[Do]'s AssignInit section simply turns off logging by assigning 0 (zero) to AR_INFO, DEBUG_MODE.

Move your mouse round the image for details.

[Do]'s AssignInit= specifies a list of assignment sections to process

[Do-asgInit] has a single statement that simply turns off logging by assigning 0 (zero) to AR_INFO, DEBUG_MODE.

The conditional on the statement means that if Server is not logging, nothing will be done.

[DoOn] — a Control Section

A Control Section can Launch other control sections.

In this case, [Do] Launches [DoOn] if and only if server logging is being turned on.

[DoOn] is also a Control Section that does not iterate.

It uses an Update= to update a single hard-coded record in a vendor form introduced in 7.1.

After the Update= is completed, by using an AssignTerm=, it sets AR_INFO, DEBUG_MODE to either the supplied argument or the configured default.

This is done through the AssignTerm= assignments.

Move your mouse round the image for details.

[DoOn] uses an AssignTerm to specify assignments to be fired after all iterations thrrough a section are done. That means all Updates are completed.

The Update= set all the log files up.

After the Update= is completed, by using an AssignTerm=, it sets AR_INFO, DEBUG_MODE to either the supplied argument or the configured default.