Migration d un serveur SAS/IntrNet 6.12 vers un serveur SAS/IntrNet 8.2

Transcription

1 Migration d un serveur SAS/IntrNet 6.12 vers un serveur SAS/IntrNet 8.2

2 SOMMAIRE 1) INTRODUCTION ) VUE RAPIDE DE L APPLICATION DISPATCHER ) MISE EN PLACE DU SERVEUR SAS/INTRNET ) LE PROGRAMME CGI : BROKER ) LES DONNEES : ) LES PROGRAMMES ) LES PROGRAMMES SAS (FICHIERS EXTERNES) ) LES ENTREES DE CATALOGUE ) LES DONNEES TEMPORAIRES DU SERVEUR SAS/INTRNET ) LES FORMATS SAS UTILISATEUR ) COMMENT LES UTILISER AVEC SAS/INTRNET? ) PASSAGE DU CATALOGUE DE FORMATS DE LA V6 A LA V ) LES MACROS VARIABLES ) LE CATALOGUE DE MACROS COMPILEES ) PASSAGE DU CATALOGUE DE MACROS DE LA V6 A LA V ) POINT PARTICULIER A LA VERSION 8 : LES TEMPLATES ) COMMENT DEBOGUER? ) ARBORESCENCE DES FICHIERS ET REPERTOIRES DE SAS/INTRNET ) INSTRUCTIONS DE DEBOGAGE DE LA PROC APPSRV ) L INSTRUCTION LOG ) L INSTRUCTION STATISTICS ) OPTION UNBUFLOG ) OPTION DEBUG ) REFERENCES...21

3 1) Introduction Ce document décrit la mise en place d un serveur SAS/IntrNet v8.2 sur votre machine par l intermédiaire d exemples. Pour être le plus explicite possible, nous comparerons les versions 6.12 et 8.2 afin de montrer leurs différences. Dans ce document, nous décrirons la mise en place des références aux données et aux programmes, l utilisation des macros variables, des formats SAS utilisateur, et des autres fonctionnalités possibles. La mise en place des nouveautés de SAS/IntrNet, tel que les «templates» seront aussi traitées. Ce document intéresse toute personne qui devra installer un serveur d application SAS/IntrNet 8.2, que ce soit pour la première fois ou pour migrer une application v6.12 existante. La dernière partie présente le débogage de votre application SAS/IntrNet du côté serveur en 8.2. Après une présentation rapide, nous entrerons dans le vif du sujet avec la mise en place d un serveur. Environnement des tests réalisés pour ce document : - Windows 2000 avec 256 Mo de RAM - SAS 6.12 TS055 - SAS 8.2 TS0M2

4 2) Vue rapide de l Application Dispatcher 8.2 Dans ce document, nous étudions la partie nommée «Application Dispatcher» de l offre SAS/IntrNet. L Application Dispatcher a connu de nombreux changements par rapport à la version 1.2 (SAS 6.12). Ces améliorations concernent plus particulièrement la sécurité, l administration et les performances. La première grande différence est l évolution concernant le lancement du serveur SAS/IntrNet. En v6.12, nous lançons un programme SCL qui utilise plusieurs fichiers externes de paramétrage. SAS/IntrNet 8.2 propose une nouvelle procédure SAS qui permet la configuration et le démarrage du serveur de traitement (Application Server). Ceci permet une plus grande robustesse et simplifie l administration du serveur. Tous les besoins de votre serveur d application seront gérés dans cette procédure appelée «PROC APPSRV». Nous verrons son installation dans ce document. Voici une liste de quelques autres nouveautés du serveur SAS/IntrNet 8.2 : o Chaque requête est isolée l une de l autre. o Notion de session utilisateur (_SESSIONID). o Possibilité de démarrer SAS/IntrNet à distance (Utilisation d un spawner). o Gestion de charge (Load Manager). o Possibilité d arrêt du serveur après un temps d inactivité. o Authentification système et utilisation des droits machine. o Limitation d utilisation de socket (firewall). o etc De nombreuses autres nouveautés apparaissent avec cette version. Vous pouvez les consulter sur le site Web de SAS à cette adresse : Pour avoir des informations sur l offre complète de SAS/IntrNet 8.2 :

