Microsoft Identity Integration Server 2003 Reskit graphic

MASequencer

MASequencer is used to automate the order in which management agents are run. It can also perform stop, resume, or pause operations interactively on the management agents. MASequencer uses input from an XML file, which contains information about the management agents to be sequenced.

Syntax

masequencer /f:Filename [/s:Servername] [/u:[Domain\]Username [/p:Password]] [/l:Loglevel]

Parameters

/f:Filename

Specifies the path of the XML input file which contains the details of the management agents to be sequenced.

/s:Servername

Specifies the name of the MIIS 2003 server where the management agents to be sequenced are stored. If no server is specified, then the local MIIS 2003 server is used.

/u:[Domain\]Username

Specifies the user account used to authenticate to the specified server. The user account must be a member of the MIISAdmins security group in order to run MASequencer. If the specified server name is the local host, then the credentials from the logged on user are used, and the user name and password parameters are ignored.

/p:Password

Specifies the password for the user account used to authenticate to the specified server. If the specified server name is the local host, then the credentials from the logged on user are used, and the user name and password parameters are ignored.

/l:Loglevel

Specifies the message, warning and error logging level. The possible values are:

1 – Logs messages, warnings, and errors.
2 – Logs warnings and errors.
3 – Logs errors only.

If the log file name and path is not specified in the XML file, then the log file is created in the current working directory with the name MASequencer.log. If the /l: parameter is not specified, the default log level is set to 1.

/?

Displays help at the command prompt.

Remarks

MASequencer can be run from the local system where the MIIS 2003 service is installed, or from a remote system by using the appropriate credentials.
A sample XML input file, SampleMASequencer.xml, is provided and installed with the MIIS 2003 Resource Tool kit.

Examples

To sequence management agent runs on a local machine with MIIS 2003 installed, type the following command:

masequencer /f:SampleMASequencer.xml /l:1

To sequence management agent runs on a remote MIIS 2003 server, log only warnings and errors, and be prompted for the password, type the following command:

masequencer /s:MIISRemote /u:RemoteUser /f:c:\SampleMASequencer.xml /l:2

To sequence management agent runs on a remote MIIS 2003 server by specifying the user name and password on the command line, type the following command:

masequencer /s:MIISRemote /u:RemoteUser /p:RemotePassword /f:SampleMASequencer.xml

MASequencer errors and warnings

Error code	Description
1413	The MA element under an Item element of the Thread element is not specified.
1414	The RunProfile element under an Item element of the Thread element is not specified.
1417	The MIIS 2003 service is not running on the specified server.
1418	The MIIS 2003 service was not found on the specified server.
1419	The Preprocessing or Postprocessing command specified under a management agent could not be executed.
2326	The user does not have rights to run a management agent. The user needs to be a member of the MIISAdmins security group or MIISOperators security group.
2327	The XML input file does not have a Console attribute for MARunScheduler
2328	There must be at least one Thread element in the XML file.
2329	The root element of the XML input file must be MARunScheduler.
2331	The management agent specified in the XML input file cannot be found on the MIIS 2003 server.
2332	There is more than one Preprocessing element for an Item in the XML input file.
2333	There is more than one MA element for an Item in the XML input file.
2334	There is more than one RunProfile element for an Item in the XML input file.
2335	There is more than one WaitMinutes element for an Item in the XML input file.
2337	The RepeatCount attribute value of the Thread element in the XML input file is not valid.
2339	The Console attribute of the MASequence element in the XML input file is not valid.
2341	There should be at least one Item under a Thread element in the XML input file.
2343	Invalid value for WaitMinutes tag. The value must be from 1 through 120.
2344	Invalid Log file specified. The file either doesn't exist or cannot be accessed.
2346	There is more than one Postprocessing element for an Item in the XML input file.
2347	The user name is not specified in the command line.
2348	The command line syntax is not valid.
2349	The server name specified is not valid.
2350	Access to a particular management agent or MIIS 2003 server is denied.
2352	The thread was terminated due to a ThreadAbortException occurrence.
2355	The thread could not contact the specified MIIS 2003 server service.
2357	A problem was encountered during the parsing of the XML input file. Verify the XML input file.
2358	The server specified at the command line is not a valid MIIS 2003 Server.
2359	There is more than one ContinueOnFailure element for an Item in the XML input file.

Common command-line errors and warnings

Error	Description
2004	A string value was expected for the parameter but the value is not specified.
2006	The date specified is not a valid date.
2007	The time specified is not a valid time.
2008	The computer name specified is not a valid DNS computer name.
2009	The computer name specified is not a valid computer name.
2010	The user name specified is not a valid user name.
2011	The file name specified is not a valid file name.
2012	The path specified is not a valid path.
2014	The file path specified is not a valid file path.
2015	A parameter was specified without a "/" or "-" character preceding it.
2016	A specified parameter is not valid for this application.
2017	A specified integer value is not a valid integer.
2020	A mandatory value for a parameter was not specified.
2021	A value was specified for a parameter that does not allow any values.
2026	A parameter value was specified where the application was not expecting any value for the parameter.
2027	A parameter that is only allowed to occur once was specified more than once.
2028	A parameter that is allowed to be repeated n times was repeated more than n times.
2029	A mandatory parameter was not specified.
2033	A specified parameter value is not in the list of allowed values for that parameter.
2035	The application failed to create a log file. A file already exists with the same name, and is marked Read Only or Hidden.