⟦b34ce1fd9⟧

TextFileVerbose

>fo OI.DCSYS.2/1
>a1 INTRODUKTION
Dette skrift er en instruktuion i brugen af operat|r_konsollen tilsluttet
en DC i alarmsystemet.

Kommunikationen mellem en operat|r og alarm_systemets applikationer
foreg}r som en dialog p} to niveauer, et basalt og et egentligt niveau.

Operat|ren afgiver kommandoer i MML (Man - Machine - Language), hvor
syntaksen er en del_m{ngde af CCITTs rekommen_dationer (Z.311-Z.359).

P} det 
>ul
basale dialog_niveau
svarer DC med et indikator_symbol < (mindre end). P} det 
>ul
egentlige dialog_niveau
reagerer DC med tre typer af udskrifter henholdsvis syntaks_fejl 
detekteret, semantik_fejl detekteret og egentlig kommando funktions_respons.

En dialog kan initieres udefra, dels fra en vagt_operat|r og dels fra
systemet ved at DC-operat|ren anmodes om at reagere p} en udskrift.

>a1 KOMMANDOFORMAT
En MML operat|rkommando er et kommandonavn (en 5-bogstavs_kode)
efterfulgt af hen_holds_vis et : (kolon), et antal parame_tre
adskilt af , (komma) samt et ; (semikolon). Kommandoen afsluttes
med vognretur (RETURN).

   kommandonavn : parameterblok; (RETURN)

>a2 Kommandonavne
Et operat|r_kommandonavn er en mnemo_teknisk 5-bogstavs_kode. De to f|rste
bogstaver betegner en
>ul
funktionsgruppe
i alarm_systemet, de to n{ste bogstaver angiver en
>ul
position
indenfor den tilh|rende funktions_gruppe, og det sidste bogstav
betegner
>ul
typen af handling
som |nskes udf|rt.

>a3 Funktionsgrupper
 AL  ALarmnet konfiguration
 PO  POll funktioner
 IP  Installations Parameter
 MD  generelle MeDellelser

>a3 Position i funktionsgrupper
 DC  Distrikts Center
 NC  Netgruppe Center
 VC  Vagt Central
 AT  Alarm Terminal
 AV  Alternativ Vagt
 LI  LInie
 PR  PRocessormodul
 PA  PArallelmodul
 LO  LOg
 TF  Transmissions Fejlt{ller
 SE  SErvice gr{nse
 SP  Stop Poll gr{nse
 MS  Max Succ liniefejl
 PT  Pakke T{ller

>a3 Type af handling
 A  Afl{s
 B  Begynd
 D  Dump
 I  Inds{t
 L  Load
 N  Nedl{g
 O  Opret eller Opdater
 P  Print
 S  Send eller Stop
 T  Test

>a3 Eksempler p} navne
Afh{ngigt af hvilket syn (funktions_orienteret eller handlings_orienteret)
man har p} systemet, kan det mnemo_tekniske indhold i en 5-bogstavs_kode
udtrykkes forskelligt.

F.eks. kan
>ul
alvco
b}de udtrykkes som "Vedr|rende alarmnet_konfigurationen |nskes vagt_central
oprettet" og som "Opret vagtcentral".

>ul
poats
kan udtrykkes som "Poll ved en alarmterminal |nskes stoppet" eller som
"Stop poll ved alarmterminal".

I|vrigt henvises til kommando_oversigten i bilag A.

>a2 Parameterformater
En blok af parametre best}r 
>ul
enten
af en positions_parameter_liste (kaldet PPL)
>ul
eller
af en navne_parameter_liste (kaldet NPL). En NPL er karakteri_seret
ved, at alle parametre er identi_ficerede, s}ledes at antallet af
parametre i een kommando
>ul
kan
variere, og s}ledes at parametrenes indbyrdes position er under_ordnet.
Ved en PPL identificeres parametrene ikke, hvilket betyder at
fortolknin_gen af parametrene alene afg|res udfra deres position
indenfor parameter_blokken.

>ex En NPL parameterliste

 alvco: vc=1-12-3-201, lp=2-12, type=at, modul=s;

>ex En PPL parameterliste

 alvco: 1-12-3-201, 2-12, at, s;

Ved formatangivelserne i de efterf|lgende afsnit, betyder d
et ciffer (engelsk digit), og antallet af d'er angiver det
maksi_male antal cifre, som m} skrives.
Tilsvarende betyder x et bogstav, og antal_let af x'er er det
mak_si_male antal bogstaver, som m} angives.

Semantisk betragtet kan der v{re begr{ns_ninger p} hvilke bogstaver
og hvor store tal, der m} benyttes.

I de tilh|rende eksempler er 'id=' angivet i parameter_beskrivel_serne
svarende til elementer i NPL parameterlister. F.eks. kan der st}
lp= eller type=. Disse 'id=' skal der ses bort fra i PPL
parameter_lister.

