File Retrieval Service

This is the Juggling Information Service's File Retrieval Service, provided as a service to all jugglers who would like to have access to the JIS, but cannot reach it via the WWW.

Note: For those with FTP capability, just visit:

ftp.juggling.org:/juggling

Overview

You can use E-mail to retrieve files from the Juggling Information Service. To use any of the commands that make up this service, send an E-mail message to file-service@juggling.org. The Subject of the message is ignored.

In the body, you may use commands as in the following examples:
	# lines starting with a # are ignored
	# white space at the beginning and ends of lines is ignored

	# set your return E-mail address, usually not needed
	PATH enrico@rastelli.org

	# get the instructions
	HELP

	# fetch a handy Unix program for interacting with this service
	PROG

	# retrieve the index of all available files
	INDEX

	# retrieve the indexes to the pictures and animations and help files
	SEND pics/
	SEND animations/
	SEND help/

	# retrieve a Popovitch picture, a Rastelli film, and JugglePro 3.6
	# WARNING:  File names are case sensitive.
	#           Do *not* alter upper/lower case.
	SEND pics/Pics/popovitch.gif
	SEND animations/rastelli.mpg
	SEND programs/ibm-pc/jp36.zip

	# retrieve the list of U.S and Canada club meetings.
	SEND meetings/no_amer.html

	--
	all lines following one starting with two hyphens are ignored
	.signature goes here

Command Summary


PATH address

The PATH command sets your return E-mail address, and if used, it must be the first command of your message. By default, the server will attempt to reply to your mail by looking at the header of the received message, like "reply" does in most mailers. If you use this command, however, it will instead send mail to the given address. For most people, the PATH command is not needed.

Example: PATH enrico@rastelli.org


HELP

Sends this text.

Example: HELP


PROG

Sends a copy of a Unix shell program that makes it even easier to retrieve files and the index of available files from the JIS, using a simple command line interface that does the mailing for you. It also may be used to conveniently unpack the files returned from the service. The unpacking function requires the presence of the perl command.

Example: PROG


INDEX

Sends an annotated index of all of the JIS files that are available for retrieval.

Example: INDEX


SEND file-name

Sends the specified file back via return E-mail. You may retrieve as many files as you like, by using a separate SEND command for each. Binary, text and HyperText files can all be retrieved.

WARNING: File names are case sensitive. Do not alter upper/lower case.

Binary files will be uuencoded. You will need the uudecode program at your site to reproduce these files. Text files will be returned as is.

HyperText files will include footnotes at the site of each link to another object. The addresses of the objects pointed to will appear in the footnotes at the bottom of the page. Those noted with a SEND command are local[1] to the JIS, and may be retrieved with SEND requests to the FILE-SERVICE. Remote[2] files not at the JIS cannot be retrieved at this time with this service.

	[1] SEND example/footnote.txt
	[2] #### http://www.remote.com/remote/files/cannot/be/retrieved
	
Example: SEND help/numbers/5-balls.html

jis Command for Unix

If you're on a Unix machine, this is a very handy shell program to allow you to retrieve files and fetch the index of available files even more easily. Just download it, and it's ready to use.

You may retrieve a copy through this service by sending the PROG command.


File Retrieval Service / Juggling Information Service / jis@juggling.org