dokument.txt

ÛßßÛ     ÛÞÝÛ    TM     SoftWolves Software     Announce.Dok
ÛÜÜÜÄÄÄÄÄÛÞÝÛÄÄÄÄÄÄ     c/o Peter Karlsson
Ü  Û OFT ÛÞÝÛ OLVES     V„rnsta, Ullers„ter     Dokumentation f”r
ßßßßÄÄÄÄÄßßßßÄÄÄÄÄÄ     718 92  FR™VI           Announcer v1.2
N„r vargarna ylar     Telefax 021-132367
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

Announcer v1.2 - Postar filer i brevareor p† BBS:er

Copyright (c) 1995, 1996, 1997, 1998: Peter Karlsson
A Softwolves Software(TM) Release in 1998

$$TOC$$
Dokumentation

        {Snabbstart} (eller vad du verkligen b”r veta)
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

Announcer styrs helt fr†n kommandoraden och sin konfigurationsfil (se respektive kapitel). Det finns ingen interaktiv del, vilket g”r att det blir enkelt att s„tta upp programmet f”r att automatiskt posta filer. Detta medf”r „ven att man m†ste veta en del om hur programmet styrs innan det g†r att anv„nda. Jag rekommenderar d„rf”r att du l„ser igenom de tv† kapitlen "Kommandoradsformat" och "Konfigurationsfilen", eller †tminstone kommentarerna i den konfigurationsfil som medf”ljer som exempel. Det besparar en hel del arbete.

Om du vill anv„nda de standardinst„llningar som finns f”r Announcer, skriver du helt enkelt fr†n kommandoraden

        ANNOUNCE

och programmet utf”rs. Programmet kommer nu att anv„nda standardkonfigurationsfilen ANNOUNCE.INI och g”ra det som d„r anges. Om n†gra fel uppst†r kommer detta att skrivas ut p† sk„rmen, och programk”rningen kommer att avbrytas. Ett vanligt fel „r att filer eller meddelandebaser saknas, vilket oftast beror p† felstavade filnamn, men kan „ven bero p† att filen eller meddelandebasen „r l†st av ett annat program.

Om du vill anv„nda inst„llningarna i en annan konfigurationsfil, l„ser du kapitlet "Kommandoradsformat". Om du vill anv„nda m”jligheten att ange avs„ndar- och mottagarnamn p† kommandoraden, se kapitlet "%-variablerna". Om du vill ha detaljerad information om hur konfigurationsfilerna „r uppbyggda, se kapitlet "Konfigurationsfilen, ANNOUNCE.INI". Se „ven exemplen i den medf”ljande exempelkonfigurationsfilen.

Och om du vill l„ra dig allt lusl„ser du hela manualen och l„r dig den utantill :-)

Jag ber dig „ven l„sa kapitlet "Status", som talar om hur du betalar f”r programmet.

        {Bakgrund}
        ÄÄÄÄÄÄÄÄ

Det h„r programmet skrev jag ursprungligen f”r en lokal BBS, d„r jag "t„vlade" med ett par kompisar om vem som hade skrivit flest inl„gg, och eftersom jag inte gillar att ligga uppkopplad, s† tog jag hem posten och l„ste offline. Problemet var d† att jag inte kunde kolla p† statistiken n„r jag var offline, och att jag j„mt gl”mde att titta n„r jag var uppkopplad.

S†, jag skrev ihop det h„r programmet, till en b”rjan v„ldigt begr„nsat, men allteftersom betatestarna och jag sj„lv kom p† nya id‚er v„xte programmet fram till vad det nu „r. Det kan nu mer „n bara posta topplistor, det kan posta v„lkomstmeddelanden till nya anv„ndare, m”tesregler i echomailm”ten, automatiska p†minnelsebrev, och mycket mer. Endast fantasin s„tter gr„nsen (n†ja, s† l„nge det „r inom programmets anv„ndningsomr†de. Styra mikrov†gsugnen kan det inte).

        {Status}
        ÄÄÄÄÄÄ

Detta program „r sl„ppt under Gnu Public License. Se filen COPYING f”r mer information.

Undantag till GNU Public License „r dessa:

Filen NLS.PAS av Thomas Mainka, f†r kopieras i enlighet med filen LICENSE.TXT som medf”ljer i NLS-arkivet.

Mythical Kingdom's Message Access Source, arkivet MKSM106A.RAR, f†r spridas enligt vad som st†r beskrivet i dess dokumentation. Var v„nlig notera att den version som medf”ljer Announcer har modifierats f”r att passa Announcer.

        {Avs„gande av ansvar}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

DENNA MJUKVARA, OCH DESS MANUAL, SŽLJS UTAN GARANTI F™R DESS FUNKTION OCH UTAN ALLA ANDRA GARANTIER, VARKEN UTTRYCKTA ELLER IMPLICERADE. P GRUND AV DE VARIERANDE HRDVARU- OCH MJUKVARUMILJ™ERNA I VILKA DETTA PROGRAM KAN KOMMA ATT ANVŽNDAS S GES INGEN GARANTI F™R DESS FUNKTION I NGON SPECIELL ANVŽNDNING. F™RFATTAREN F™RS™KER DOCK ATT EFTER BŽSTA F™RMGA, OCH EFTER ATT BLIVIT UPPMŽRKSAMMAD P OLIKA FELAKTIGHETER, ATT RŽTTA TILL FEL. ETT BRA DATAHANTERINGSPROTOKOLL SŽGER ATT ALLA PROGRAM SKA TESTAS UTF™RLIGT P ICKE-KRITISK DATA INNAN DEN BETROS. ANVŽNDAREN MSTE TA ALL RISK F™R ANVŽNDANDE AV PROGRAMMET. ALLT ERSŽTTNINGSANSVAR HOS SŽLJAREN BEGRŽNSAS EXKLUSIVT TILL PRODUKTUTBYTE ELLER ERSŽTTNING AV F™RSŽLJNINGSPRISET.

        {Medf”ljande filer}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

ANNOUNCE.EXE    Det k”rbara programmet
ANNOUNCE.ICO    Ikon (OS/2-format)
FILE_ID.DIZ     Kort beskrivning f”r BBSer
ANNOUNCE.DOK    Dokumentation
ANNOUNCE.DOC    Dokumentation p† engelska
COPYING         GNU Public License
NORMAL.INI      Exempel p† konfigurationsfil
PKTMODE.INI     Exempel p† konfigurationsfil
SOURCE.RAR      K„llkod f”r Announcer
NLS.RAR         K„llkod f”r NLS-rutinerna
MKSM106A.RAR    K„llkod f”r MSG access
WOLVES.COM      Softwolves programkatalog

        {Kommandoradsformat}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

ANNOUNCE [/I[enhet:][s”kv„g]filnamn] [/D[M]] [/P] [/Q] [/S]
         [/F[A]] [/L] [namn ...]
ANNOUNCE /?

  /I[enhet:][s”kv„g]filnamn

Den h„r parametern talar om f”r Announcer att det ska anv„nda en annan konfigurationsfil „n ANNOUNCE.INI som „r standard (s†vida du inte „ndrat namn p† den k”rbara programfilen, Announcer anv„nder namn och s”kv„g till denna fil f”r att skapa namnet p† standardkonfigurationsfilen, s† om du bytt namn p† programmet till A.EXE kommer konfigurationsfilens standardnamn att vara A.INI).

  /D

Detta f†r Announcer att inte posta meddelanden, utan i st„llet visa statusinformation. Det som visas „r hur l„nge sedan varje meddelande postades, vilket intervall som definierats f”r meddelandena (om n†got), ”nskad minsta storlek, existensen hos eventuell semaforfil, och det MSGID som anv„ndes vid senaste postningen. Observera att du m†ste ha k”rt Announcer en g†ng f”r att kunna k”ra med denna v„xel.

  modifieraren M (/DM)