>a3 Adresseformater
I n{sten alle kommandoer indg}r een eller flere adresser som
parametre. Det vedr|rer enten adressen p} en alarm_terminal
eller adressen p} en vagt_central.

En adresse best}r af f|lgende fire dele:

     - distriktscentrets nummer
     - netgruppecentrets nummer
     - terminalstationens nummer
     - alarmterminalens eller vagtcentralens nummer

og skrives i MML som fire tal adskilt af - (tankestreg):

       d-dd-dd-dddd

Numrene skal ligge indenfor f|lgende intervaller:

   dc nummer i   1..9
   nc nummer i   1..63
   ts nummer i   1..63
   vc nummer i  32..255
   at nummer i 256..9999

<vcadr> har formatet d-dd-dd-dddd, hvor tallet dddd alts} skal ligge
i intervallet 32..255.

<atadr> har formatet d-dd-dd-dddd, hvor tallet dddd skal ligge
i intervallet 256..9999.

Terminalstation, netgruppecenter og distriktscenter kan ogs} 
adresseres separat med f|lgende formater:

 <tsadr>  har formatet d-dd-dd
 <ncadr>  har formatet d-dd
 <dcadr>  har formatet d

>ex Adresse parametre

 vcadr = 1 - 12 - 3 - 201
 atadr = 1 -  1 - 1 - 400
 tsadr = 1 - 12 - 3
 ncadr = 1 - 12
 dcadr = 1

>a3 Lam og port parameter <lp>
>ul
Format:
dd-dd.

Herved angives henholdsvis lam-nummer og port-nummer.

Lam-nummer skal ligge i intervallet 0..15 og
port-nummer i intervallet 3..15.

>ex <lp> angivelse
>sp0
lp = 4 - 5

>a3 Vagtcentral type <type>
>ul
Format:
xx.

En vagtcentral kan enten v{re af type alarm_terminal (at) eller af
type intelligent_terminal (it).
I proto_typen kan alarm_terminaler kun v{re af type at.

>ex <type> angivelse

 1) type = at
 2) type = it

>a3 Alarmterminal modultype <modul>
>ul
Format:
x.

En alarmterminal kan v{re udstyret med to forskellige inter_face
moduler enten serielt modul (s) eller parallel_modul (p).

>ex <modul> angivelse

 1) modul = s
 2) modul = p

>a3 Diverse koder <--kode>
>ul
Formater:
ddd.