5 3) Mise en place du serveur SAS/IntrNet Dans le cas où vous souhaitez visualiser un programme de démarrage d un serveur SAS/IntrNet 8.2 pour la lecture de ce chapitre, vous pouvez en créer un par l icône «Create a new IntrNet service» (SAS System IntrNet). Par défaut, les services seront créés dans le répertoire pointé par le raccourci The SAS System IntrNet Service Directories. Pour avoir plus d informations sur les éléments créés, référez-vous à la partie ) Le programme CGI : broker L accès au serveur de traitement SAS/IntrNet, que ce soit en version 6.12 ou 8.2, se réalise par l intermédiaire du programme CGI appelé «broker» (broker.exe sous Windows et broker sous unix). Ce programme doit être positionner au niveau du répertoire hébergeant les programmes CGI de votre serveur web et est accompagné du fichier broker.cfg. C est un fichier texte contenant la définition des serveurs SAS/IntrNet pour savoir comment les exploiter. SAS/IntrNet 8.2 propose un nouveau broker.exe et broker.cfg. Cependant, ces deux nouveaux fichiers peuvent être utilisés pour accéder à un serveur SAS/IntrNet 6.12 sans problème (dans le cas où la définition du service est compatible avec SAS/IntrNet 1.2). Lors de la rédaction de ce document, on a utilisé le service décrit ci-dessous pour tous les tests (que ce soit en version 8.2 ou 6.12). SocketService default "Utilise une session SAS existante" ServiceDescription "Service de test pour le club SAS" ServiceAdmin "Pascal NICOLAS" ServiceAdminMail "pascal.nicolas@fra.sas.com" Server localhost Port 5001 Vous pouvez retrouver les différentes définitions des services pour le broker en v8.2 à cette adresse web : 3.2) Les données : La déclaration des données utilisées par l application SAS/IntrNet se réalise dans le fichier permdata.sas en version Ce fichier a disparu en version 8.2 et a été remplacé par la procédure APPSRV (Serveur d Application). Pour illustrer cette différence, voici un exemple de déclaration en version 6.12, puis en version 8.2. En version 6.12 : Le fichier permdata.sas contient : /* Bibliothèques des données SAS */ libname data1 'c:\application\donnees\donnees1' access=readonly ; libname data2 'c:\application\donnees\donnees2' access=readonly ;

6 En version 8.2 : Vous devez déclarer les bibliothèques SAS dans la proc APPSRV comme suit : /* Au lancement, la macro &sysparm sera remplacée par «PORT=<numéro>» et le serveur écoutera alors sur ce port */ proc appsrv &sysparm; /* Déclaration de deux bibliothèques de données */ allocate library donnee1 'c:\application\donnees\donnees1' access=readonly ; allocate library donnee2 'c:\application\donnees\donnees2' access=readonly ; /* Application des deux bibliothèques au serveur courant */ datalibs donnee1 donnee2 ; run; Les deux bibliothèques sont intégrées à la proc APPSRV. Dans un premier temps, nous avons créé les deux bibliothèques de données qui doivent être initialisées pour le serveur SAS/IntrNet via l instruction DATALIBS. Dans ce cas, le serveur écoutera sur le port passé en argument et donnera accès aux deux bibliothèques. Remarque : Si toutes les tables SAS hébergées dans ces répertoires sont au format v6 du Système SAS, le serveur SAS/IntrNet les utilisera comme telles, avec les limitations de la version 6.12 (longueur des noms de variables, longueur des champs caractères, etc). Il est recommandé de convertir vos données au format 8.2, afin d avoir une utilisation optimale avec le nouveau serveur SAS/IntrNet. Pour les convertir, il vous suffit d utiliser la PROC COPY. Voici un exemple de syntaxe : libname lib_v6 v6 'c:\temp\v6' ; libname lib_v8 v8 'c:\temp\v8' ; proc copy in=lib_v6 out=lib_v8 index=yes; run ; 3.3) Les programmes La version 6.12 utilise le fichier SRVAUTO.SAS pour la déclaration des bibliothèques de programmes SAS. Ce fichier a disparu avec la version 8 et la déclaration se réalise, comme pour les données, directement dans la proc APPSRV ) les programmes SAS (fichiers externes) Voici un exemple simple qui montre la différence entre les versions 6.12 et 8.2. Cet exemple présente la déclaration des références aux programmes SAS stockés dans des fichiers externes (.sas).