Denna modifierare till /D-v„xeln f†r Announcer att rensa upp i datafilen, s† att poster i den filen som inte har n†gra motsvarande poster i konfigurationsfilen kommer att tas bort. Detta „r anv„ndbart om mallar har tagits bort fr†n datafilen. Den kan bara anv„ndas tillsammans med /D, annars kommer den att ignoreras.

Observera att om datafilen och meddelandemallarna kommer "i otakt", t.ex om du tar bort poster i mitten, s† kan du inte anv„nda /M, utan du m†ste anv„nda specialposten "PlaceHolder" i st„llet. Dock kommer /M att nollst„lla poster definierade som "PlaceHolder".

  /P

N„r du anger den h„r kommandoradsparametern kommer Announcer inte att l„gga till tearlines i de meddelanden som skapas, utan i st„llet visa sitt namn i en PID-kludge. Vid postning av echomailmeddelanden till meddelandebaser kommer denna v„xel „ven att inneb„ra att Announcer inte l„gger till n†gon Origin-rad, utan l„mnar det till tossern. I .PKT-l„ge kommer en Origin-rad att skapas, men ingen tearline.

Observera att tossern TerMail, i †tminstone vissa versioner, inte kommer att l„gga till tearline och Origin-rad vid tossning, vilket medf”r att denna v„xel d† kommer att generera enligt Fidonetspecifikationerna ogiltiga meddelanden. F”rsiktighet b”r iakttagas.

  /Q

Med denna kommandoradsv„xel kommer Announcer att inte visa n†gon utdata, undantaget felmeddelanden, som alltid skrivs till stderr-enheten. I vanliga fall skrivs all utdata till den enhet som „r kopplad till stdout (vanligtvis sk„rmen). Kan inte anv„ndas tillsammans med /FA.

  /S

Anv„nd den h„r kommandoradsv„xeln f”r att simulera en Announcerk”rning. Announcer kommer g”ra allting precis som om det hade varit en riktig k”rning, f”rutom att det inte kommer att skapa meddelanden eller semaforer, det kommer inte att logga n†gonting i loggfilen (det loggas i st„llet till sk„rmen), och inte heller kommer datafilen att uppdateras. Detta kan vara anv„ndbart vid fels”kning av konfigurationsfilerna.

  /F

Denna kommandoradsv„xel anv„nds f”r att framtvinga postning av meddelanden trots att kraven f”r deras postning inte „r uppfyllda (beroende p† t.ex intervall eller minsta filstorlek).

  modifieraren A (/FA)

Om du anv„nder /F kommer alla meddelanden att postas, medan /FA fr†gar f”r om postning f”r varje mall. /FA kan inte anv„ndas tillsammans med /Q.

  /L

Om du ger /L-parametern kommer Announcer inte att uppdatera senaste postningsdatum f”r de meddelanden som postas (senast anv„nda MSGID kommer dock att „ndras). Det kan vara anv„ndbart f”r att t.ex posta uppdaterade regler direkt n„r de uppdaterats, tillsammans med /FA, utan att st”ra intervallstyrda postningar, men „nd† f† in dem i samma kommentarskedja.

  namn

Dessa texter kommer att anv„ndas d„r du anger %1 till %10 (numret motsvarar den inb”rdes ordningen p† kommandoraden) i konfigurationsfilen. Kan l„mpligen anv„ndas f”r att g”ra det m”jligt att posta ett standardmeddelande till olika personer. Om du vill ha mellanslag i namnet anv„nder du i st„llet ett understreck ("_"). Om du anger mindre „n tio namn kommer †terst†ende %n-variabler att f† v„rdet "Announcer". De h„r namnen kommer inte att anv„ndas om du anger /D.

  /?

Visar snabbhj„lpsk„rmen.

        {Konfigurationsfilen, ANNOUNCE.INI}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

Konfigurationsfilen, standardnamn ANNOUNCE.INI, talar om f”r Announcer vad det ska g”ra, och p† vilket s„tt det ska g”ras. F”r att anv„nda Announcer „r en konfigurationsfil ett krav, och f”r att kunna anv„nda Announcers funktioner rekommenderar jag att du l„ser genom detta kapitel. Vissa f”rklaringar finns „ven i den exempelfil som medf”ljer distributionsarkivet.

Om du vill ha kommentarer i filen skriver du dem p† rader som inleds med semikolon (";").

Normalt kommer Announcer att leta efter en konfigurationsfil som ligger i samma katalog som programmet, och som har samma namn, f”rutom att filtypen „r .INI. T„nk p† det om du „ndrar programnamnet, byter du namnet till A.EXE heter konfigurationsfilen A.INI.

F”r varje konfigurationsfil du anv„nder kommer en datafil, med filtypen .DAT, att skapas. Den filen inneh†ller information om senaste postningstidpunkt, f”r intervallstyrningen, samt det MSGID som anv„ndes s† att n„sta postning kan inneh†lla en REPLY-kludge (om du har satt "ReplyKludge No" kommer dock ingen REPLY-kludge att skapas, men MSGID loggas „nd†).

Konfigurationsfilen best†r av tv† olika "delar", den ena „r den globala delen som definierar standardinst„llningar f”r samtliga meddelanden, och det andra „r de individuella inst„llningarna f”r varje meddelande som ska skapas. Det „r helt olika inst„llningar som anv„nds i de olika delarna, men de p†verkar varandra.

Varje meddelandemall b”rjar med en rad som det endast st†r

        Msg

p†, och avslutas med texten

        .End

Mellan dessa rader skrivs de konfigurationsposter som beh”vs f”r meddelandet, och utanf”r dessa kan de globala inst„llningarna st„llas in. Observera att det inte finns n†got krav p† den inb”rdes ordningen hos de olika inst„llningarna.

Om du vill att Announcer ska hoppa ”ver en meddelandemall, t.ex. om du tar bort en i mitten, s† kan du ers„tta Msg/.End-sekvensen med en rad som bara inneh†ller texten

        PlaceHolder

vilket kommer att g”ra s† att Announcer forts„tter med n„sta mall.

F”r de globala inst„llningarna finns standardv„rden, vilka anges i texten nedan. Standardv„rden finns „ven f”r flera av inst„llningarna i meddelandemallarna, f”rutom "From", "Subj", "File" och "Path". Dessa fyra „r vitala, och m†ste inkluderas i samtliga meddelandemallar. Adresserna som anv„nds i netmail och echomail anses inte som vitala, men utan dem kan du f† konstiga resultat.