De koder, som kan angives er <vckode> og <atkode> og disse
har alts} f{lles format.

For <vckode> g{lder, at det angivne tal skal ligge i intervallet
1..255.

For <atkode> g{lder, at tallet skal ligge i intervallet 0..255.

>ex <vckode> og <atkode>

 vckode = 14
 atkode = 28

>a3 Installationsparametre <ip>
>ul
Formater:
ddddd.

En installationsparameter, som kan opdateres, kan v{re max succ
linie_fejl, stop poll gr{nse, service_gr{nse eller transmissions_fejlt{ller.
Det er kun i opdaterings_kommandoerne, at disse parametre kan angives.

For en <ip> g{lder, at tallet skal ligge i intervallet 1..32767. For
transmission_fejlt{ller g{lder dog, at den kan antage v{rdien 0.

>ex <ip> angivelser

 ip = 812

>a1 OPSTART
Operat|ren vil ved opstart blive pr{_senteret for udskrif_ten

   81.06.03  16.33.48  phoenix startet
                     <

dvs dato, klokkeslet, og en tekst efter_fulgt af
indikator_symbolet < hvilket betyder, at distrikt_centret er
klar til at behandle input fra operat|ren.
   

>a1 ALARMNETKONFIGURATION FUNKTIONER
Positioner indenfor AL funktions_gruppen vedr|rer alarm_net_komponenterne
NC: net_gruppe_center, TS: terminal_station, VC: vagt_central,
AT: alarm_terminal, PR: processor_modul i en AT, PA: parallel_modul
i en AT, LI: logisk linie i alarmnet, AV: alternativ vagt og LO:
logfunktion i DC.

Kun positions_parameter_lister (PPL) vil blive gennem_g}et.

I de f|lgende afsnit er funktionerne opdelt efter diverse
typer af mulige handlinger.
Alle <--adr> formater kaldes logisk alarmnet adresse med mindre
andet er angivet.

>a2 Oprettelser
DC vil i prototypen p} forh}nd v{re oprettet med nummeret 1.

>a3 Opret netgruppecenter (NC)
Kommando

 alnco : <ncadr>, <ncadr>;

De to parametre har samme format. F|rste parameter angiver en
logisk alarmnet_adresse, mens anden parameter er den fysiske
adresse.

>ex
alnco : 1 - 17, 1 - 4;

>a3 Opret terminalstation (TS)
Kommando

 altso : <tsadr>, <tsadr>;

De to parametre har samme format. De angiver henholds_vis
logisk alarmnetadresse og fysisk adresse.
>ex 
altso : 1 - 17 - 3, 1 - 4 - 3;

>a3 Opret vagtcentral (VC)
Kommando

 alvco: <vcadr>, <lp>, <type>, <modul>;

>ex
alvco : 1 - 17 - 3 - 201, 4 - 5, at, s;

>a3 Opret alarmterminal
Kommando

 alato: <atadr>, <lp>, <modul>, <vcadr>,
        <type>, <blok>, <atkode>, <styr>;

En <blok> er en blok_l{ngde angivelse med formatet dd. Tallet
skal ligge i inter_vallet 1..1.

En <styr> parameter har generelt formatet xx. Dog kan der
angives xxx. Bog_staverne, der m} benyttes, er ja eller nej.

>ex
alato : 1-1-1-401, 4-6, p, 1-17-3-201, at, 1, 2, ja;

>a3 Opret alternativ vagt for AT
Kommando

 alavo: <atadr>, <vcadr>, <vckode>, <type>,
        <blok>, <atkode>, <styr>;

Ang}ende <blok> og <styr> se afsnittet opret_alarmterminal.

Det forlanges at <atadr> og <vcadr> er oprettet, og at <vcadr>
ikke er prim{r vagt_central.

>ex
alavo : 1-1-1-401, 1-1-7-202, 3, at, 1, 4, nej;

>a2 Nedl{ggelse
Operat|ren kan nedl{gge AT'er og VC'er. For AT'er g{lder, at poll
skal v{re stoppet, og at prim{r vagt_central har accepteret.

>a2 Loadning
Operat|ren kan specificere, at han/hun |nsker en NC eller en TS loadet.

>a3 Load af NC
Kommando

 alncl: <ncadr>;

>a3 Load af TS
Kommando

 altsl: <tsadr>;

>a3 Nedl{g vagtcentral
Kommando

 alvcn: <vcadr>;

<vcadr> skal p} forh}nd eksistere.
    
>ex
alvcn: 1-1-7-202;
   
>a3 Nedl{g alternativ vagt
Kommando
      
 alavn: <atadr>, <vckode>;
  
>ex
alavn: 1-1-7-202, 3;

>a3 Nedl{g alarmterminal
Kommando

 alatn: <atadr>;

<atadr> skal p} forh}nd eksistere.

>ex
alatn: 1-1-1-401;

>a2 Test
Operat|ren kan udf|re to forskellige test p} en alarm_terminal
henholdsvis test af processor_modul og test af parallel_modul.
Endvidere har operat|ren mulighed for at teste forbindelser
mellem en AT og VC.

>a3 Test af processormodul i AT
Kommando

 alprt: <adr>;

hvor <adr> kan v{re enten <atadr> eller <vcadr> for en vagt_central
af type at.

>ex
alprt: 1-17-3-201;

>a3 Test af parallelmodul i AT
Kommando

 alpat: <adr>;


<adr> kan v{re <atadr> eller <vcadr>

>ex 
alpat: 1-1-1-401;

>a3 Test af linieforbindelse mellem AT og VC
Kommando
 
 allit: <atadr>, <vcadr>;

<atadr> og <vcadr> beh|ver ikke at tilh|re samme DC.

>ex
allit: 3-8-1-401, 1-17-3-201;


>a2 Logning
Som tidligere n{vnt kan en dialog initieres af systemet. Dump
af logfilen er et eksempel p} dette.

Ved printning fra log_filen 
>ul
skal
der angives navne p} parametrene.

>a3 Dump af logfil
Kommando

 allod: mtxxdddd;

Det forlanges, at de to f|rste bogstaver er mt, d.v.s. en label
p} et magnetb}nd (engelsk magnetic tape).

>ex
allod: mtlo8104;

>a3 Print fra logfil
Kommando_formatet for allop er ikke korrekt angivet, idet der dels
er bindinger og friheder i parameter_angivelse. Fra = og til = kan
ikke angives samtidig med angivelsen af adr = . log = skal angives,
men derudover kan parametre udelades og st} i vil_k}rlig r{kke_f|lge.

Kommando

 allop: log = <medie>, stt = <tid>, slt = <tid>,
        fra = <adr>, til = <adr>, adr = <adr>,
        opk = <opk>;

>ul
stt
er en forkortelse for start tid.

>ul
slt
er en forkortelse for slut tid

Formatet af <tid> er dddddd-dddd hvor dddddd angiver }r, m}ned og dag
mens dddd angiver timer og minutter, f.eks.
810407 - 1435.
>ul
Fra, til og adr
har formatet <adr> d.v.s. d-dd-dd-dddd. Det er alts} muligt at
specificere printning af meddelelser som flyder fra een alarm_net_adresse
til en anden. Eller printning af meddelelser som flyder til og fra een
angivet alarm_net_adresse.

<opk> har formatet dd-dd, og er angivelse af, at alle meddelelser
med operations_kode dd-dd skal printes.

<medie> kan enten v{re disc eller mtxxdddd. Ang}ende mtxxdddd
se afsnittet dump fra logfil.

>ex
1) allop: log = disc, adr = 1-17-3-201, opk = 3-2,
   
2) allop: log = disc, stt = 810406 - 800, slt = 810407 - 800;

>a1 POLL FUNKTIONER
Positioner indenfor PO funktions_gruppen vedr|rer 
alarmnet_komponenterne vagt_centraler og alarm_terminaler.

Funktionerne er opdelt efter de mulige typer af handlinger.

For alle funktionerne g{lder, at den angivne alarmnet_adresse skal
eksistere i denne DC's database.

>a2 Begynd poll
Det har ikke v{ret muligt at benytte betegnelsen start poll, idet s
i "type af handling" st}r for stop poll. I de til komman_doerne
h|rende ud_skrifter vil der dog st} start poll.

>a3 Begynd poll ved VC
Kommando

 povcb: <vcadr>, <tf>, <ps>;

<tf> betyder transmissions_fejlt{ller. Formatet er ddd,
og tallet skal ligge i inter_vallet 0..999.

<ps> betyder poll st|rrelse, d.v.s. antal sekunder mellem hvert poll.
Formatet er ddd og tallet skal ligge
i intervallet 1..999.

>ex
povcb: 1-17-3-201, 0, 2;

>a3 Begynd poll ved AT
Kommando

 poatb: <atadr>, <tf>, <ps>;

Ang}ende <tf> og <ps> se forrige afsnit.

>ex
poatb: 1-1-1-401, 10, 1;

>a2 Stop poll
Der findes to stop poll kommandoer, henholds_vis stop poll
af VC og stop poll af AT.

Kommandoer
 
 povcs: <vcadr>;
 poats: <atadr>;

>a2 Test poll ved AT
Kommando

 poatt: <atadr>;

Kommandoen kaldes ogs} service poll af AT.

>a1 INSTALLATIONSPARAMETER FUNKTIONER
Positioner indenfor IP funktions_gruppen er maks successive
liniefejl (ms), stop poll gr{nse (sp) service_gr{nse (se), 
transmissions_fejlt{ller (tf) og pakke_t{ller (pt).

For alle funktionerne g{lder, at den angivne alarm_netadresse
skal eksistere i data_basen tilknyttet operat|rens DC.

>a2 Opdatering
Pakket{ller kan ikke opdateres. <adr> parameteren skal angive
enten en <vcadr> eller en <atadr>.

>a3 Opdater max succ liniefejl
Kommando

 ipmso: <adr>, <ip>;

>ex
ipmso: 1-1-1-401, 5;

>a3 Opdater stop poll gr{nse
Kommando
       
ipspo: <adr>, <ip>;
   
>ex 
ipspo: 1-1-1-401, 110;

>a3 Opdater servicegr{nse
Kommando

 ipseo: <adr>, <ip>;

>ex
ipseo: 1-1-1-401, 80;

>a3 Opdater transmissionsfejlt{ller
Kommando

 iptfo: <adr>, <ip>;

>ex
iptfo: 1-1-1-401, 0;

>a2 Afl{sning
Afl{snings_kommandoerne er s} simple, at de behandles samlet.

Kommandoer:

 Afl{s max succ liniefejl
   ipmsa: <adr>;
 Afl{s stop poll gr{nse
   ipspa: <adr>;
 Afl{s service gr{nse
   ipsea: <adr>;
 Afl{s transmissionsfejlt{ller
   iptfa: <adr>;
 Afl{s pakket{ller
   ippta: <adr>;

>ex
   ipmsa: 1-1-1-401;
   ipspa: 1-1-1-401;
   ipsea: 1-1-1-401;
   iptfa: 1-1-1-401;
   ippta: 1-1-1-401;

>ap
>a1 KOMMANDO OVERSIGT

 Opret NC
  alnco: <ncadr>, <ncadr>;

 Opret TS
  altso: <tsadr>, <tsadr>;

 Opret VC
  alvco: <vcadr>, <lp>, <type>, <modul>;

 Opret AT
  alato: <atadr>, <lp>, <modul>, <vcadr>,
         <type>, <blok>, <atkode>, <styr>;

 Opret linieforbindelse AT til VC
  alavo: <atadr>, <vcadr>, <vckode>, <type>,
         <blok>, <atkode>, <styr>;

 Load NC
  alncl: <ncadr>;

 Load TS
  altsl: <tsadr>;

 Nedl{g VC
  alvcn: <vcadr>;
       
 Nedl{g alternativ vagt
  alavn: <atadr>, <vckode>;

 Nedl{g AT
  alatn: <atadr>;

 Test linieforbindelse mellem AT og VC
  allit: <atadr>, <vcadr>;
 
 Test af processormodul i AT
  alprt: <adr>;

 Test af parallelmodul i AT
  alpat: <adr>;

 Dump af logfilen
  allod: <mt>;

>ne4
 Print fra logfiler
  allop: log = <medie>, stt = <tid>, slt = <tid>,
         fra = <adr>, til = <adr>, adr = <adr>,
         opk = <opk>;

 Begynd poll ved VC
  povcb: <vcadr>, <tf>, <ps>;

 Begynd poll ved AT
  poatb: <atadr>, <tf>, <ps>;

 Stop poll ved VC
  povcs: <vcadr>;

 Stop poll ved AT
  poats: <atadr>;

 Service poll (test) ved AT
  poatt: <atadr>;

 Opdater max succ liniefejl
  ipmso: <adr>, <ip>;

 Opdater stop poll gr{nse
  ipspo: <adr>, <ip>;

 Opdater service gr{nse
  ipseo: <adr>, <ip>;

 Opdater transmissionsfejlt{ller
  iptfo: <adr>, <ip>;

 Afl{s max succ liniefejl
  ipmsa: <adr>;

 Afl{s stop poll gr{nse
  ipspa: <adr>;

 Afl{s service gr{nse
  ipsea: <adr>;

 Afl{s transmissionsfejlt{ller
  iptfa: <adr>;

 Afl{s pakket{ller
  ippta: <adr>;

>a1 PARAMETERFORMATER

>ul
d
angiver et ciffer, og antallet af d'er angiver det maksimale antal
cifre, som m} skrives.
    
>ul
x
angiver et bogstav og antallet af x'er angiver det maksimale antal
bogstaver, som m} skrives.

 <dcadr>    d             1..9
 <ncadr>    d-dd          1..9 1..63
 <tsadr>    d-dd-dd       1..9 1..63 1..63
 <vcadr>    d-dd-dd-dddd  1..9 1..99 1..99 32..255
 <atadr>    d-dd-dd-dddd  1..9 1..63 1..63 256..9999
 <adr>      <atadr> eller <vcadr>
 <lp>       dd-dd         0..15 3..15
 <type>     xx for at eller it
 <modul>    x  for s eller p
 <atkode>   ddd           0..255
 <vckode>   ddd           1..255
 <ip>       ddddd         0..32767
 <styr>     xx(x) for ja eller nej
 <blok>     dd            1..99
 <tf>       ddd           0..999
 <ps>       ddd           1..999
 <mt>       mtxxdddd
 <medie>    mtxxdddd eller disc
 <tid>      dddddd-dddd   991231 2459
 <opk>      dd-dd         0..15 0..15
«eof»
DataMuseum.dk

RC3500

⟦b34ce1fd9⟧ TextFileVerbose

Derivation

TextFileVerbose