7 En v6 : Le fichier srvauto.sas contient : /* Libname des programmes SAS de l application */ libname program 'C:\application\programmes' access=readonly; Maintenant, réalisons la même chose en 8.2. En v8 : /* Au lancement, la macro &sysparm sera remplacée par «PORT=<numéro>» et le serveur écoutera alors sur ce port */ proc appsrv &sysparm; /* Déclaration de la bibliothèque pour les programmes SAS */ allocate file program 'C:\application\programmes' access=readonly; /* Déclaration de deux bibliothèques de données */ allocate library donnee1 'c:\application\donnees\donnees1' access=readonly ; allocate library donnee2 'c:\application\donnees\donnees2' access=readonly ; /* Application des deux bibliothèques au serveur courant */ datalibs donnee1 donnee2 ; /* Allocation de la bibliothèque des programmes au serveur SAS/IntrNet courant */ proglibs program ; run; Dans un premier temps, nous déclarons une référence de type FILE pour pointer sur un répertoire contenant des fichiers de type sas (extension.sas). Ensuite, nous appliquons cette référence au serveur SAS/IntrNet par l instruction PROGLIBS. Nous l appellerons dans le navigateur de cette façon : ) les entrées de catalogue Dans le cas où vous souhaitez utiliser des entrées de type SCL d un catalogue SAS, vous devez déclarer la bibliothèque à l aide de l instruction «ALLOCATE LIBRARY». Par exemple, pour utiliser l entrée SCL du catalogue mesprogram nommée bonjour.scl, il faut ajouter les instructions suivantes dans la proc APPSRV : /* Au lancement, la macro &sysparm sera remplacée par «PORT=<numéro>» et le serveur écoutera alors sur ce port */ proc appsrv &sysparm; /* Déclaration de la bibliothèque pour les programmes SAS */ allocate file program 'C:\application\programmes' access=readonly; /* Déclaration de la bibliothèque qui héberge les catalogues d entrées SCL */ allocate library progscl C:\application\programmes_SCL' access=readonly;

8 /* Déclaration de deux bibliothèques de données */ allocate library donnee1 'c:\application\donnees\donnees1' access=readonly ; allocate library donnee2 'c:\application\donnees\donnees2' access=readonly ; /* Application des deux bibliothèques au serveur courant */ datalibs donnee1 donnee2 ; /* Allocation de la bibliothèque des programmes au serveur SAS/IntrNet courant */ /* Ajout du catalogue mesprogram */ proglibs program progscl.mesprogram ; run; Dans ce cas, il est impératif de déclarer le catalogue au niveau de l instruction PROGLIBS, afin de pouvoir trouver les entrées SCL lors de l appel. Dans notre cas, cela sera : ) Les données temporaires du serveur SAS/IntrNet En version 6.12, en plus de déclarer les bibliothèques de programmes, nous renseignons le répertoire temporaire à utiliser par le serveur SAS/IntrNet via la macro variable _TMPDIR dans le fichier srvauto.sas. Exemple : %et _TMPDIR=C:\TEMP\ ; En v8, le répertoire temporaire du serveur de traitement est déclaré dans la proc APPSRV. Voici l exemple ci-dessus avec la déclaration du répertoire temporaire en plus : /* Au lancement, la macro &sysparm sera remplacée par «PORT=<numéro>» et le serveur écoutera alors sur ce port d écoute */ proc appsrv &sysparm; /* Déclaration de la bibliothèque pour les programmes SAS */ allocate file program 'C:\application\programmes' access=readonly; /* Déclaration de la bibliothèque qui héberge les catalogues d entrées SCL */ allocate library progscl C:\application\programmes_SCL' access=readonly; /* Déclaration de deux bibliothèques de données */ allocate library donnee1 'c:\application\donnees\donnees1' access=readonly ; allocate library donnee2 'c:\application\donnees\donnees2' access=readonly ; /* Déclaration du repertoire temporaire utilisé par le proc APPSRV pour les requêtes */ /* Cela n est pas la même chose que la bibliothèque work */ allocate library tmplib 'd:\temp'; /* Application des deux bibliothèques au serveur courant */ /* Ajout de la bibliothèque temporaire */ datalibs donnee1 donnee2 tmplib ;

