Specifies a catalog that can run using this MiniVend server. There are three required parameters, separated by spaces and/or tabs.
The first is the name of the catalog -- it will be referred to as that name in error, warning, and informational messages. It must contain only alphanumeric characters, hyphens, and underscores.
The second is the base directory of the catalog. If the directory does not contain a catalog.cfg file, the server will report an error and refuse to start.
The third directive is very important to get right -- it is the SCRIPT_NAME of the vlink program that runs the catalog. It must be unique from other CGI program paths that run on this server -- that is how the catalog is selected for operation.
Catalog simple /home/minivend/simple /cgi-bin/simple /simple
You can specify any number of alias script names as additional parameters. This allows the calling path to be different while still calling the same catalog -- it is most probably useful when calling an SSL server or a members-only executable that requires a username/password via HTTP Basic authorization. All branched links will be called using the aliased URL.
Optionally, you can call individual Catalog lines that specify the different parameters. The equivalent of the above
is:
Catalog simple directory /home/minivend/simple
Catalog simple script /cgi-bin/simple
Catalog simple alias /simple
You can also specify global directives that will change for that catalog only. This is mostly useful for ErrorFile and DisplayErrors:
Catalog simple directive ErrorFile /var/log/mvend/simple_error.log