Det spelar ingen roll om nyckelorden skrivs med stora eller sm† bokst„ver. Om du vill ha med mellanslag i b”rjan eller slutet av datat f”r nyckelordet m†ste du omg„rda v„rdet med citattecken (").

  {  Globala inst„llningar}
    ---------------------

De globala inst„llningar som finns „r dessa:

  BinkleyName

Detta nyckelord har att g”ra med Announcers .PKT-l„ge. Detta dokumenteras i kapitlet "Skapa .PKT-filer".

  BragLineIntro <introduktionstecken f”r reklamraden>

Definierar vad som ska inleda reklamraden. Om ingen inst„llning anges s† kommer "---" (en Fidonet tearline) att anv„ndas som standard. Denna inst„llning kan vara max tre tecken l†ng.

exempel:
BragLineIntro ___

  EchoTossLog <filnamn f”r echotoss-loggfilen>

Om du har m†nga echomailm”ten p†slagna, men inte skriver i alla varje g†ng, s† „r det en bra id‚ att logga vilka m”ten man har skrivit texter i, och bara avs”ka dessa m”ten efter nya brev, d„rf”r finns ECHOTOSS.LOG-filen. Det „r en textfil som best†r av en lista med m”testagar, ett p† varje rad, som talar om vilka m”ten som det finns nya brev i. Eftersom Announcer har m”jlighet att skicka echomail, s† „r det l„mpligt om det kan skriva till en s†dan fil, och det „r det detta nyckelord „r till f”r.

Som parameter till nyckelordet anger du fullst„ndig s”kv„g samt filnamn till den fil som m”testagarna ska l„ggas till i. Om filen inte finns kommer den att skapas n„r det beh”vs. Om m”testagen redan finns i filen kommer den inte att skrivas till en g†ng till.

F”r att detta ska fungera m†ste du „ven anv„nda "Echo" i meddelandemallen, se detta nyckelord. Se „ven "JamTossLog" nedan.

exempel:
EchoTossLog C:\SQUISH\ECHOTOSS.LOG

  FMailCfg <s”kv„g och filnamn p† FMail.cfg>

G”r att Announcer l„ser in FMails (version 1.22) konfigurationsfil, s† att man inte beh”ver ange s”kv„g till alla meddelandeareor. Announcer l„ser endast filerna FMAIL.CFG och FMAIL.AR.

exempel:
FMailCfg C:\FMAIL\FMAIL.CFG

  GEchoCfg <s”kv„g och filnamn p† GEcho.cfg>

G”r att Announcer l„ser in GEchos (version 1.20) konfigurationsfil, s† att man inte beh”ver ange s”kv„g till alla meddelandeareor. Announcer l„ser endast filerna GECHO.CFG och AREAFILE.GE

exempel:
GEchoCfg C:\GECHO\GECHO.CFG

  IDServer <katalog f”r IDServer-filen>
  IDServer No

Enligt specifikationerna f”r MSGID-kludgen m†ste de genererade MSGID-numren vara unika i tre †r. Med ett program „r det l„tt att klara av, men med flera olika program „r det sv†rt. IDServer skapades f”r att undvika detta problem. En IDServer „r en liten datafil som inneh†ller n„sta lediga MSGID-nummer (och n†gra andra saker). Genom att anv„nda denna i alla program som anv„nds kommer alla program att generera unika MSGID-koder.

IDServer kan anges antingen med milj”variabeln IDSERVER eller via denna inst„llning. Om du har milj”variabeln IDSERVER inst„lld, men av n†gon anledning vill att Announcer inte ska anv„nda denna inst„llning, kan du ange parametern "NO". IDServern kommer d† inte att anv„ndas.

exempel:
IDServer C:\

  JamTossLog <s”kv„g f”r echomail.jam/netmail.jam>

Om du anv„nder JAM-areor anv„nds vanligtvis inte ECHOTOSS.LOG (se EchoTossLog ovan), utan i st„llet filerna ECHOMAIL.JAM och NETMAIL.JAM. F”r att skapa dem anv„nder du detta nyckelord.

Som parameter till nyckelordet skriver du namnet p† den katalog i vilken filerna ska skrivas. I filerna kommer s”kv„g till databaserna samt meddelandenummer att skrivas, s† det „r inte n”dv„ndigt att anv„nda "Echo".

Om du har b†de EchoTossLog och JamTossLog definierade kommer de b†da att anv„ndas, men inte samtidigt. JamTossLog kommer att anv„ndas f”r JAM-areor, och EchoTossLog f”r ”vriga. Om du inte anger JamTossLog, men har EchoTossLog, kommer „ven JAM-areor att loggas i EchoTossLog.

exempel:
JamTossLog C:\FASTECHO\

  LogFile <filnamn f”r loggfilen>

Om du vill att Announcer ska logga vad det g”r till en loggfil ska du anv„nda det h„r kommandot. Om filen du anger inte finns kommer den att skapas, annars kommer de nya loggraderna att l„ggas till i slutet p† filen.

exempel:
LogFile D:\LOGS\ANNOUNCE.LOG

  MsgId <adress att anv„nda i MsgId-str„ngen>

Om du vill att en MSGID-kludge ska skapas i lokala meddelanden m†ste du ange vilken adresstr„ng som ska anv„ndas f”r den. Trots att du kan skriva precis vad som helst (dock maximalt 32 tecken), s† kan det vara en f”rdel att h†lla sig till specifikationerna, n„mligen att det ska vara en "giltig returadress", samt att om adressen inneh†ller mellanslag ska den st† inom citationstecken ("). F”r netmail och echomail kommer alltid MSGID-kludgar att skapas, och dess adresstr„ng kommer att best† av avs„ndaradressen. D„r har allts† denna inst„llning ingen funktion.

exempel:
MsgId 999:42/417.25@MyNet

  NetMailTearLine <Yes/No>

Styr huruvida du vill ha tearline i netmailmeddelanden eller inte. Observera att PID-styrningen (kommandoradsparametern /P) har f”retr„de framf”r denna inst„llning. Standardv„rde „r att tearline anv„nds i netmail.

exempel:
NetMailTearLine No

  PktFrom
  PktMode
  PktPath
  PktPwd
  PktTo

Dessa fem nyckelord har alla att g”ra med Announcers .PKT-l„ge. Detta dokumenteras i kapitlet "Skapa .PKT-filer".

  ReplyKludge <Yes/No>

St„ller om REPLY-kludgar skapas i Announcers meddelanden eller inte. Om du inte vill att dina postningar ska l„nkas med f”reg†ende postning s„tter du detta till "No". Standardv„rde „r "Yes".

REPLY-kludgar kommer inte att skapas i s„ndlistor.

exempel:
ReplyKludge Yes

  SquishCfg <s”kv„g och filnamn p† Squish.cfg>

G”r att Announcer l„ser in SquishMails (version 1.11) konfigurationsfil, s† att man inte beh”ver ange s”kv„g till alla meddelandeareor.

exempel:
SquishCfg C:\SQUISH\SQUISH.CFG

  TagLineFile <filnamn f”r taglinefilen>

Om du vill anv„nda slumpvalda taglines (taglines anv„nds ganska flitigt i brevsammanhang f”r att l„gga till ett litet enradssk„mt), m†ste du f”rst tala om f”r Announcer var det kan hitta en fil med s†dana i. Den taglinefil du definierar kan sedan anv„ndas av *efterkommande* meddelandemallar. Det „r m”jligt att byta taglinefil mellan meddelandemallarna, denna taglinefil kommer d† endast att vara tillg„nglig i efterf”ljande mallar.

Alla rader som b”rjar p† antingen semikolon (";") eller procenttecken ("%") kommer att antas vara kommentarer och ignoreras.

exempel:
TagLineFile D:\BLUEWAVE\DEFAULT.TAG

  TagLineIntro <introduktionstecken f”r tagline>

Definierar vad som ska st† f”re taglines (taglines anv„nds ganska flitigt i e-post-sammanhang f”r att l„gga till ett litet enradssk„mt). Om ingen inst„llning anges s† kommer "..." (som „r vanligast) att anv„ndas som standard, d† detta „r det mest f”rekommande f”r taglines. Denna inst„llning kan vara max tre tecken l†ng.

exempel:
TagLineIntro .!.

  TerMailCfg <s”kv„g och filnamn p† Tm.cfg>

G”r att Announcer l„ser in TerMails (version 3.0-5.0) konfigurationsfil, s† att man inte beh”ver ange s”kv„g till alla meddelandeareor.

Observera att om du anv„nder relativa s”kv„gar i din m”teslista m†ste du ha definierat en absolut Terminates”kv„g i Tm.Cfg (nyckelord 'TERMINATE').

exempel:
TerMailCfg C:\TERMINAT\TERMAIL\TM.CFG

  {  Meddelandemallar}
    ----------------

Meddelandemallarna „r uppbyggda av f”ljande inst„llningar:

Observera att de inst„llningar som markeras med [*] „r frivilliga parametrar. Vissa andra parametrar kan vara mer eller mindre begr„nsade i olika l„gen, det st†r d† under respektive rubrik.

  Attributes <meddelandeattribut> [*]

Med detta nyckelord kan du styra vilka attribut meddelandet som ska skapas ska ha. Varje attribut motsvaras av en bokstav, och du skriver den eller de attribut du vill ha i en l†ng rad efter nyckelordet. Du kan ha mellanslag mellan bokst„verna om du s† ”nskar.

Tillg„ngliga attribut „r:
  "C": Prioriterat (CrashMail)
  "K": Radera vid s„ndning (Kill/sent)
  "A": Bifoga fil (File Attached)
  "R": Efterfr†ga fil (File Request)
  "P": Privat
  "H": H†ll f”r avh„mtning (Hold for pickup)

Observera att privatflaggan „ven kan styras med "Private" (se detta nyckelord), och att privatflaggan ignoreras i netmail och echomail. Du kan inte anv„nda specificerade attribut i echomail.

exempel:
Attributes CK

  Charset <teckenupps„ttning> [*]

H„r st„ller du in vilken teckenupps„ttning du vill att meddelandet ska postas i. Meddelandefilen antas alltid vara lagrad i PC8 teckentabell 437, och konvertering kommer att ske med utg†ngspunkt fr†n detta antagande. M”jliga v„rden „r "PC8" (ingen konvertering, samma effekt som att utel„mna nyckelordet), "SV7" (svensk sjubitarskod), "ISO" (ger ISO 8859-1) eller "ASCII" (ger ren sjubitars ASCII-kod, ingen CHRS-kludge).

Det g†r „ven att konvertera texter till PC8 teckentabell 437, fr†n antingen ISO 8859-1 eller svensk sjubitarskod. Ange d† samma str„ng som ovan, men med ett inledande minustecken, allts† "-ISO" f”r konvertering fr†n ISO 8859-1 resp. "-SV7" f”r svensk sjubitarskod.

Om du anger "-ASCII" kommer konvertering ske fr†n ASCII med paritet till ASCII utan paritet (d.v.s. den h”gsta biten i tecknen kommer att nollst„llas).

Om du har en text som „r i antingen svensk sjubitarskod eller ISO 8859-1, och vill posta dem i den teckenupps„ttningen, anger du motsvarande str„ngar, men med ett inledande plustecken, allts† "+ISO" f”r filer i ISO 8859-1 resp. "+SV7" f”r svensk sjubitarskod. Data i konfigurationsfilen ska fortfarande skrivas i PC8, konvertering kommer att ske av denna.

exempel:
Charset SV7

  Create <s”kv„g och filnamn till semaforfil> [*]

Om du st„ller in en s”kv„g och filnamn h„r kommer Announcer att skapa en tom semaforfil om meddelandet postas.

Om du i st„llet vill att Announcer ska posta endast om en semaforfil existerar, se nyckelordet 'Semaphore'.

exempel:
Create C:\ANNOUNCE\POSTED.SEM

  Dest <mottagaradress>

Med det h„r nyckelordet anger du mottagaradressen f”r meddelandet som ska skapas. Det „r bara aktivt i netmail, och kommer i andra fall att ignoreras. Om du skapar netmailmeddelanden m†ste du definiera b†de Orig och Dest, annars kan konstiga saker h„nda, d† dessa v„rden „r odefinierade annars.

exempel:
Dest 2:204/999.41

  Distribution <meddelandebastyp> [*]

H„r st„ller du in vilken typ av meddelandebas inl„gget som ska skapas kommer att hamna i. Programmet har tyv„rr ingen m”jlighet att automatiskt k„nna av det, s† du m†ste st„lla in det korrekt h„r. Om du inte anger detta nyckelord alls kommer det att antas vara en lokal area, och parametrarna kommer att s„ttas p† det s„ttet. Om du vill skapa netmail eller echomail m†ste dessa meddelandebastyper att s„ttas explicit, vilket du g”r genom att skriva nyckelordet f”ljt av texten "NetMail", "EchoMail". F”r lokala m”ten kan du, om du vill, anv„nda parametern "Local".

Observera „ven att om du anger NetMail m†ste du „ven specificera Orig och Dest (se dessa nyckelord), samt att Private (se detta nyckelord) inte kommer att vara verksam. Om du anger EchoMail m†ste du specificera Orig (se detta nyckelord), samt om du vill ha en annan Origin-text „n "Standard-Origin-rad" m†ste du definiera Origin (se detta nyckelord). Ej heller h„r kommer Private-flaggan att vara verksam.

M”testypen s„tts automatiskt om du l„ser in en tosserkonfiguration, och anv„nder m”testagen f”r att hitta m”tet.

exempel:
Distribution NetMail

  Echo <m”testag> [*]

Detta nyckelord anv„nds tillsammans med EchoTossLog i de globala inst„llningarna (se detta avsnitt) f”r att logga i vilka m”ten det finns brev som ska skickas. Om du inte anger b†da kommer inget att h„nda.

Om du l„ser in en tosserkonfiguration, och utel„mnar Path-nyckelordet, kommer m”tet att sl†s upp p† med hj„lp av denna tag. Det beh”ver d† inte n”dv„ndigtvis vara en echomailarea.

exempel:
Echo R20_NEWPROG.FILESECHO

  File <s”kv„g och filnamn till fil som ska postas>

Med detta nyckelord specificerar du vilken fil som ska anv„ndas som meddelandekropp f”r det meddelande som ska skapas. Filen m†ste existera, annars kommer programmet att avslutas med ett felmeddelande. Om du anger ett filnamn utan s”kv„g kommer filen att efters”kas i den katalog som „r aktuell vid programstart.

exempel:
File C:\STAT\WRITERS.TXT

  FixedWidth <flagga f”r fast breddsteg> [*]

Med FixedWidth kan du ange om det meddelande du vill posta „r menat att visas med fast breddsteg eller inte. Eftersom grafiska gr„nssnitt blir allt vanligare „ven bland Fidonetl„sare, blir det allt vanligare att l„sa inl„gg med ett proportionellt typsnitt, vilket tyv„rr g”r att tabeller och liknande ser konstiga ut. Med fast breddsteg kan detta avhj„lpas.

Fast breddsteg anv„nder en kludgerad som f”rst specificerades i FrontDoor APX/w, n„mligen "FLAGS: NPD".

Standardv„rdet „r att inte anv„nda denna kludge.

exempel:
FixedWidth Yes

  Footer <s”kv„g och filnamn till fotfil> [*]

Detta nyckelord specificerar en fotfil, som kommer att l„ggas till efter den "stora" filen. Kan exempelvis vara en signaturfil, eller n†got i den stilen. Om du inte anger n†gon kommer ingen fotfil att anv„ndas.

Inget felmeddelande ges om filen inte existerar.

exempel:
Footer C:\SIG\MY.SIG

  From <avs„ndarnamn>

H„r anger du vilket avs„ndarnamn som ska anv„ndas f”r det meddelande som ska skapas. Om inte meddelandebasformatet begr„nsar det ytterligare, „r maxl„ngden p† namnet 35 tecken, om du anger f”r l†nga namn kommer det att trunkeras till maxl„ngden.

exempel:
From Statistikgeneratorn

  Header <s”kv„g och filnamn till huvudfil> [*]

Detta nyckelord specificerar en huvudfil, som kommer att l„ggas till f”re den "stora" filen. Kan exempelvis vara en logotypfil, eller n†got i den stilen. Om du inte anger n†gon kommer ingen huvudfil att anv„ndas.

Inget felmeddelande ges om filen inte existerar.

exempel:
Header C:\LOGOS\MY.LGO

  Interval <intervall> [*]
  Interval @<postningsdatum> [*]

Om du inte vill att meddelandet ska postas vid varje k”rning kan du h„r ange ett intervall, angivet i dagar. Om du k”r Announcer varje dag, och har intervallet satt till 7, kommer det „nd† bara att postas ett meddelande i veckan. Om du inte anger n†got intervall, eller intervallet noll, kommer meddelandet att postas vid varje k”rning.

Det g†r „ven att tala om f”r Announcer att bara posta meddelanden p† vissa datum, du ska d† inleda datumen med ett snabel-a ("@"). Observera dock att du verkligen m†ste k”ra Announcer p† det datumet, om du inte g”r det kommer det inte att postas f”rr„n n„sta m†nad.

Det g†r inte att anv„nda b†da varianterna p† Interval tillsammans i samma meddelandemall.

exempel:
Interval 14
Interval @1

  MinSize <storlek i bytes> [*]

Med detta valfria nyckelord kan du st„lla in minimistorleken som meddelandefilen m†ste ha f”r att postas. Om filen „r mindre „n denna storlek, eller inte existerar alls, kommer det inte att postas.

Detta kan „ven anv„ndas f”r att posta meddelanden bara om meddelandefilen finns (om den inte g”r det, anses den som f”r liten), anv„nd bara MinSize 0. (Du kan g”ra samma sak med Semaphore).

exempel:
MinSize 1024

  Orig <avs„ndaradress>

Med det h„r nyckelordet anger du avs„ndaradressen f”r meddelandet som ska skapas. Det „r bara aktivt i netmail och echomail, och kommer annars att ignoreras. Den adress du anger h„r kommer „ven att anv„ndas f”r att skapa en MSGID-kludge. (MSGID kommer alltid att skapas f”r netmail och echomail).

Avs„ndaradressen s„tts automatiskt om du l„ser in en tosserkonfiguration, och anv„nder m”testagen f”r att hitta m”tet.

exempel:
Orig 2:204/999.42

  Origin <originrad> [*]

Detta „r ett valfritt alternativ som bara „r aktivt d† du skriver echomail, och det anv„nds f”r att specificera vilken text som ska anv„ndas p† Origin-raden. Origin-rader kommer alltid att skapas i echomail, oavsett om du specificerat n†gon text eller inte, men det kan vara trevligt att ha en egen text.

Eftersom Fidonet-specifikationerna s„ger att en Origin-rad maximalt kan vara 79 tecken, inklusive prefixet " * Origin: " och suffixet " (adress)", kan du inte skriva en hur l†ng rad som helst. Raden kommer att trunkeras fr†n h”ger om raden „r f”r l†ng. Hur l†ng text du exakt kan ha beror p† hur l†ng din adress „r. Du f†r plats med mer text om du har adressen 7:7/7 „n om du har 999:999/999.999

exempel:
Origin Min plats i v„rldsrymden

  Path <s”kv„g till meddelandebasen>

F”r att Announcer ska veta var det ska posta sitt meddelande, m†ste du tala om vilken meddelandebas som ska anv„ndas. Formatet p† denna s”kv„g varierar beroende p† formatet p† meddelandebasen enligt tabellen nedan:

Squish: Bokstaven "S" f”ljt av s”kv„gen till meddelandebasens stamfil (utan extension).
exempel:
Path SC:\MAX\MSG\MUFFIN

Hudson: Bokstaven "H" f”ljt av ett tresiffrigt, decimalt, nummer som anger areanumret, och detta f”ljt av namnet p† katalogen som meddelandebasen ligger i.
exempel:
Path H007C:\RA\MSG\MSGBASE

Fido (*.MSG): Bokstaven "F" f”ljt av s”kv„gen till meddelandebasens katalog.
exempel:
Path FC:\FD\NET\

JAM: Bokstaven "J" f”ljt av s”kv„gen till meddelandebasens stamfil (utan extension).
exempel:
Path JC:\RA2\MSG\RA_UTIL

EzyCom (tidigare „n version 1.10 av EzyCom): Bokstaven "E" f”ljt av ett fyrsiffrigt, decimalt, nummer som anger areanumret, och detta f”ljt av s”kv„gen till meddelandebasen (utan extension).
exempel:
Path E0001F:\EZY\MSG

  Private <privatflagga>

Detta nyckelord talar om huruvida meddelandet som ska skapas kommer att vara privat eller inte. Du anger "Yes" om det ska vara privat eller "No" om det ska kunna ses av alla. Observera att om du skriver echomail kommer det automatiskt att kunna ses av alla, och om du skriver netmail kommer det automatiskt att vara privat, s† i dessa b†da fall beh”ver du inte anv„nda detta nyckelord.

exempel:
Private Yes

  Semaphore <s”kv„g och filnamn till semaforfil> [*]

Med detta nyckelord kan du styra postningen av meddelandet med en s.k semaforfil. Om denna fil inte existerar kommer inget meddelande att skapas. Semaforfiler „r vanligen 0-bytesfiler som skapas av ett program f”r att tala om f”r andra program att ett visst l„ge har uppst†tt, t.ex att det har loggat in en ny anv„ndare p† BBS:en. Semaforfilen tas inte bort av Announcer.

Detta kan „ven anv„ndas f”r att posta meddelanden bara om meddelandefilen finns (annars kommer ju Announcer ge ett felmeddelande), anv„nd samma filnamn p† semaforfilen som p† meddelandefilen. (Du kan g”ra samma sak med MinSize).

Om du i st„llet vill att Announcer ska skapa en semaforfil om meddelandet postades, se nyckelordet 'Create'.

exempel:
Semaphore C:\TIMED\NETMAIL.SEM

  Split <antal delar> [*]
  Split @<maximal delstorlek> [*]

Om meddelandefilen som du vill posta „r stor, och inte alla brevhanterare p† v„gen till destinationen klarar av att hantera meddelanden av den storleken, kan du anv„nda detta nyckelord f”r att dela upp den i det antal delar du ”nskar.

Det „r „ven m”jligt att ange den maximalt till†tna storleken som de resulterande meddelande f†r ha, i s† fall ska du skriva ett snabel-a ("@") framf”r storleken i byte. Storleken inkluderar inte kludgarna. Meddelandena kommer fortfarande att delas upp j„mnt ”ver texten.

Vid postning till Squishdatabaser st”der de rutiner som anv„nds meddelanden p† maximalt ungef„r 33000 tecken. Om du specificerar st”rre delar, „ven om det „r f”r att du saknar Split-nyckelord, kommer meddelandet att delas upp s† att varje del ej ”verstiger 33000 tecken.

Om du vill att avs„ndaradressen som anges i SPLIT-kludgen ska vara korrekt m†ste du ange en Orig-adress, „ven f”r lokala meddelanden.

Det g†r inte att anv„nda b†da varianterna p† Split tillsammans i samma meddelandemall.

exempel:
Split 2
Split @10000

  Subject <„renderad>

H„r anger du vilken „renderad som ska anv„ndas f”r det meddelande som ska skapas. Om inte meddelandebasformatet begr„nsar det ytterligare, „r maxl„ngden p† „renderaden 75 tecken, om du anger en f”r l†ng „renderad kommer den att trunkeras till maxl„ngden.

exempel:
Subject Tio-i-topp brevskrivare

  TagLine <den tagline som ska anv„ndas> [*]

Med detta nyckelord definierar du om en tagline ska l„ggas till i meddelandet eller inte. Om du inte har med nyckelordet kommer ingen tagline att anv„ndas. Du kan „ven best„mma om det ska vara samma tagline varje g†ng (en s.k statisk tagline), eller om den ska variera varje g†ng genom att slumpvis l„sa ur den fil du har specificerat med TagLineFile i de globala inst„llningarna (se denna sektion).

Om du vill ha samma tagline varje g†ng skriver du taglinens text efter nyckelordet (maximalt 80 tecken „r till†tna), och om du vill ha ett slumpval skriver du endast ett snabel-a ("@").

exempel:
TagLine @

  To <mottagarnamn  **]
  To @<namn p† s„ndlistefil> [*]

H„r anger du vilket mottagarnamn som ska anv„ndas f”r det meddelande som ska skapas. mm inte meddelandebasformatet begr„nsar det ytterligare, „r maxl„ngden p† namnet 35 tecken, om du anger f”r l†nga namn kommer det att trunkeras till maxl„ngden. Om du inte anger n†got mottagarnamn kommer detta f„lt att l„mnas tomt.

Om du vill g”ra en s„ndlista (dvs. posta samma meddelande till flera personer), skriver du ett snabel-a ("@") f”ljt av namnet p† den fil som inneh†ller alla mottagare i s„ndlistan i.st.f mottagarnamnet. Denna fil best†r av rader med mottagaradress och mottagarnamn separerade med ett mellanslag. F”r mer information, se kapitlet "Anv„nda s„ndlistor"

Det g†r inte att anv„nda b†da varianterna p† To tillsammans i samma meddelandemall.

exempel:
To Alla
To @MYLIST.TXT

  UpdatedSend <uppdateringsflagga>

Med detta nyckelord kan du styra om meddelandefilen endast ska postas om den uppdaterats sedan den senast postades. Om du anger "Yes" kommer fildatumet att kollas mot senaste postningdatum, och meddelandet kommer inte att postas om filen „r „ldre „n detta datum. Om du anger "No" kommer ingen s†dan kontroll att g”ras.

exempel:
UpdatedSend Yes

        {%-variablerna}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄ

F”r att g”ra det enklare att skicka ett brev till flera olika personer utan att beh”va g† in och redigera konfigurationsfilen f”r varje g†ng, „r det m”jligt att ange upp till tio parametrar p† kommandoraden. Dessa parametrar kan anv„ndas f”r s„ndar-/mottagarnamn, „renderad, filnamn, mottagaradress i netmail, och alla andra inst„llningar som ing†r i meddelandemallarna.

F”r att anv„nda dig av de parametrar du skickar p† kommandoraden anv„nder du variablerna "%1" till "%10" i konfigurationsfilen. Numreringen motsvarar den inb”rdes ordningen p† kommandoraden. Dessa kommer d† att bytas ut mot de parametrar du angav. Om du vill ha med ett mellanslag i namnet m†ste det ers„ttas med ett understreck ("_") p† kommandoraden.

Exempel: Vi vill skicka ett v„lkomstmeddelande till nya BBS-medlemmar, och vill ha en speciell konfigurationsfil som vi vill anv„nda vid de tillf„llena. D† „r en kombination av /I-parametern (f”r information om denna parameter, se kapitlet "Kommandoradsformat"), namn p† kommandoraden och variabler bra att ha. S„g att vi definierar meddelandemallen p† det h„r s„ttet:

    MSG
    File NYUSER.TXT
    Subject Ny anv„ndare - v„lkommen
    To %1
    From Sysopus Anonymous
    Path SC:\MAX\MSG\SYSOP
    Tagline Min lilla BBS - f”r dig och mig
    Private Yes
    .end

Om vi kallar konfigurationsfilen f”r NYUSER.INI, och vill v„lkomna Kalle Kula, skriver vi bara s† h„r p† kommandoraden:

    ANNOUNCE /INYUSER.INI Kalle_Kula

%1 p† To-raden kommer d† att bytas ut mot "Kalle Kula" och meddelandet kommer att se ut s† h„r:

    Fr†n: Sysopus Anonymous              (privat)
    Till: Kalle Kula
    Žmne: Ny anv„ndare - v„lkommen
    =============================================
    ..inneh†llet i filen nyuser.txt..

    ... Min lilla BBS - f”r dig och mig

Om du gl”mmer att ange n†got namn p† kommandoraden kommer variablerna att ers„ttas med "Announcer", och meddelandet ovan skulle ha postats till Announcer.

Om du vill l„gga in datum och tid n†gonstans, t.ex p† „renderaden, kan du anv„nda specialvariablerna "%d%" (datum) och "%t" (tid). Datum och tid kommer att l„ggas in i enlighet med din dators landsinst„llningar. Till skillnad fr†n %1-%10 kan dessa variabler f”rekomma inuti en str„ng, och d† kommer bara den delen av str„ngen att ers„ttas.


        {Anv„nda s„ndlistor}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

S„ndlistor „r ett bekv„mt s„tt att posta samma meddelande till flera personer p† samma g†ng. S„g exempelvis att du „r ordf”rande i en lokal datorklubb, och att du vill skicka en bulletin i netmail till samtliga medlemmar varje m†nad. Att posta varje individuellt meddelande, eller att s„tta upp en mall f”r varje mottagare tar tid, det enklaste s„ttet „r att s„tta upp en s„ndlista.

F”r att tala om f”r Announcer att det „r en s„ndlista du vill skapa, och inte ett normalt brev, m†ste du skapa en fil som inneh†ller alla namn och adresser, och peka till den filen i meddelandemallen. Formatet p† s„ndlistefilen „r enkelt, varje rad inneh†ller adressen till mottagaren, f”ljt av namnet, de b†da f„lten avdelade med ett mellanslag. F”r att Announcer ska f”rst† att det „r en lista med namn det ska leta efter skriver du ett snabel-a ("@") framf”r filnamnet vid nyckelordet To.

Announcer kommer att identifiera meddelanden som postas till en s„ndlista genom att s„tta in en speciell kludge, "NOTE", vilken visar namnet p† s„ndlistefilen. Om du vill „ndra detta till n†gon b„ttre beskrivning skriver du namnet p† filens f”rsta rad, och inleder den med ett semikolon (";").

Exempel: en datorklubbsbulletin:

F”rst skapar vi en fil "BULLETIN.LST" som inneh†ller namnen p† mottagarna (bara tv† personer i det h„r exemplet):

    ;Datorbulletin
    7:342/169.31 Kalle Kula
    8:412/961.17 Kajsa Kula

Sedan s† s„tter vi upp en meddelandemall som pekar till s„ndlistefilen:

    Msg
    File BULLETIN.TXT
    Subject Datorklubben X:s bulletin
    To @BULLETIN.LST
    From Nisse Kula
    Orig 7:342/117
    Path JC:\RA2\NETMAIL
    Distribution Netmail
    .end

Dessa inst„llningar kommer att resultera i f”ljande tv† meddelanden (endast huvudet och NOTE-kludgen visas i detta exempel):

    Fr†n: Nisse Kula (7:342/117)
    Till: Kalle Kula (7:342/169.31)
    Žmne: Datorklubben X:s bulletin
    =============================================
    ^aNOTE: Mailing list "Datorbulletin"
    ...

    Fr†n: Nisse Kula (7:342/117)
    Till: Kajsa Kula (8:412/961.17)
    Žmne: Datorklubben X:s bulletin
    =============================================
    ^aNOTE: Mailing list "Datorbulletin"
    ...

Eftersom det bara sparas undan ett MSGID f”r varje mall kommer inga REPLY-kludgar att skapas f”r s„ndlistor, „ven om du har satt "ReplyKludge Yes" i de globala inst„llningarna.

Observera att det inte „r m”jligt att kombinera det tv† formerna p† To-nyckelordet. Om meddeladdefilen inte skulle hittas, kommer @-tecknet att antas vara en del av mottagarnamnet, vilket g”r det m”jligt att posta till n†gon som har ett @ som det f”rsta tecknet i namnet.

        {Skapa .PKT-filer}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

Announcer kan direkt skapa typ "2+" PKT-filer (meddelandepaket). Det kallas ".PKT-l„ge" (eller ".PKT mode" p† engelska). Anv„ndningen av Announcer i detta l„ge skiljer sig n†got fr†n det normala, varf”r detta har beskrivits i ett eget kapitel.

F”r att starta .PKT-l„ge m†ste du definiera de fyra globala nyckelorden "PktMode", "PktPath", "PktFrom" och "PktTo". Om du utesluter n†gon av dem kommer Announcer att ha problem att utf”ra sitt jobb, men pga det s„tt Announcer hanterar konfigurationsfilen kommer det inte att avslutas med ett felmeddelande. De tv† nyckelorden "PktPwd" och "BinkleyName" „r frivilliga. H„r f”ljer detaljerade beskrivningar ”ver de sex nyckelorden (ordnade alfabetiskt):

  BinkleyName <Yes/No> [valfritt]

Med detta val satt till "Yes" talar du om f”r Announcer att anv„nda BinkleyTermvarianten av namn, "aaaabbbb.OUT" (d„r aaaa „r mottagarn„tnumret hexadecimalt, och bbbb „r mottagarnodnumret, „ven det hexadecimalt). P† det s„ttet beh”ver du inte g† genom n†gra andra meddelandehanterarprogram f”r att f† iv„g ett meddelande i samband med en mailer av Binkleytyp.

BinkleyName standardv„rde „r "No", vilket skapar paketnamn av typen "nnnnnnnn.PKT", d„r nnnnnnnn „r antalet sekunder sedan den 1 januari 1970 (Unixtid) skrivet hexadecimalt. Detta „r samma typ av tal som anv„nds f”r MSGID-genereringen.

Om PKT-filen som Announcer f”rs”ker skriva redan existerar kommer Announcer att l„gga till meddelanden i slutet. Inneh†llet i PKT-filens huvud kommer inte att „ndras.

exempel:
BinkleyName Yes

  PktFrom <avs„ndaradress>

Detta nyckelord anger avs„ndaradressen f”r .PKT-filen. Detta „r oftast samma adress som avs„ndaradressen hos de meddelanden som finns i paketet.

exempel:
PktFrom 2:204/145.42

  PktMode <tempor„r s”kv„g f”r .MSG-filer>

PktMode „r det "magiska" nyckelordet som st„ller in Announcer i .PKT-l„ge. Det s”rjer dessutom f”r att definiera vilken katalog Announcer kan skapa sina tempor„ra .MSG-filer i (Announcer kommer inte direk  att skapa en .PKT-fil, utan i st„llet kommer det att skapas en .MSG-fil f”r varje meddelande i den katalog som definieras h„r. Dessa meddelanden kommer sedan att packas in i .PKT-filen).

Alla filer med „ndelsen .MSG kommer att tas bort fr†n denna katalog n„r Announcer „r klar. Announcer kommer att l„gga in SAMTLIGA .MSG-filer som den hittar i den h„r katalogen, inte bara de det sj„lv har skapat.
exempel
PktMode C:\TEMP

  PktPath <katalog att skapa .PKT-filen i>

Detta nyckelord specifccerar katalogen i vilket .PKT-filen kommer att skapas.

exempel:
PktPath C:\BINKLEY\INBOUND

  PktPwd <l”senord i .PKT-fil> [valfritt]

Med detta valfria nyckelord kan du st„lla in vilket l”senord som ska skrivas i .PKT-filen.

exempel:
PktPwd SECRET

  PktTo <destinationsadress>

Detta nyckelord specificerar .PKT-filens destinationsadress. Den kan vara samma som avs„ndaradressen.

exempel:
PktTo 2:204/145.0

Observera att nyckelordet "EchoTossLog" inte har n†gon effekt n„r Announcer „r i .PKT-l„ge.

F”rutom dessa f”r„ndringar i den globala sektionen tillkommer n†gra mindre f”r„ndringar bland meddelandemallarna:

  Distribution <typ av meddelandearea>

Detta nyckelord „r obligatoriskt i .PKT-l„ge. Dessutom „r distributionsmetoden "Local" inte tillg„ngligt, i detta l„ge kan endast "NetMail" och "EchoMail" anv„ndas.

exempel:
Distribution EchoMail

  Echo <m”testag>

Detta nyckelord „r obligatoriskt vid skrivning av echomail i .PKT-l„ge, eftersom m”testagen m†ste vara k„nd. Det anv„nds inte f”r EchoToss.Log/EchoMail.JAM-fil, eller tillsammans med tosserkonfigurationsfiler.

exempel:
Echo R20_INTERNET

Nyckelordet "Path" kan inte avv„ndas i .PKT-l„ge. Programmet kommer att avbrytas med ett felmeddelande om du g”r det. Eftersom alla .MSG-filer skapas i den tempor„ra katalogen finns det inget behov att specificera en alternativ s”kv„g.

Det b”r „ven noteras att .PKT-l„ge och normalt l„ge kan kombineras i en och samma konfigurationsfil, men bara till en viss del. N„r v„l .PKT-l„get „r p†slaget g†r det inte att sl† av. Det „r „ven endast m”jligt att skapa en .PKT-fil f”r varje konfigurationsfil. Om du skriver ett nytt PktMode-nyckelord kommer den f”reg†ende att gl”mmas bort, och .PKT-filen kommer i st„llet att skapas f”r den nydefinierade katalogen. Samma restriktion g„ller f”r PktPath.

F”r att kombinera normalt och .PKT-l„ge kan konfigurationsfilen se ut s† h„r:

    LogFile C:\ANNOUNCE\ANNOUNCE.LOG

    ; Det h„r meddelandet postas i normall„ge, i en
    ; lokal Squisharea
    Msg
    From SysOp
    To All
    Subject Tio i topp
    File TIOITOPP.TXT
    Path SC:\MAX\MSG\TIOITOPP
    .End

    ; Nu startar vi .PKT-l„get
    PktMode C:\TEMP
    PktPath C:\SQUISH\INBOUND
    PktFrom 2:206/221.1
    PktTo 2:206/221.0

    ; Det h„r meddelandet kommer att postas i netmail
    ; via en .PKT-fil
    Msg
    From Announcer
    To SysOp
    Subject Tio i topp
    File TIOITOPP.TXT
    Orig 2:206/221.1
    Dest 2:206/221.0
    Distribution NetMail
    .End

        {Spr†k}
        ÄÄÄÄÄ

Det h„r programmet kan k”ras b†de p† svenska och engelska. Programmet kollar din landsinst„llning (COUNTRY i CONFIG.SYS) och st„ller in sig automatiskt p† svenska om du bor i Sverige, Norge, Danmark eller Finland, och annars p† engelska. F”r att g”ra en annan inst„llning kan du anv„nda milj”variabeln ANNLANG. Den kan ha n†got av dessa v„rden:

    SWE    svenska
    ENG    engelska

Du st„ller in det med kommandot SET, exempelvis:

    SET ANNLANG=ENG

s„tter spr†ket till engelska. Om du vill s„tta ett spr†k automatiskt n„r du startar datorn kan du l„gga in denrraden i din AUTOEXEC.BAT-fil.

        {Versionshistoria}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

0.10beta        1995-03-08
* F”rsta versionen

0.11beta        1995-07-19
+ Strippar alla tecken under 32 (mellanslag) f”rutom CRLF

0.20beta        1995-08-01
+ Kan anv„nda andra konfigurationsfiler „n LOCPOST.INI
+ Kan ta tv† namn p† kommandoraden f”rutom namn p† INI-fil
* Bytte formatet p† INI-filen
* Bytte fr†n Bluewave-bragline (~~~) till standard (___)

0.21beta        1995-08-19
! Kollar om konfigurationsfilen existerar
+ L„gger in en TerMail-3.00-MOOD-kludge
- Inga MSGIDer skapas
* Bytte formatet p† INI-filen igen... L„ttare att ut”ka
* Bytte fr†n bragline (___) till tearline (---)

0.22beta        1995-10-28
! Klagar inte p† fel i LOCPOST.INI, utan i den aktuella INI-filen
+ Taglinest”d
+ Intern registreringsmodul (samma version till alla!)
+ Valbar braglineintro (s† nu kan ni v„lja sj„lva :-) )
* Du kan ange namn p† kommandoraden utan att speca annan INI-fil
* Bytte INTE formatet p† INI-filen, utan ut”kade det bara :-)
* Skriver feltexter via STDERR i.st.f STDOUT