9 /* Allocation de la bibliothèque des programmes au serveur SAS/IntrNet courant */ /* Ajout du catalogue mesprogram */ proglibs program progscl.mesprogram ; run; Une fois les programmes et les données déclarés en version 8.2, la majeure partie du travail est réalisée. Vous pouvez cependant avoir besoin de formats SAS particuliers ou autres fonctionnalités du système SAS. Voici les sujets que nous allons voir : o Les formats SAS. o Les macros variables. o L utilisation de templates (nouveauté v8). 3.4) Les formats SAS utilisateur Les formats SAS sont très souvent utilisés à la génération des rapports pour le formatage des données. Ils peuvent être utilisés lors de la mise en place d application SAS/IntrNet. Ce paragraphe explique leur utilisation dans ce cadre pour la version 6.12 et ) Comment les utiliser avec SAS/IntrNet? - En version 6.12 En v6, il faut utiliser les deux fichiers permdata.sas et reset.sas. L un permet de créer le libname vers le répertoire contenant le catalogue de format, l autre exécute l option FMTSEARCH pour trouver le catalogue nommé FORMATS. Etape 1 : Déclaration d un libname qui référence le répertoire contenant le catalogue de formats SAS dans le fichier permdata.sas : /* Déclaration de la bibliothèque des données SAS */ libname data1 'c:\application\donnees\donnees1' access=readonly ; libname data2 'c:\application\donnees\donnees2' access=readonly ; /* Libname pour les formats SAS utilisateur */ libname formats c:\application\formats access=readonly ; Etape 2 : Ajout de l option FMTSEARCH pour trouver les formats SAS (reset.sas) : /* Déclaration de l option fmtsearch pour trouver les formats */ options fmtsearch=(formats) ; Cette option est ajoutée dans le fichier reset.sas exécuté à chaque requête.

10 - En version 8 En version 8, il faudra aussi utiliser un fichier externe pour appliquer l options FMTSEARCH. La mise en place des formats SAS passe par l utilisation de l instruction REQUEST INIT. Le programme cité par l instruction sera exécuté à chaque requête. Etape 1 : Création d un programme SAS pour appliquer l option FMTSEARCH (le fichier reset.sas en v6). /* Déclaration pour trouver les formats SAS */ options fmtsearch=(format) ; Il suffit de nommer le fichier init.sas et de le stocker dans le répertoire pointé par le libname PROGRAM. Ce fichier sera exécuté à chaque appel de requête HTTP. Cela peut être aussi une entrée de catalogue de type SCL (comme vu précédemment). Etape 2 : Déclaration d un libname dans la proc APPSRV pour référencer les formats. Etape 3 : Déclaration d une instruction REQUEST INIT pour exécuter un programme SAS à chaque requête. Voici la procédure APPSRV avec les modifications : /* Au lancement, la macro &sysparm sera remplacée par «PORT=<numéro>» et le serveur écoutera alors sur ce port d écoute */ proc appsrv &sysparm; /* Déclaration pour exécuter le programme SAS init.sas */ request init=program.init.sas ; /* Déclaration de la bibliothèque pour les programmes SAS */ allocate file program 'C:\application\programmes' access=readonly; /* Déclaration de la bibliothèque pour les formats SAS */ allocate library format 'c:\application\formats' access=readonly ; /* Déclaration de deux bibliothèques de données */ allocate library donnee1 'c:\application\donnees\donnees1' access=readonly ; allocate library donnee2 'c:\application\donnees\donnees2' access=readonly ; /* Déclaration du repertoire temporaire utilise par le proc appsrv pour les requêtes */ /* Cela n est pas la même chose que la bibliothèque work */ allocate library tmplib 'd:\temp'; /* Application des deux bibliothèques au serveur courant */ /* Ajout de la bibliothèque temporaire et des formats */ datalibs donnee1 donnee2 tmplib format ; /* Allocation de la bibliothèque des programmes au serveur SAS/IntrNet courant */ proglibs program ; run;

