__To Create a New Article (Form 117)_______________
-\group 432.tracen
-\create article
-\format lines
-\form 117
-\headline
-\field 3 text

-\field 1 text

-\insert link 1
-\position in collection shopdee


__To Create a New Collection_____________________
-\group 432.tracen
-\create collection
-\headline
-\options
-\icon
-\insert link 1
-\position in collection shopdee


__To Reposition an Item and Set Removal____________
-\group
-\context link 1
-\position in collection as item # 1
-\remove now + 10 days



Transmitted: 10/13/97 4:01 PM (habpres1)


This file contains a series of RMP Scripts showing the most common types of scripts that most Rainman Plus users will have a need for with normal use. We compiled this information because we felt that the current manual and online help was very vague and assumes that the user is familiar with certain information not previously available to them. We also feel it will help us 6 months from now when we are trying to remember how the heck we did something in the first place, that we haven't touched since we first started with RMP.

This file is not meant as a replacement for the manual or the online help, but as a supplement for quick reference.

Since this file was originally written, there have been substantial additions to Rainman, i.e., the ability to use hypertext, changeable backgrounds, etc. Keywords to know are: SYSTEMART (for icons and background tile IDs) and FORMS for the latest list of usable forms.

Basic terminology to know is:

* Group - the main Rainman group. In Internet terms, think of this as a folder in your domain.

* Collection - also known as a Page. (The updated terminology is to use page.) This is a form into which you create or link articles, libraries, etc.

* Token/arg - EVERY object on AOL has an ID. This is generally known as the token/arg (or "argument"). If you know what the T/A is, you can reference or link any object anywhere.

* mini-icon - If you have a listbox, (a list of objects in your page/collection), this is the little icon identifying the object. There is a specific list of mini-icons we use to identify a page, an article, a chat room, library, etc.

* headline - this is the object's headline in a listbox (page/collection)

* Title - this is the Title in a form. (Always field 3)

* icon - this is the identifying graphic before the Title in forms that use icons (some don't)

* text - text in an article is always field 1. And the text command is preceded with a \format lines command. This allows Rainman to recognize paragraph spacing. Otherwise, paragraphs will run together.

And finally, ALWAYS check your work and check what the object looks like or whether it's linked, even if you've received a confirmation that it has. Be mindful that there are differences between platforms and what the Mac sees vs. what the PC does.


INDEX
=====
i.- A Word About ID's and References

SAMPLE SCRIPTS
===============
1 - Create a Collection within a Collection.
2 - Create an Article within a Collection.
3 - Create an Article with a graphic displayed.
4 - Modify the Headline of existing Article.
5 - Modify the body of text in an Article.
6 - Modify the body of text in an Article and use MONO Font.
7 - Add an existing Article to an additional collection, within your IP group.
8 - Add an existing Article to an additional collection and change it's headline.
9 - Move an article from one collection to another existing collection.
10 - Get information on a collection.
11 - Add an old form (menu) to a collection. (i.e. Add the G&E Newsletter)
12 - Add an existing menu using a Token Argument (i.e. Shared Staff Conference Room Menu)
13 - Add a Conference Room to a collection.
14 - Add a Message Board to a collection.
15 - Add a Library to a collection.
16 - Create and schedule an article for release at a specified date/time.
17 - Create a netaddress
18 - Link a particular file in a library into a collection
19 - Use a changeable background in a form.
==========
==========
i. - A Word About ID's.

The ID is almost always specific to your area, i.e. -\group 305.sales and -\position in collection jansales. However, -\reference pertains to a non-Rainman ID and would be the same for anyone trying to reference it, you must be very careful when using -\reference that you have put the correct ID in.

Please note that although you use the CREATE command to add a Conference Room, Message Board and/or Library to your collection, you must have the ID for this object and REFERENCE that ID number, in order to create the object in your collection. If you do not know the ID number for the object you wish to create, your producer can supply this information.

Important reminder, ALL IDs are case sensitive and it's VERY helpful to either do all in lower case or all in upper case.

ALL of the following commands can be found in the Online Help area of Rainman Plus.

If an article is linked to other collections, you MUST NOT -\kill the article,instead just modify.

============
1) To create a collection with the ID of ABC inside a collection already existing that has the ID of XYZ.

