3Com VCX V7000, Maintenance Manual

Page: 157 / 344

Using Batch Mode 157
--mac-a 00:e0:bb:24:AE:56 -- mac-l 1 -–pp local
--site-id Br3
The following simple command quickly adds a user account:
user-MAC --u jjhonson --ph 2314323
The following command deletes the user account for jjohnson:
user-MAC --delete --u jjhonson
The following command changes the phone extension for the jjohnson
user account:
user-MAC --mod --u jjhonson --ph 5552121 --new-ph 5552222
Using Batch Mode
In batch mode, you create either a comma separated values (CSV) file or
an XML file to use as input for
user-MAC
command processing. Each
request (CSV line or XML transaction node) makes up a transaction.
■
An XML file can contain a mixture of add, delete, and modify
transactions.
You cannot use a modify transaction to change the site ID of a user
account. The site ID (
--site-id
) is required for a modify transaction if
the account to be changed is located at a branch site. If the account is
located on another region, the modify transaction must specify a site
ID (
--site-id
) and remote IP address (
--remote
).
■
A CSV file can contain add transactions only.
Batch mode processing can run in either stop mode (the default) or
non-stop mode (the
user-MAC
command line includes the
--non-stop
qualifier). For both modes, during the initial parse, the input file is
validated for format but not for content validity. If the parse encounters a
formatting error (for example, an angle bracket (>) is missing in an XML
file), processing stops.
■
In stop mode, if an error is found after the initial parse is complete,
processing stops.
■
In non-stop mode, if an error is found after the initial parse is
complete, the offending transaction is dumped, but processing
continues to the next transaction in the file.