11 Remarque : Le programme nommé init.sas peut être l équivalent du fichier reset.sas que vous utilisez avec SAS/IntrNet v6.12. Dans notre cas, il est hébergé dans la bibliothèque PROGRAM ) Passage du catalogue de formats de la v6 à la v8 Pour migrer le catalogue de vos formats SAS, la procédure COPY vous permet de transférer d une bibliothèque v6 vers une bibliothèque v8. Vous pouvez aussi le générer à partir du programme SAS source. Voici un programme exemple de migration : /* Déclaration d une bibliothèque v6 contenant le catalogue de formats v6 */ libname fmtv6 v6 'c:\temp\v6' ; /* Déclaration d une bibliothèque v8 cible de la copie */ libname fmtv8 v8 'c:\temp\v8' ; /* Proc copy pour réaliser le transfert */ proc copy out=fmtv8 in=fmtv6 ; select formats /mtype=cat ; run ; 3.5) Les macros variables En version 6.12, nous déclarons des macros variables globales à la session SAS au niveau des fichiers reset.sas, srvauto.sas ou permdata.sas pour leur utilisation avec le serveur SAS/IntrNet 1.2. Ces macros variables positionnent par exemple les chemins vers les données, l environnement à utiliser (production, test ou validation) ou d autres options. En version 8.2, les fichiers srvauto.sas et permdata.sas n existent plus. Pour vos macros variables, vous devez, soit utiliser l intruction «REQUEST INIT» (vu juste au-dessus) afin de les créer à chaque requête, soit les déclarer dans le programme appsrv.sas avant la proc APPSRV ) Exemple de déclaration des macros variables pour les versions v6 et v8 Cet exemple utilise des macros variables pour changer l application d environnement (par exemple, passage de la validation à la production). Comment pouvons nous utiliser des macros variables pour le faire facilement en v6.12? Voici ce que contient les fichiers permdata.sas et srvauto.sas : Permdata.sas : /* Macro variable de notre environnement */ %let env = C:\production ; Libname Formats "&env\formats" access=readonly ; libname data1 &env\donnees1 access=readonly ; libname data2 &env\donnees2 access=readonly ; Options Fmtsearch=(Formats) ;

12 Srvauto.sas : /* Macro variable de notre environnement */ %let env = C:\production ; libname program &env\programmes access=readonly; Libname macros &env\macros access=readonly ; Maintenant, comment pouvons nous avoir le même fonctionnement avec la procédure APPSRV? Il suffit de créer les macros variables directement dans le programme appsrv.sas (programme de lancement de la procédure) afin de pouvoir les exploiter. Même chose en v8 : /* Déclaration des variables macros */ %let env = C:\production ; /* Au lancement, la macro &sysparm sera remplacée par «PORT=<numéro>» et le serveur écoutera alors sur ce port d écoute */ proc appsrv &sysparm; /* Déclaration pour exécuter le programme SAS init.sas */ /* executera l option fmtsearch et sasmstore qui permettra de trouver les formats SAS ainsi que le catalogue de macro compilées */ request init=program.init.sas ; /* Déclaration de la bibliothèque pour les programmes SAS */ allocate file program &env\programmes access=readonly ; /* Déclaration de deux bibliothèques de données */ allocate library donnee1 &env\donnees1 access=readonly ; allocate library donnee2 &env\donnees2 access=readonly ; /* Déclaration du répertoire temporaire utilisé par le proc appsrv pour les requêtes */ /* Cela n est pas la même chose que la bibliothèque work */ allocate library tmplib 'd:\temp'; /* Application des deux bibliothèques au serveur courant */ /* Ajout de la bibliothèque temporaire */ datalibs donnee1 donnee2 tmplib ; /* Allocation de la bibliothèque des programmes au serveur SAS/IntrNet courant */ proglibs program ; run;

