[<<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