-\group 305.sales
-\create collection ABC
-\headline The ABC's of Computers (Note: This will show on menu and title bar)
-\insert link
-\position in collection XYZ

============
2) To create an article with the id of ABC0001 inside the collection ABC.

-\group 305.sales
-\create article ABC0001
-\headline The A's of Computing.
-\format lines (Note: the current default is running, you must put lines in yourself)
-\form 117 (Note: the list of forms is available in the Online Help area)
-\field 3 text (Note: all headlines are 'field 3')
A is for Apple
-\field 1 text (Note: all main bodies are 'field 1') (USE the command \field 1 html if you're using color, hyperlinks or paragraph formatting.)
The Apple of computing........etc (Note: No ONE field can be more than 32k)
-\insert link
-\position in collection ABC

*Note - -\format lines is much like using a word processor. Giving you carriage returns and such in the same manner as your friendly word processor.

==================
3) To create an article with the ID of ABC0002, positioned in the collection ABC, that has a graphic within.

-\group 305.sales
-\create article ABC0002
-\headline The D's of Computing.
-\format lines
-\form 49 (Note: Remember, descriptions of forms are in the Online Help area)
-\field 11 text (Note: First caption is always 'field 11')
3.5 Disk
-\field 3 text
D is for Disk
-\field 1 text
Disks come in various sizes...etc.
-\rawimage 5 c:-\rmplus-\art-\disk.gif (Note: 1st graphic is always 5, 32k max size, if you have problems check your path to make sure it's correct. You can also use Binary here if you wish to compress the image. Note that previously 'sized' images will often not work well with binary.)
-\insert link
-\position in collection ABC

After saving the above file as (for example) ABC0002.txt, you would go to the directory with RM.EXE in it and type "RM ABC0002.txt". This would create a file called ABC0002.RMP which you would then upload to RAINMAN.SYS. If you already have an ABC0002.RMP and wish to create a different name, you can type "RM ABC0002.TXT ABC10002.RMP" and it will create the file ABC10002.RMP instead.

============
4) To change the headline field in an existing article with the ID of ABC0001.

-\group 305.sales
-\modify article ABC0001
-\field 3 text
A is for America Online

An important note, do NOT add the -\insert and -\position commands as this will add another article to the collection and you'll need to remove the link to remove one of them.

============
5) To modify the main body of text in article ABC0001.

-\group 305.sales
-\modify article ABC0001
-\format lines (Note, you must put this in or your new text will run together)
-\field 1 text
America Online etc.

============
6) To modify the main body of text in article ABC0001 and use MONO font.

-\group 305.sales
-\modify article ABC0001
-\format lines mono
-\form 5 (Note, you need to remind RMP of which form to use for Mono...if you had put -\format lines mono in while 'creating' the article (and not used another form number) it would automatically use form 5, as this is the only valid MONO form.)
-\field 1 text
Blah Blah Blah

============
7) To add (link) the ABC0001 article to another existing collection with the ID of DEF. The collection you're moving them too must be within your group.

-\group 305.sales
-\modify article ABC0001
-\insert link 2 (Note: Does not have to be 2...can be anything up to 255)
-\position in collection DEF

============
8) To add (link) the ABC0001 article to another existing collection with the ID of GHI and change the headline only in the GHI collection. (Note, you can put more than one series of commands in one script...i.e. you could've put the one below and the one above together)

-\group 305.sales
-\modify article ABC0001
-\insert link (Note, in this instance the link needs to come first so that all of the titles are not changed.)
-\headline Computing Today
-\position in collection GHI

Note, if you want the headline to change on all articles as you add another link, just reverse the -\headline and -\insert commands.

=============
9) To 'move' (context) an article (ABC0002) from one collection (ABC) to another existing collection (GHI).

-\group 305.sales
-\modify article ABC0002
-\context link 1 (Note: Be SURE that you use Examine Object Info if the article is linked to more than one collection and make sure you use the correct link you want to move. The default link when you say -\insert link is link #1 and then #2 and then #3 etc for each additional -\insert link you use.)
-\position in collection GHI

===========
10) To GET information on a collection named ABC.

-\group 305.sales
-\get collection ABC

