In deze handleiding wordt uitgelegd op welke wijze er een update van een stored procedure in ISAH en/of Multivers Productie (MEP) voor Sybase dient te worden uitgevoerd. Binnen het maatwerk voor ISAH en/of MEP wordt door Wilhelm Tell veelal gebruikt gemaakt van stored procedures. Het kan zijn dat deze procedures moeten worden geupdate door klanten. Deze handleiding bevat instructies om een dergelijke update uit te voeren, omdat het uitvoeren van een update meestal niet tot het dagelijks werk van de klanten behoord.

Daarnaast voert Wilhelm Tell het liefst dergelijke updates zelf uit, maar het kan zijn dat u Wilhelm Tell niet vlot genoeg kan bereiken of er op dat moment voor Wilhelm Tell geen mogelijkheid bestaat om bij u in te bellen en u een script toestuurt om zelf een aanpassing uit te voeren. Deze handleiding is dan bedoeld om u te begeleiden bij de update.

Deze handleiding vervangt nu oude handleidingen welke in het verleden naar u toegestuurd zijn

Versie	Datum	Aanpassingen
1.0	28-2-2006	1e versie
1.1.	5-6-2007	Enkele verduidelijking aan hand feedback
1.2	27-2-2009	Publicatie InternetSite

Het handmatig uitvoeren van een update van een stored procedure in Sybase kan in de volgende stappen worden uitgevoerd, namelijk:

1. Zoek het *.sql bestand op welke de update dient uit te voeren of is toegestuurd.


2. Open het *.sql bestand in SQL-Advantage


3. Maak verbinding met de testomgeving van Sybase


4. Voer de update uit in SQL-Advantage


5. Test of de aanpassing in ISAH of MEP correct werkt


6. Voer de update uit in de productie-omgeving


7. Breng Wilhelm Tell op de hoogte van de uitgevoerde update


8. Los eventuele problemen bij het uitvoeren van deze stappen op

Open de mail en sla de attachment op een locatie op of ga naar de locatie waar het script is opgeslagen. In deze handleiding wordt er nu vanuit gegaan dat u gaat naar de map waar de script is opgeslagen. Deze scripts zijn te vinden in de Wilhelm Tell map Stored Procedures WilhelmTell in de ISAH-map

Wilhelm Tell map met scripts

Ga hierbinnen naar de map van de betreffende dag. In dit voorbeeld 5 januari 2009 hetgeen de map 20090105 is.

De scripts van Wilhelm Tell op 5 januari 2009

Wilhelm Tell slaat alle scripts welke ontwikkeld worden op de klantlocatie tijdelijk op in de directory stored procedures Wilhelm Tell waarbinnen verschillende mappen zijn te vinden met de datum van de aanpassing, bijvoorbeeld 20071028 voor de scripts van 28 oktober 2007. Hierbinnen kunnen scripts worden gevonden om eventueel een update tijdelijk terug te draaien als er problemen met de nieuwe functionaliteit optreden.



Dubbelklik vervolgens op het bestand of selecteer het bestand en druk vervolgens op de rechtermuisknop en kies dan voor openen

Het openen van een script in SQL-Advantage

Als het goed is, wordt het script in SQL-Advantage geopend.

Het script geopend in SQL-Advantage

Vervolgens dient er een verbinding te worden gemaakt met de Sybase Server. Ga hiervoor naar Server en kies vervolgens voor connect

Connectie met Sybase server vanuit SQL-Advantage

Het SQL-Advantage connect scherm zal dan verschijnen.

SQL-Advantage connect scherm

Vul hierbinnen het wachtwoord en de gebruikersnaam in

Let op: Het gebruikersnaam op de afbeelding is onjuist. Vanwege de beveiliging wordt in deze handleiding geen gebruikersnaam of wachtwoord gegeven. Deze dient bij u bekend te zijn.

Druk vervolgens op de connect knop.

Knop Connect met de Sybase Server

Als het goed dient het scherm er nu als volgt uit te zien.

SQL-Advantage na een succesvol connect

In de meeste gevallen zult u automatisch in de master database worden verbonden. Hierbinnen dient de update niet worden uitgevoerd en hierom dient u verbinding te maken met de testomgeving. Dit kunt u als volgt doen. Ga naar het keuzelijstje waarbinnen de databases zichtbaar is

SQL Advantage kies een database

Kies hierbinnen voor te testomgeving.

SQL Advantage connect testomgeving

Verricht vervolgens een update in de testomgeving. Dit script is als volgt uit te voeren. Ga naar de menuoptie Query en kies vervolgens voor Execute Query.

SQL Advantage het SQL-script uitvoeren

Als het goed is, wordt nu het script succesvol uitgevoerd. Hetgeen is te herkennen aan het feit dat de laatste regel onderin gelijk is aan return status = 0. Indien de laatste regel hiervan afwijkt, stop meteen met de update en neem contact op met Wilhelm Tell.

SQL-Advantage script succesvol uitgevoerd

Laat vervolgens de gebruiker proberen of het probleem daadwerkelijk door het draaien van het script wordt opgelost. Indien dit niet het geval is, dan verder geen update meer uitvoeren en contact opnemen met Wilhelm Tell.



Als het probleem door het draaien van het script in de testomgeving is verholpen, dan kan de update in de productie-omgeving worden uitgevoerd. Maak hiervoor contact met de productieomgeving in SQL-Advantage.

SQL-Advantage connect met de productie-omgeving

Voer vervolgens het script uit in de productie-omgeving.

SQL-Advantage script succesvol uitgevoerd productie-omgeving

Stuur vervolgens een bericht per mail of via het meldingensysteem naar Wilhelm Tell dat er een update is uitgevoerd en vermeld hierbij het script dat is gedraaid. Hiermee is Wilhelm Tell op de hoogte van de veranderingen en kan eventueel bij het terugdraaien van een aanpassing naar een definitieve oplossing worden gezocht. Tevens willen wij graag op de hoogte blijven van aanpassingen binnen uw database, zodat goede support kan worden geleverd.



Uitvoeren script niet succesvol
Indien het script niet succesvol is uitgevoerd, dan zal het resultaatscherm er als volgt uitzien.

SQL-Advantage uitvoeren script niet succesvol

Ga niet verder met updaten, maar stuur een bericht naar Wilhelm Tell kopieer hierbinnen de foutmelding en vermeld welk script is gedraaid. Wilhelm Tell zal zoeken naar een eventuele oplossing en contact met u opnemen.

SQL is een onbekend bestandstype
Bij het installeren van SQL-Advantage wordt vaak het type *.SQL niet geassocieerd met SQL-Advantage of het kan zijn dat er een ander programma wordt geopend. Indien dit optreedt volg dan de volgende stappen.

Hieronder verschijnt de melding dat SQL een onbekend bestandstype is.

SQL is een onbekend bestandstype

Kies hierbinnen voor de optie Het programma in een lijst selecteren

Kies bijbehorende programma

Kies vervolgens voor de optie bladeren.

Kies voor bladeren

Ga naar de map waar het uitvoeringsbestand van SQL-Advantage is te vinden.

Map van de SQL-Advantage exe

Selecteer hierbinnen het bestand sqladv.exe

Selecteer de SqlAdvantage exe

Druk vervolgens op de OK-Knop

Druk op de OK-knop

Als het goed is, wordt nu het script geopend in SQL-Advantage.

Het script geopend in SQL-Advantage