TSECIMP

Imports assignment information from an Extensible Markup Language (XML) file into the TAPI server security file (tsec.ini). This command can also be used to display the list of TAPI providers and the lines or devices associated with each provider, validate the structure of the XML file without importing the information, and check domain membership.

TSECIMP [{-? | -h}]

TSECIMP -f file_name [-u] | -v]

TSECIMP -d

none

-? | -h (NTXP ONLY)

Displays help.

-d (NTXP)

Displays a list of installed telephony providers. For each telephony provider, the lines or devices associated with that provider are listed, as well as the addresses and users associated with each line or device.

-f file_name (NTXP)

Specifies the name of the XML file that contains the assignment information that you want to process.

-u (NTXP)

Checks whether each user is a member of the domain specified in the XML file. The computer on which you use this switch must be connected to the network. Significantly slows performance, so you might not want to use it if you are processing a large amount of user assignment information.

-v (NTXP)

Validates the structure of the XML file without importing the information into the tsec.ini file.

none.

The XML file from which you want to import assignment information must follow the structure:

UserList element

The UserList is the top element of the XML file.

User element

Each User element contains information about a user who is a member of a domain. That user might be assigned one or more line or phone devices. Each User element might have an attribute called "NoMerge". If this attribute is specified, all current line and device assignments for the user are removed before new assignments are made. This attribute allows the administrator to quickly remove unwanted user assignments. By default, this attribute is not set.

The User element must contain a single DomainUserName element, which specifies the domain and user name of the user. The User element might also contain one FriendlyName element, which specifies a friendly name for the user.

The User element might contain one LineList element. If no LineList element is present, all lines or devices for this user are removed.

LineList element

The LineList element contains information about each line or device that might be assigned to the user. Each LineList element can contain more than one line element.

Line element

Each Line element specifies a line or a device. You must identify each line or device by adding either an Address element or a PermanentID element under the Line element.

For each Line element, you can set the "Remove" attribute. If you set this attribute, the user will no longer be assigned that line or device. If this attribute is not set, the user will gain access to that line or device. No error is given if the line or device is not available to the user.

none.

none.

External

DOS

none

Windows

none

Windows NT

NTXP NT2003