samsimul

Name

samsimul - Simulates a series of requests or state changes and displays the expected results.

Synopsis

samsimul [-h][-T][-V] [Input_file_name]

Description

The samsimul command simulates a series of requests against the automation engine or operational state changes of individual resources. If an input file name is given, samsimul reads a description of the requests or state changes to be simulated from the specified file. If the input file name is omitted, samsimul reads that description from standard input.

Upon completion of the simulation, samsimul writes the expected results of the simulated requests or state changes to standard output.

Options

-h: Writes the command's usage statement to standard output.
-T: Writes the command's trace messages to standard error. For your software-service organization's use only.
-V: Writes the command's verbose messages to standard output.

Parameters

Input_file_name

Specifies the name of a file that contains a description of the requests or state changes to be simulated. Each line of the file describes a single request by means of six space-separated values:

The name of the resource or resource group to be started, stopped, canceled, moved, or considered failed, online, or offline.
A sequence number denoting the relative point in time when the request would be submitted. Multiple requests with identical sequence numbers would be submitted simultaneously.
A priority code stating the relative importance of the request with regard to other requests within the resource structure. Possible values are "low", "high", and "force".
An action code denoting the type of request or state change to be simulated by the automation engine. Possible values are "start", "stop", "move", "cancel", "failed", "online", and "offline".
An originator code denoting the source of the request. Possible values are "Operator", "ExtSched", and "Automation".
A comma-separated list of nodes to which the request or state change applies.

Lines beginning with the "#" character (hash mark) are considered comments instead of request or state change descriptions. These can be used as annotations and are disregarded by samsimul. Empty lines, including those containing only space or tab characters, may be used to visually structure the input file and are disregarded by samsimul.

Security

This command requires root authority, or a user ID with appropriate permissions. For more information, see Setting up non-root user Ids for the command line interface.

Exit Status

0: The command ran successfully.
1: Error occurred with RMC.
2: Error occurred with CLI script.
3: Incorrect flag on command line.
4: Incorrect parameter on command line.
5: Error occurred with RMC that was based on faulty command line input.

Examples

To simulate a resource start and subsequent failure, enter:
```
samsimul input_file	
```
With input_file containing the following lines:
```
IBM.ResourceGroup:samba 0 high start Operator node1
IBM.Application:samba:samba1 1 high failed Operator node1
```
These two lines simulate an online request against the samba resources group, followed by a failure of its first resources. The response should be:
```
samba/ResGroup/IBM.ResourceGroup    1 offline
samba1/Fixed/IBM.Application/node1  1 online
samba/ResGroup/IBM.ResourceGroup    1 online
samba/ResGroup/IBM.ResourceGroup    2 online
samba1/Fixed/IBM.Application/node2  1 online
samba/ResGroup/IBM.ResourceGroup    2 online
```
The first column refers to the resource, the second to the step number, and the last to the current state. In the first step, the resource group goes from offline to online. Due to the simulated failure of samba1 on the first node it goes back to offline, but the failover takes place and samba1 on the second node is started.

Files

/usr/sbin/rsct/bin/samsimul: Location of the samsimul command.