Příklad

V následujícím příkladu se přečte definovaný materiál z tabulky (WMAT.TAB) a uloží se jako text do QS-parametru. Následující příklad ukazuje možné použití a potřebné kroky programu.

 
Tip

Texty z QS-parametrů můžete používat například pomocí funkce FN 16 ve vlastních souborech protokolů.

Používání synonym

0 BEGIN PGM SQL_READ_WMAT MM

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

; Vytvoření synonyma

2 SQL BIND QS1800 "my_table.WMAT"

; Spojení QS-parametrů

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

; Definování vyhledávání

4 SQL FETCH Q1900 HANDLE QL1

; Provedení hledání

5  SQL ROLLBACK Q1900 HANDLE QL1

; Dokončení transakce

6 SQL BIND QS1800

; Zrušení vazby parametrů

7 SQL Q1 "DROP SYNONYM my_table"

; Smazání synonyma

8 END PGM SQL_READ_WMAT MM

Krok

Vysvětlení

1

Vytvořit synonymum

Cestě se přiřadí synonymum (dlouhý název cesty se nahradí krátkým názvem)

  • Cesta TNC:­\table­\WMAT.TAB je vždy mezi horními uvozovkami
  • Vybrané synonymum je my_table

2

Připojit QS-parametr

Ke sloupci tabulky se připojí QS-parametr

  • QS1800 je v NC-programu volně k dispozici
  • Synonymum nahrazuje zadání úplné cesty
  • Definovaný sloupeček z tabulky se nazývá WMAT

3

Definovat hledání

Definice hledání zahrnuje uvedení předávané hodnoty

  • Místní parametr QL1 (volně volitelný) slouží k identifikaci transakce (je možných více transakcí současně)
  • Synonymum určuje tabulku
  • Zadání WMAT určuje sloupeček tabulky pro čtení
  • Zadání NR a =3 určují řádky tabulky pro čtení
  • Vybrané sloupečky tabulky a řádky tabulky definují buňku čtení

4

Provést hledání

Řídicí systém provede čtení

  • SQL FETCH kopíruje hodnoty z Result-set do připojených Q-parametrů nebo QS-parametrů
    • 0 úspěšné čtení
    • 1 chybné čtení
  • Syntaxe HANDLE QL1 je transakce, určená parametrem QL1
  • Parametr Q1900 je vracená hodnota ke kontrole, zda byla data přečtena

5

Ukončení transakce

Transakce se ukončí a použité prostředky se uvolní

6

Uvolnit vazbu

Zruší se vazba mezi sloupečkem tabulky a QS-parametrem (potřebné uvolnění Ressourcen)

7

Smazat synonymum

Synonymum se znovu smaže (potřebné uvolnění Ressourcen)

 
Tip

Synonyma představují výlučně alternativu k nezbytnému absolutnímu zadání cesty. Zadávání relativních cest není možné.

Následující NC-program ukazuje zadání absolutní cesty.

0  BEGIN PGM SQL_READ_WMAT_2 MM

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

; Spojení QS-parametrů

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

; Definování vyhledávání

3  SQL FETCH Q1900 HANDLE QL1

; Provedení hledání

4  SQL ROLLBACK Q1900 HANDLE QL1

; Dokončení transakce

5  SQL BIND QS 1800

; Zrušení vazby parametrů

6  END PGM SQL_READ_WMAT_2 MM