0.23beta        1995-10-31
! Registreringsnyckeln funkade visst inte alls :-(

0.25beta        1995-11-09
! Nu fungerar det med understreck i namnen p† kommandoraden igen
+ Det finns nu m”jlighet att logga till fil

0.30beta        1996-01-07
! Taglineintrostr„ngen ANVŽNDES inte riktigt s† d„r bara
+ MSGID (valbar, och med valfri str„ng, i lokala meddelanden)
+ Kan skapa netmail och echomail
- MOOD-kludge bara i lokala meddelanden
* Namnbyte fr†n LocalPost till Announcer
* Texter p† b†de engelska och svenska
* Kan l„sa taglines slumpm„ssig ur valfri textfil

0.31beta        1996-02-03
! L„sningen av slumpvald tagline r„ttad
! R„ttade vissa engelska texter
! Echomail och Squish fungerar nu
+ FMPT- och TOPT-kludgar skapas i netmail
+ Skapar REPLY-kludgar
+ Intervallhantering
+ Huvud- och fotfiler

1.00            1996-04-27
! Klarar av ini-filnamn utan .INI
+ Lade till /D f”r att visa information
+ Lade till /Q f”r att tysta Announcer
+ Lade till /M f”r att rensa i datafilen
* Žndrade loggtexterna n†got

1.1             1996-08-14
! Fixade en bugg med kludgar i baser av Squishtyp
+ Lade till st”d f”r semaforfiler
+ Lade till m”jlighet att st„nga av REPLY-kludge
+ Kan dela upp meddelanden i flera delar
+ M”jlighet att specificera minsta storlek p† filen
+ S„ndlistor
+ ™vers„ttningstabeller f”r andra teckenupps„ttningar
+ M”jlighet att posta bara om meddelandefilen uppdaterats
+ Kan skapa PKT-filer
+ Kan skapa PID-kludge i.st.f tearline
+ Kan s„tta fler attribut p† texterna
- Tog bort MOOD-kludgen helt, den var „nd† r„tt meningsl”s
* Kontrollerar att tillr„ckligt med parametrar anges
* Žndrade MSGID-genereringen f”r att minska dubblettrisken
* Loggar echotag i.st.f meddelandebas i loggfilen

1.11            1997-03-05
! Avdelningsposition ber„knas p† hela meddelandet
! R„ttat bugg med f”rsvunna rader i netmail i Squishbaser
! Skriver bara postningsdatumet d† meddelande verkligen postats
+ St”d f”r paket enligt FSC-0048
+ M”jlighet att posta enbart p† vissa datum
+ Split kan nu ange den maximala storleken p† varje del
+ Simuleringsl„ge
+ PlaceHolder
+ Flera kommandoradsv„xlar utan mellanslag mellan
+ St”d f”r kludge f”r fast breddsteg
* Anger echotag i loggfil „ven d† meddelanden ej postas
* Vissa l†nga loggrader delas upp

1.2             1997-11-22
! Nollst„llning av poster som ursprungligen „r PlaceHolder
! Mellanslag mellan nyckelord och data accepteras
! Klarar stycken l„ngre „n 255 tecken.
! Fixade bugg i hantering av attribut i *.MSG-areor
! Loggar bara till echotoss.log f”r echomailareor
! SEEN-BY-bugg fixad
! Buggfixar i INI-hanteringen
+ Lade till /F[A] f”r att framtvinga postning
+ Lade till /L f”r att inte uppdatera senaste postningsdatum
+ Lade till konvertering fr†n ASCII med paritet
+ "+ISO", "+SV7" f”r postning av icke-PC8-filer
+ St”d f”r ECHOMAIL.JAM/NETMAIL.JAM
+ St”d f”r IDSERVER, nyckelord: IdServer
+ L„ser tosserdata fr†n SqusihMail, FMail, GEcho, TerMail
+ Lade till %d% och %t% f”r att infoga datum och tid
+ M”jlighet att sl† av tearline i netmail
* /M nollst„ller nu PlaceHolder-poster i datafilen
* Intern checksummaber„kning i EXE-filen
* EXE-filen ej l„ngre packad
* Upp till tio namn (%1-%10) p† kommandoraden
* Nytt registeringskodsformat

                1998-03-07
* Programmet sl„ppt under GPL

        {Planer inf”r kommande versioner}
        ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

* OS/2-version [under utveckling]
* Val av max antal rader vid delning av meddelanden

        {Tack}
        ÄÄÄÄ

Jag vill tacka betatestarna, Peter Korkala (a.k.a PKaze) och Mikael Klasson (a.k.a Omega/Moment 22), f”r all hj„lp med att hitta buggar och att hitta p† nya funktioner! Utan er hade det h„r programmet inte varit vad det „r. Tack!

Tack „ven till Carl Olofsson och Leif T Andersson f”r hj„lpen med id‚er om hur man l„ser en slumpm„ssig rad ur en fil.

Tack f”r id‚er fr†n Fredrik Fischer, Cristoffer Crussell och Andreas Selstam.

Tack till Andreas Hansson och Harald Fragner f”r information om hur man g”r v„nteslingor utan att st”ra multitaskande operativsystem.

Tack till de som registrerade programmet medan det fortfarande var shareware!

Programmet anv„nder kod skriven av Eddy L O Jansson, Fidonet#2:206/233, som „r sl„ppt som Public Domain. Dessutom anv„nds modulen NLS.PAS, skriven av Thomas Mainka, med tillst†nd fr†n f”rfattaren, samt rutinen check_date, skriven av Michael Hoenie, h„mtad fr†n SWAG-arkivet.

Slutligen anv„nds en sm†tt modifierad version av Mythical Kingdom Softwares "MK Msg Access Source", som „r copyright 1992-1994 av Mark May, denna „r sl„ppt som freeware. Denna anv„nder delar av JAM-API:t, JAM(mbp) - Copyright 1993 Joaquim Homrighausen, Andrew Milner, Mats Birch, Mats Wallin. ALL RIGHTS RESERVED.

Den h„r dokumentationens siduppdelning och inneh†llsf”rteckning skapades av Pager version 4.2c fr†n Softwolves Software.

I dokumentationen n„mnda varum„rken:

Varum„rke                    Žgare
=========                    =====
BinkleyTerm                  Bit Bucket Software, Co.
Blue Wave                    Cutting Edge Computing
FMail                        Folkert J. Wijnstra
FrontDoor/APX                Definite Solutions
GEcho                        Gerard J. van der Land
Squish, SquishMail           Lanius Corporation
TerMail                      Bo Bendtsen, SerWiz

Varum„rken som gl”mts i denna lista „r erk„nns fortfarande som varum„rken hos sina respektive „gare.