13 Remarque : Il est indispensable d utiliser des guillemets pour pouvoir exploiter des macro-variables lors de la déclaration des différentes bibliothèques. Dans le cas de l usage de simples quotes, la macro-variable ne sera pas résolue. Bonne notation : o allocate library donnee2 &env\donnees2 access=readonly ; Mauvaise notation : o allocate library donnee2 &env\donnees2 access=readonly ; 3.5.2) Le catalogue de macros compilées De nombreuses applications utilisent des programmes SAS enregistrés sous forme de programmes macros compilés et stockés dans un catalogue SAS nommé SASMACR (nom obligatoire). L utilisation de macros compilées permet un gain de temps (pas besoin de les pré-compilées) et permet une sécurité du code SAS. Ce paragraphe explique comment nous pouvons utiliser ce catalogue de macros compilées à partir de notre serveur SAS/IntrNet. En version 6.12 : Il suffit de déclarer le libname ainsi que les options SASMSTORE et MSTORED dans le fichier srvauto.sas. /* Macro variable de notre environnement */ %let env = C:\production ; libname program &env\programmes access=readonly; Libname macros &env\macros access=readonly ; /* Déclaration de l option sasmstore et mstored pour trouver et utiliser le catalogue de macros compilées */ Options sasmstore = macros mstored ; En version 8 : Les options SASMSTORE et MSTORED seront exécutées, via le programme lancé par l instruction REQUEST de la proc APPSRV. /* Déclaration des macros variables */ %let env = C:\production ; /* Au lancement, la macro &sysparm sera remplacée par «PORT=<numéro>» et le serveur écoutera alors sur ce port d écoute */ proc appsrv &sysparm; /* Déclaration pour exécuter le programme SAS init.sas */ /* executera l option fmtsearch, sasmstore et mstored qui permettra de trouver les formats SAS ainsi que le catalogue de macro compilées */ request init=program.init.sas ; /* Déclaration de la bibliothèque pour les programmes SAS */ allocate file program &env\programmes access=readonly ;

14 /* Déclaration de la bibliothèque qui sur le catalogue de macro */ allocate library macros &env\macros access=readonly ; /* Déclaration de deux bibliothèques de données */ allocate library donnee1 &env\donnees1 access=readonly ; allocate library donnee2 &env\donnees2 access=readonly ; /* Déclaration du repertoire temporaire utilise par le proc appsrv pour les requêtes */ /* Cela n est pas la même chose que la bibliothèque WORK */ allocate library tmplib 'd:\temp'; /* Application des deux bibliothèques au serveur courant */ /* Ajout de la bibliothèque temporaire */ /* Ajout de la bibliothèque de macros SAS */ datalibs donnee1 donnee2 tmplib macros ; /* Allocation de la bibliothèque des programmes au serveur SAS/IntrNet courant */ proglibs program ; run; Nous déclarons un libname macros que nous appliquons via l instruction DATALIBS. Ensuite, l option SASMSTORE l utilise pour trouver les macros programmes. MSTORED permet de spécifier d utiliser les macros compilées du catalogue. Déclaration dans le fichier init.sas : /* Déclaration de l option sasmstore pour trouver le catalogue de macro compilées */ Options sasmstore = macros mstored ; Dans ce cas, les macros seront correctement trouvées ) Passage du catalogue de macros de la v6 à la v8 Comme expliqué dans le chapitre 43 de la documentation «SAS Technical Report P-222», un catalogue de macro compilées ne peut pas être déplacé d un système d exploitation à un autre, ni d une version du Système SAS à une autre. Il est donc impossible de migrer un catalogue de macros compilées de la version 6.12 à la version 8.2. Vous ne pouvez pas non plus récupérer le code source à partir du catalogue (sécurité). Vous devez obligatoirement reconstruire le catalogue de macro compilées à partir des programmes SAS sources. Référence : SAS Technical Report P-222 Changes and Enhancements to BASE SAS Software

15 3.6) Point particulier à la version 8 : les templates Un «template» ou style SAS est un modèle de personnalisation pour les sorties générées avec le Système SAS. Ces styles sont créés à l aide de la proc TEMPLATE. Au sein de vos applications SAS/IntrNet, ils peuvent être utilisés pour gérer la mise en page, les couleurs, l apparence de vos pages HTML (ou autres) générées. Par défaut, les styles personnels créés par le développeur ne seront pas trouvés par le serveur SAS/IntrNet. Ceux-ci doivent être référencés dans la procédure APPSRV pour être utilisable. Il est important de préciser que si le système SAS ne trouve pas le style demandé, il appliquera le style par défaut (SASHELP.TMPLMST Styles default ). Pour le faire, nous devons faire une modification au niveau de la proc APPSRV et ajouter des instructions au niveau du fichier init.sas (Programme exécuté à chaque requête). La proc APPSRV : /* Au lancement, la macro &sysparm sera remplacée par «PORT=<numéro>» et le serveur écoutera alors sur ce port d écoute */ proc appsrv &sysparm; /* Déclaration pour exécuter le programme SAS init.sas */ request init=program.init.sas ; /* Déclaration de la bibliothèque pour les programmes SAS */ allocate file program 'C:\application\programmes' access=readonly ; /* Déclaration de la bibliothèque pour les styles de l'utilisateur (templates) */ allocate library mystyles 'C:\application\templates' access=readonly ; /* Déclaration de deux bibliothèques de données */ allocate library donnee1 'c:\application\donnees\donnees1' access=readonly ; allocate library donnee2 'c:\application\donnees\donnees2' access=readonly ; /* Déclaration du repertoire temporaire utilise par le proc appsrv pour les requêtes */ /* Cela n est pas la même chose que la bibliothèque work */ allocate library tmplib 'd:\temp'; /* Application des deux bibliothèques au serveur courant */ /* Ajout de la bibliothèque temporaire */ /* Ajout de la bibliothèque des templates */ datalibs donnee1 donnee2 tmplib mystyles ; /* Allocation de la bibliothèque des programmes au serveur SAS/IntrNet courant */ proglibs program ; run;

