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: 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

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.