[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
20.2 Setting up
Service requests are defined in the ALIAS file (where you define
alias file names for file requests). The format of a service
request definition looks like this:
<NAME> ><PROGRAM> <PARAMETERS> <+ or - path name>
Eg.
WHATSNEW >SEARCH.EXE findit =A =T -C:\SERVICE\RESULT\*.TXT
Service name
NAME (case does not matter) is what the remote system should
request to invoke the service request.
Program
>PROGRAM is the program that should be invoked when FD receives a
request for NAME. The > character is required and tells FD it is
a service request and not an alias definition. There should be no
spaces between the > and PROGRAM.
The extension of PROGRAM is important. FD can execute batch
(.BAT) files as a result of a service request, but it must do it
through COMMAND.COM. So it has to know what type of file
(program) it is that you are executing.
Parameters
You can pass any parameters to the program. The only restriction
is (as with DOS) that they do not exceed a length of 128
characters and none of them starts with the (see below)
character.
There are several macros that you can specify as parameters.
Macros should be preceded by a single equal sign (=). FD will
expand these macros before calling the program. You may include
macros in other parameters.
Eg. -p=P Would pass -p followed by the value of the P
macro to the program.
Macros
Here is a list of the available macros:
=A The requesting system's network address. Eg.
2:270/17.
=B The baud rate of the connection. Eg. 9600.
=C The cost per minute for the connection. If your
system initiated the session (called the
requesting system), this is the cost per minute.
If the requesting system initiated the session
(called your system), this will be 0.
=D OUTBOUND if your system initiated the session
(called the requesting system) or INBOUND if the
requesting system initiated the session (called
your system).
=L The requesting system's location. Eg. Oetrange_L.
This value is taken from the nodelist based on
the network address. Note that if the requesting
system is not listed in your nodelist, this value
will be "UNKNOWN".
=N The name of the requesting system. Eg. FroDo_HQ.
=O The operator of the requesting system. Eg.
Bilbo_Baggins. Note that space characters are
replaced with an underscore.
=P The password that was specified for the request
(if any).
=S The service that was requested. Eg. WHATSNEW.
=U The date and time supplied on an update request.
It is expressed in UNIX format, ie. the number of
seconds since 1970. If the request was a plain
file request, this will be 0.
=X Whether or not the session is password protected.
This macro can have two values, SECURE or
UNSECURE.
=Z The type of the mail session that has been
established. This macro can have three values,
WAZOO, EMSI, or OTHER.
20.3 - + ?
The character defines the beginning of a filemask that FD
should send after the service request has been completed. If no
definition has been made, FD will not send any files as the
result of a service request.
The plus (+) means that FD should NOT remove the files once they
have been transmitted.
The minus (-) means that FD SHOULD remove the files once they
have been transmitted. This also means that the files will be
removed even if they could not be sent (carrier lost, etc).
The question mark (?) means that FD should ONLY remove the files
once they have been SUCCESSFULLY transmitted. This means that if
a session fails after transmitting three files, only those three
files will be removed and the remaining left intact.
The path name is a file specification, it may include wildcard (?
and *) characters. FD will send all matching files.
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson