Administering Enterprise Lists using administration scripts

This topic provides information about administering Enterprise Lists using Enterprise Lists administration scripts.

The Enterprise List administration scripts provide a bulk administration tool to add and delete individual network addresses or ranges of addresses to and from a specified Enterprise List.

You must complete the following steps to administer Enterprise Lists using administration scripts:

1. Create the Enterprise Lists if necessary
2. Create the input files
3. Transfer the input files to Message Networking
4. Execute the administration scripts

Create the Enterprise Lists

If you are adding subscribers to an Enterprise List, you must create the list, if it does not already exist, before proceeding. See Creating a new Enterprise List and complete the steps to create a list on the system.

Creating the input files

Two file formats are supported by Message Networking:

• Format Option 1 by List ID: In this format, the filename indicates the ID of the list you want to add or delete subscribers from, and the file lists the network addresses of the subscribers you want to add or delete. Use this format when you want to add or delete subscribers to or from an individual Enterprise List.
• Format Option 2 by List ID and subscriber: In this format, the contents of the file specifies the Enterprise Lists IDs as well as the subscribers you want to add or delete from each of the specified lists. Use this format when you want to add or delete subscribers to or from multiple Enterprise Lists.

Format Option 1 by List ID

The following ASCII file names are associated with the format by list ID:

• <list id>.add to add members
  (Example: 1234567890.add)
• <list id>.del to deleted members
  (Example: 1111112223.del)
• <list id>.add.log or <list.id>del.log is created logging list actions
  (Example: 1234567890.add.log)
• <list id>.add.done or <list id>.del.done is a file created after execution of the script
  (Example: 1234567890.add or 111112223.del.done)

The following is a sample ASCII file format by subscriber that adds an individual subscriber and a range of subscribers to a list:

9085761111|9085765555
9085553232
<EOF>

In this example, if you create an input file named 1234567890.add with the format listed above, you are instructing the system to add the listed network addresses to the Enterprise List with the ID 1234567890. This format allows one line for each subscriber or range of subscribers. The last line of the ASCII file format must be <EOF>.

Note: To delete all files within a list ID, the delete file must contain the following:

ListID.del
all
<EOF>

You must place all on a separate line.

Format Option 2 by List ID and List subscriber

The following ASCII file names are associated with the format by string:

• <string>.add to add subscribers
  (Example: cat.add)
• <string>.del to delete subscribers
  (Example: cat.del)
• <string>.log is created logging list actions
  (Example: cat.log)
• <string>.add.done or <string>.del.done, which is a file created after execution of the script
  (Example: cat.add.done or cat.del.done)

The following is a sample ASCII file format by list ID and list subscriber:

4444444444|7328172222
5555555555|6148631111
5555555555|9085761111|9085765555
<EOF>

In the example, you specify the ID of the Enterprise List, followed by the subscriber or range of subscribers that you want to add or delete. This format allows one line for each subscriber. The last line of the ASCII file format must be <EOF>.

Transferring the input files to Message Networking

After you create the input files, use FTP to transfer the files from the customer-supplied FTP application installed on a remote system to the /iclog/icftp/elist directory of the Message Networking system. Message Networking prompts you for the icftp login and password to establish a connection with the customer-supplied FTP application software. For information on how to use your FTP application software, see the documentation that came with your FTP application software.

Executing the Enterprise List administration scripts

Complete the following steps to execute the Enterprise List administration scripts using the input files you generated to add or delete subscribers from an Enterprise List:

1. Start at the Administration menu, and then select Message Networking Administration > Enterprise List Administration > Execute List Administration Script.

   The system displays the Execute List Administration Scripts page, which lists all files in the /iclog/icftp/elist directory with the .add or .del extension.

   Note: If the system does not find any files with the proper extensions in the /iclog/icftp/elist directory, the system displays a message that no loading files are available.

2. Click Execute to implement the changes specified in the input files.

   The system displays a message when it finishes executing the files and prompts you to transfer the .log file for additional details.

3. Transfer the .log file from the /iclog/icftp/elist directory of the Message Networking system to the customer-supplied FTP application. When prompted, enter the icftp login and password.
4. Review the file to ensure that the operation completed successfully.
5. View the List Detail Report for the Enterprise Lists you modified to verify the membership changes to the list.
6. Click Return to Main to return to the Administration menu.

Top of page