Stat/Transfer Program Generation
Previous Topic  Next Topic 

These options control the generation of command processor programs by the Stat/Transfer user interface, whether automatically at the end of each transfer or manually, when the Save Program button is pressed by the user.


The programs will contain all options that are necessary to completely reproduce the transfer and are useful not only to re-run your transfer in the future, but also, together with the log files, as documentation of your work. The programs can be re-run by opening them in the Run Program dialog box, or by running them directly from the operating system or the command processor itself.


Automatically generate command processor program

If this option is checked a program will be generated at the conclusion of each transfer operation.  This program will contain all of the settings that are necessary to reproduce your transfer operation.  If you would like a program to be generated after each transfer, check this option.  It is unchecked by default.


Filename

When this option is selected, then by default, Stat/Transfer will write the file to the same directory as your output file and give it the same name as your output file, but with a .stcmd extension.  If you would like to change the location or the name, you can do so in the Filename edit box.  Because this will be used for every transfer, you should not type in a specific name, but you can, if you wish, use a specific directory. We recommend that you use the following macros to specify the file name and also to specify a directory if you do not choose a specific one.


%ipath% The path, including the drive (on Windows), of the input data file

%iname% The name, without the extension, of the input data file

%opath% The path, including the drive (on Windows), of the output data file

%oname% The name, without the extension, of the output data file


You should always use the .stcmd extension.


The default filename is %opath%/%oname%.stcmd.


Ask Permission before overwriting the program file

This option controls automatic program generation.  If checked (the default) you will be prompted before program files are overwritten.


Ask Permission before overwriting the output file

This option controls the "overwrite" option that will be written to a generated program, both for automatically generated programs and those generated from the Save Program button on the Transfer dialog box.


If it is checked, the default, when the program is run, you will be asked permission before an output data set is overwritten.  If it is not checked the '-y' option will be appended to the copy command in the program so your output data files will be overwritten without prompting.


Insert "Quit" at end of program

If this option is checked, programs run from the command processor prompt or the operating system will cause the Stat/Transfer command processor to terminate at their conclusion.  It will not affect the behavior of programs run from the Run Program dialog box.


This option is checked by default because it allows you, for example, to click on a program in Windows Explorer to have it run and then cleanly terminate.  However, you may wish to keep the command processor open to examine the results or run other programs, or execute a series of programs from another.  In that case, you would not want 'quit' to be inserted at the end of your programs.