Configuring Command Files

In This Section:

Variables

Comments

Commands

Scripts

Commonly Used Commands

A command file is an input file for the batch client. It can contain one or more of the following:

• Commands

• Variables, declarations, and assignments

• Comments

The following excerpt is an example of a command file.

// Test Script
set bpmaserverurl=http://localhost/hyperion-bpma-server;
set workspaceurl=http://localhost:19000/workspace;

login admin,password;

set ApplicationName = 'Sample';

// Delete some members
Delete Member
	Properties(MemberName, DimensionName, ParentName, DeleteAllDescendants)
	Values('M1-1-1', 'A1', 'M1-1', true);
	
Delete Member
	Properties(MemberName, DimensionName, ParentName, DeleteAllDescendants)
	Values('M1', 'A1', '#root', false);
	
Delete Member
	Properties(MemberName, DimensionName, ParentName, DeleteAllDescendants)
	Values('M1', 'A1', '#root', true);

Delete Dimension
	Properties(DimensionName)
	Values('A1');

Delete Dimension
	Properties(DimensionName)
	Values('E1');

Delete Application
	Properties(ApplicationName, WaitForCompletion)
	Values('TestApp1');


set ApplicationName = '';

// Delete shared dims
Delete Dimension
	Properties(DimensionName)
	Values('S1');
	
quit;

Most of the commands in a command file execute immediately. However, EXECUTE commands can take a long time to execute and support a WaitForCompletion parameter. All execute commands support this parameter, except for DIMSYNCRONIZATION. For example, you can use a WaitForCompletion parameter to force the batch client to wait for command execution. The following command shows an example of the WaitForCompletion parameter. In this case, the administrator is executing a data synchronization command, which can take longer to run. Other commands that take longer to run include imports and application deployments.

execute datasynchronization
     parameters(DataSynchronizationName, DataTransformationOperator, DataTransformationValue, FileName,ValidateOnly, WaitForCompletion)
     values('CommaSync3', '*', '1.2345', '', 'false', 'true');