16 Le fichier init.sas : /* Déclaration pour trouver les formats SAS */ options fmtsearch=(format) ; /* Instruction pour pouvoir trouver les styles de l utilisateur et ceux par défaut */ /* Les styles utilisateur seront stockés dans l entrée mystyles.mytemplate ici */ ods path sashelp.tmplmst(read) mystyles.mytemplate(read) ; L instruction ODS PATH permet de trouver correctement les templates ou styles à utiliser par les programmes. Cette instruction fonctionne de la même manière que FMTSEARCH. Voici un exemple de proc TEMPLATE qui pourrait être utilisé dans notre cas : proc template ; /* Le style nommé styles.sas sera stocké dans mystyles.mytemplate */ define style styles.sas /store= mystyles.mytemplate; parent = styles.default ; style Body from Document / pagebreakhtml = html('pagebreakline') ; style html / 'PageBreakLine' = %str("<p style=""page-break-before: always;"">&#160</p><hr size=10>") ; style Body from Document / posthtml = "<BR> <BR> <HR> <table width=100%> <td width=33% align=left> <td width=33% > <td width=33% align=right> <bold> Edité le &sysdate par <BR> <a href=mailto:titi@toto.com>jean DUPOND</a></bold></table>" ; end; run; Pour plus d informations sur les templates : - L aide en ligne v8 - Le web (FAQ) : Remarque : L utilisation de la couche ODS est très enrichissante pour la génération de vos documents HTML (ou PDF, RTF, etc). Cette couche s utilise très simplement et vous construira vos fichiers HTML (dans notre cas) à partir de n importe quelle procédure du système SAS.

17 Voici un exemple d utilisation de la couche ODS : ods listing close; ods html body="c:\temp\ods4.html" style=styles.statdoc ; proc format ; value $bk "CANADA"="WHITE" other="yellow"; run; proc tabulate data = sashelp.prdsale format=commax12.; class country prodtype ; var actual ; classlev country / style={background=$bk.} ; table country=" ", prodtype * actual * ( sum='ca FF' pctsum<country>='%'*f=6.2) ; run; ods html close; ods listing ; Pour avoir plus d informations et des exemples sur l ODS : - Aide en ligne -

18 4) Comment déboguer? Un certain nombre d instructions au niveau de la proc APPSRV permettent de collecter plus d informations afin de déboguer au mieux le fonctionnement de votre application SAS/IntrNet 8.2. Par défaut, 2 fichiers de log (journal) sont créés au lancement de votre serveur SAS/IntrNet dans le répertoire logs (situé dans le répertoire de mise en place de votre serveur) et permettent de visualiser les statuts des requêtes et du fonctionnement de la proc APPSRV. Il est cependant possible (et conseillé) d affiner le traçage pour avoir le plus d informations possible lors du développement et des tests. Avant d aborder les instructions existantes, faisons un point sur les fichiers et répertoires créés lors de la construction d un serveur SAS/IntrNet ) Arborescence des fichiers et répertoires de SAS/IntrNet 8.2 Lors de la création d un service SAS/IntrNet par le biais de l icône «Create a new IntrNet service», un certain nombre de fichiers et répertoire sont générés. Voici la description de ces différents éléments (Dans cet exemple, nous utilisons le port d écoute 5001). éléments /logs /logs/ appsrv_5001.log /logs/<jour>_5001.log /temps appstart.bat appstart.sas install.bat remove.bat SASINET5001.INI svcerr.bat svcstart.bat svcstop.bat Descriptions Répertoire contenant les fichiers de log du serveur SAS/IntrNet. Fichier de journal du fonctionnement de la proc APPSRV uniquement. Fichier de journal des requêtes reçues et envoyées au serveur. Répertoire contenant les éléments temporaires propres à la proc APPSRV. Fichier de démarrage du serveur SAS/IntrNet. Fichier SAS contenant la proc APPSRV. Mise en place du serveur SAS/IntrNet en tant que service intégré au système d exploitation (WIN2000 & WinNT). Destruction du service SAS/IntrNet intégré au système d exploitation (WIN2000 & WinNT). Fichier de configuration utilisé par install.bat et remove.bat Statut du service SAS/IntrNet (lors de son utilisation en tant que service intégré au système d exploitation). Démarrage du service SAS/IntrNet (lors de son utilisation en tant que service intégré au système d exploitation). Arrêt du service SAS/IntrNet (lors de son utilisation en tant que service intégré au système d exploitation).

