The System Management Hub supports a batch interface called ARGBATCH, which can be used to create and run Tamino-specific routine jobs, for example to create databases and back them up at regular intervals. In the following, you will find a short introduction to the command line interface to get you started:
On Windows, the argbatch command line interface can be started as follows:
To start argbatch
Open a Windows command prompt.
Set the working directory to the location of the argbatch.exe executable, for example:
cd C:\Program Files\Software AG\System Management Hub\bin
Start the argbatch.exe executable.
On UNIX, run the shell script sagenv.new. It is located in the Tamino installation directory. In the Bourne Shell, enter the following command:
. <installation directory>/sagenv.new
where <installation directory> is the root directory of the Tamino installation.
The batch interface offers online help that is displayed automatically when you start the executable. Please refer also to the description of the batch interface in the documentation set of the System Management Hub for further information. The documentation is available under the installation directory of the System Management Hub, for example C:\Program Files\Software AG\System Management Hub\documentation\en\overview.htm.
Most of the argbatch commands require that you provide your username
and password. To avoid typing in username and password for each command, it is
recommended to first use the set environment command
to set your username and password. Settings exceed session lifetime and are
valid for the current user until they are overwritten with new values in a new
set environment command, or until they are cleaned
with the clear environment command.
To set the environment, enter the following:
argbatch set environment
user=myusername
password=mypassword
Replace myusername and mypassword with your own name and password.
Furthermore, you should also define the product for your argbatch session. It is also possible to set the product version for the argbatch session, but this should be handled with care and only by done exceptionally:
Product version should not be set if only one version of the product is installed. In this case, the version is used by default.
Product version should not be set if more than one version is installed and the mainly used version is the newest version (default).
If argbatch commands are used for older database versions, the correct version will be retrieved based on the given database name, if specified. This means, that even in this case the version should not be set in the environment.
One good reason to set the version in the environment is if you have two or more product versions installed and the mainly used version is not the newest version. Then, it is helpful to set the version to the mainly used verison.
To define the product and - if necessary - the product version, display a list of available products and versions by entering the following two command:
argbatch show products
A list of available products is displayed, among them the product
Tamino.
argbatch show versions product=Tamino
All installed versions of Tamino are displayed.
Now set the environment to the product Tamino and the version you are using, e.g. version 8.1.1:
argbatch set environment
product=Tamino
version=8.1.1
Alternatively, you can also use the environment variables
ARGBATCH_USER and
ARGBATCH_PASSWORD to specify your username and
password. If these two environment variables have been defined, their values
will be taken. Specifying user and password directly as parameters in the batch
command will override these values.
To display a list of available Tamino argbatch commands, use
argbatch show commands. If you have set the environment as
described in section Setting the
Environment, a list of all commands that are available for
the installed Tamino version is displayed.
If, for example, you want to stop a database with an argbatch command,
use the command argbatch show databases to display a list of
databases that are currently defined in Tamino. Then use stop
database in the following way to stop one of the databases:
argbatch stop database
database=mydatabase
where mydatabase is the name of the database
you want to stop. If you need detailed information on the stop
database command, enter argbatch stop database
helplong. (The parameter helplong shows detailed
information, whereas the parameter help only gives the
parameter options.)
Note that list parameters for argbatch commands must be given in the right sequence. For details, see the argbatch online help.
The following argbatch commands are available for Tamino. Use
argbatch commandname helplong to
display detailed online information about how to use the command:
Note:
The order of available parameters for the commands is not arbitrary.
Refer to the online help of the individual commands for additional
information.
| Commands |
|---|
| clear environment |
| set environment |
| show environment |
| show commands |
| show products |
| show requests |
| show versions |
| show targetnodes |
| add commonadmin |
| confirm alertedjobs |
| confirm job |
| delete commonadmin |
| delete completedjobs |
| delete job |
| show alerts |
| show commonadmin |
| show commonadmins |
| show completedjobs |
| show job |
| show jobs |
| show runningjobs |
| show suspendedjobs |
| add ace |
| add administrator |
| add databasespace |
| add location |
| add replication |
| add webserver |
| assign webserver |
| backup database |
| check database |
| create acl |
| create database |
| create dbfrombackup |
| create domain |
| create group |
| create user |
| delete acl |
| delete administrator |
| delete backup |
| delete database |
| delete databasespace |
| delete domain |
| delete group |
| delete location |
| delete user |
| delete webserver |
| delete webserverassignment |
| expand databasespace |
| get replicationlist |
| install extension |
| list acls |
| list groups |
| list users |
| modify acl |
| modify domain |
| modify executionmode |
| modify externalname |
| modify group |
| modify journalspace |
| modify locationsettings |
| modify parameter |
| modify privatepath |
| modify property |
| modify publicpath |
| modify user |
| modify webserver |
| move databasespace |
| move location |
| prepare cddatabase |
| register cddatabase |
| remove replication |
| rename database |
| rename location |
| rename webserver |
| reset replication |
| restore database |
| set databaseversion |
| set defaultbackuplocation |
| set defaultlocation |
| set portrange |
| set replication |
| show acesofacl |
| show acls |
| show aclsofgroup |
| show administrators |
| show backupfiles |
| show backups |
| show backupstructure |
| show databases |
| show databasespaces |
| show databasestatus |
| show descriptionofuser |
| show detailsofdomain |
| show domains |
| show extensiondetails |
| show extensions |
| show extensiontracestate |
| show groups |
| show groupsofacl |
| show groupsofuser |
| show information |
| show locations |
| show locationsettings |
| show permissionsofacl |
| show properties |
| show publicpath |
| show taminoversions |
| show users |
| show usersofgroup |
| show versioninformation |
| show webservers |
| start database |
| stop database |
| stop requests |
| switch extensiontraceoff |
| switch extensiontraceon |
| switch logspace |
| uninstall extension |
| unregister cddatabase |