============
11) Referencing using old_form, old_form applies to FD091 Forms, for example and other forms that your Producer may provide you with the IDs for to enable you to build them into your menus. One example of an old_form is the G&E Newsletter. The following will create an old_form in the ABC collection with the ID of ABCOLD and was referenced to 123456. (You will have to get the reference ID from your producer.)

-\group 305.sales
-\create old_form ABCOLD
-\reference 123456
-\headline G&E Newsletter
-\insert link
-\position in collection ABC

============
12) Creating a Token Argument with the ID of ABCTOKEN, referencing the ID 3456 (ask your producer for the ID) and positioning it in the ABC collection as item number 2 on the menu. (An example of a something requiring the use of token/arg would be adding the "Shared Staff Lounge" menu to your staff area. This is done via use of a token argument.)

-\group 305.sales
-\create token/arg ABCTOKEN
-\reference 3456
-\headline Game Options
-\insert link
-\position in collection ABC as item # 2

===========
NOTE: When placing or linking an existing Conference Room, Message Board or Library in a collection, you do not have to use a token/arg to link it it. Just create a NEW Conference Room, Board or Libray in the new collection. It will automatically reference the existing room, board or library.

13) Creating a conference room with the ID of ABCCONF, referencing the ID 6789 ( You need to ask your producer for the ID) and positioning it in collection ABC. BE SURE of the Reference ID before you do this!!

-\group 305.sales
-\create conference ABCCONF
-\reference 6789
-\headline Chat Lounge
-\insert link
-\position in collection ABC

=============
14) Creating a Message Board with the ID of ABCMSG, referencing the ID 7891 (You need to ask your producer for the ID) and positioning it in collection ABC. BE SURE of the Reference ID before you do this!!

-\group 305.sales
-\create msg_board ABCMSG
-\reference 7891
-\headline Computer Messaging
-\insert link
-\position in collection ABC

=============
15) Creating a Library with the ID of ABCLIBS, referencing the ID 8912 ( You need to ask your producer for the ID) and positioning it in collection ABC. BE SURE of the Reference ID before you do this!!

-\group 305.sales
-\create soft_lib ABCLIBS
-\reference 8912
-\headline Computing Library
-\insert link
-\position in collection ABC

=============
16) How to release article ABC0003 in collection ABC on 12/01/95 at 3:00am (ET) when it's 11/01/95. (Note, if you add links onto this script at the same time as you upload the create script ALL of the links will be released at the same time.)

-\group 305.sales
-\create article ABC0003
-\headline The K's of Computing.
-\release 951201 03:00
-\format lines
-\form 117
-\field 3 text
K is for Keyboard
-\field 1 text
The best Keyboards!
-\insert link
-\position in collection ABC

==========
17) Here's how to create a netaddress. This can be used to link in anything with a url -- which can be a website or an AOL object


-\group 2501.shophere
-\create netaddress mbhome
-\url aol://5863:126/mB:137883
-\headline Home, Kitchen & Garden
-\insert link
-\icon 7
-\position in collection boards
-\end

=============
18) There are two ways to link a particular file from a library into a collection. This is the preferred way since you are using the file's ID rather than linking to the headline. You first need access to the Library tools. When you view the list of files using the tools, the file ID will be the far right column number. Here's the script using that file ID (in this case, the file ID is 421978).

mF Script
-\group 1299.rotunda
-\create token/arg sa421978
-\reference mF 421978
-\headline 06/24 James Kim, USA Today
-\insert link
-\icon 6
-\position in collection rt_sam
-\end

==============
19) To change the background in a changeable form, go to KW: SYSTEMART to select the tile you want. Use the additional command to reference the art just below the form # to change the background. In addition, the icon next to the Title (Field 3) in the form is button 120. If you use a form with an icon, you need to reference the icon art. Here is an example:

-\group ##.sssss
-\plusgroup #
-\form 30065 <--changeable background form
-\headline <---still required
-\art 1-x-xxxx <---global ID of tile
-\field 3 <---remains the same

-\field 1 <---remains the same

-\insert link <---remains the same
-\position in page yyy
-\button 120 <---decorative icon next to title field
-\art 1-x-xxxx


Transmitted: 10/13/97 4:15 PM (hab2)