19 4.2) Instructions de débogage de la proc APPSRV 4.2.1) L instruction LOG Cette instruction permet de créer le fichier nommé <jour>_5001.sas (5001 est le numéro de port dans ce cas) décrit dans la partie 4.1. Vous pouvez y visualiser les diverses informations des requêtes HTTP envoyées et reçues du serveur. Par défaut, les informations affichées ne permettent pas de déboguer facilement votre application, car elles sont trop succinctes. Vous devez modifier les options de cette instruction pour avoir plus d informations. Par défaut, l instruction LOG est celle-ci : log file=logfile; Cette option seule ne permet pas de tracer suffisamment des requêtes. Vous devez ajouter les options DISPLAY= et SYMBOLS= pour avoir toutes les informations de la requête. Voici la ligne complète : Log file display=all symbols=all file=logfile ; Dans ce cas, l option DISPLAY=ALL permet de tracer tout le déroulement des programmes appelés. L option SYMBOLS=ALL permet d afficher toutes les macros variables et leurs contenus passés en argument de la requête. L ajout de ces deux options peut vous aider à trouver une solution à des erreurs. Remarque : Il est préférable de remettre les options DISPLAY et SYMBOLS à la valeur «ERRORS» une fois que vos corrections sont réalisées, afin de ne pas avoir un fichier de log trop volumineux. Pour plus d information : ) L instruction STATISTICS Cette instruction permet de créer une table SAS pour stocker des variables choisies. Elle peut être utilisée dans le cas ou vous souhaitez voir le temps d exécution des requêtes de votre application. Elle permettra aussi d avoir des informations sur le client, un statut des requêtes, le nombre d octets reçus ou envoyés, etc. Cette table peut aussi stocker le type du navigateur ou autre information sur le client. Son exploitation est limitée pour déboguer une application et permettra d identifier les programmes fortement consommateur de ressources système (Temps CPU, etc.). Vous devez ajouter ces instructions à la proc APPSRV : allocate library stat 'd:\statistiques' ; statistics data=stat.stats ; Pour plus d informations :

20 4.3) Option UNBUFLOG L option UNBUFLOG se place dans la commande de lancement de votre serveur SAS/IntrNet afin d écrire immédiatement sur disques le journal d exécution (log) sans utiliser de zone mémoire. Cela permet, dans certains cas, de collecter plus d informations lors d un arrêt intempestif du serveur SAS/IntrNet. Exemple de commande : cd "c:\temp\default\temp" start/min "SAS/IntrNet" "c:\sasv8\sas.exe"..\appstart.sas -log..\logs\appsrv_5001.log -noterminal -rsasuser unbuflog -sysparm "port=5001" -awstitle "SAS/AppSvr 5001" 4.4) Option DEBUG Comme en version 6.12, vous pouvez utiliser le paramètre _DEBUG au niveau de la requête HTTP pour avoir plus d informations dans votre navigateur Internet. Exemple de requête : - Pour avoir la LOG à l écran : - Pour retourner la sortie de SAS en code hexa-décimal sur le navigateur : - Pour avoir plus d informations sur les codes du _DEBUG :

21 5) Références Pour SAS/IntrNet : L offre SAS/IntrNet 8.2 : La procédure APPSRV : Les services SAS/IntrNet 8.2 : Pour le système SAS : Les macros : SAS Technical Report P Changes and Enhancements to BASE SAS Software La procédure TEMPLATE : Exemple ODS :

22