Primer

V spodnjem primeru bo določen material odčitan iz preglednice (WMAT.TAB) in kot besedilo shranjen v parameter QS. Spodnji primer prikazuje možno uporabo in potrebne programske korake.

 
Tip

Besedila iz parametrov QS lahko npr. s pomočjo funkcije FN 16 uporabite tudi v lastnih datotekah protokolov.

Uporaba sinonima

0 BEGIN PGM SQL_READ_WMAT MM

1 SQL Q1800 "CREATE SYNONYM my_table FOR 'TNC:­\table­\WMAT.TAB'"

; ustvarjanje sinonima

2 SQL BIND QS1800 "my_table.WMAT"

; povezava parametra QS

3 SQL QL1 "SELECT WMAT FROM my_table WHERE NR==3"

; določanje iskanja

4 SQL FETCH Q1900 HANDLE QL1

; izvedba iskanja

5  SQL ROLLBACK Q1900 HANDLE QL1

; zaključek transakcije

6 SQL BIND QS1800

; prekinitev povezave parametra

7 SQL Q1 "DROP SYNONYM my_table"

; brisanje sinonima

8 END PGM SQL_READ_WMAT MM

Korak

Razlaga

1

Ustvarjanje sinonima

Poti dodelite sinonim (zamenjava dolgih navedb poti s kratkim imenom)

  • Pot TNC:­\table­\WMAT.TAB se vedno nahaja med narekovaji zgoraj
  • Želeni sinonim se glasi my_table

2

Povezava parametra QS

S stolpcem preglednice povežite parameter QS

  • QS1800 je v NC-programih prosto na voljo
  • Sinonim zamenja vnos celotne poti
  • Določen stolpec iz preglednice se glasi WMAT

3

Določanje iskanja

Določitev iskanja vsebuje navedbo vrednosti prenosa

  • Lokalni parameter QL1 (prosta izbira) je namenjen za identifikacijo transakcije (možnih je več istočasnih transakcij)
  • Sinonim določa preglednico
  • Vnos WMAT določa stolpec preglednice postopka branja
  • Vnosa NR in ==3 določata vrstico preglednice postopka branja
  • Izbrani stolpec preglednice in vrstica preglednice določata celico postopka branja

4

Izvedba iskanja

Krmiljenje izvede postopek branja

  • SQL FETCH kopira vrednosti iz možnosti Result-set v povezani parameter Q ali QS
    • 0 uspešen postopek branja
    • 1 napačen postopek branja
  • Sintaksa HANDLE QL1 je s parametrom QL1 označena transakcija
  • Parameter Q1900 je povratna vrednost za preverjanje, ali so bili podatki prebrani

5

Zaključek transakcije

Transakcija bo zaključena, uporabljena sredstva pa sproščena

6

Prekinitev povezave

Povezava med stolpcem preglednice in parametrom QS se prekine (potrebna sprostitev sredstev)

7

Brisanje sinonima

Sinonim bo ponovno izbrisan (potrebna sprostitev sredstev)

 
Tip

Sinonimi predstavljajo izključno alternativo za potrebne absolutne navedbe poti. Vnos relativne navedbe poti ni možen.

Naslednji NC-program prikazuje vnos absolutne poti.

0  BEGIN PGM SQL_READ_WMAT_2 MM

1  SQL BIND QS 1800 "'TNC:­\table­\WMAT.TAB'.WMAT"

; povezava parametra QS

2  SQL QL1 "SELECT WMAT FROM 'TNC:­\table­\WMAT.TAB' WHERE NR ==3"

; določanje iskanja

3  SQL FETCH Q1900 HANDLE QL1

; izvedba iskanja

4  SQL ROLLBACK Q1900 HANDLE QL1

; zaključek transakcije

5  SQL BIND QS 1800

; prekinitev povezave parametra

6  END PGM SQL_READ_WMAT_2 MM