SAS sur OS/390 et z/os Eléments de diagnostic des incidents

Transcription

1 SAS sur OS/390 et z/os Eléments de diagnostic des incidents

2 SOMMAIRE Introduction Traitement SAS Batch Session SAS Interactive SAS/IT et l Object Spawner (Ex : SAS Enterprise Guide ) 2 a. Principe de fonctionnement... 2 b. L interface d administration du Spawner... 2 c. ITConfig.exe... 3 d. En cas de problème SAS/CONNECT et le Spawner (Client/Serveur, SAS Enterprise Miner )... 5 a. Principe de fonctionnement... 5 b. En cas de problème... 7 Conclusion... 7 Annexes... 7 a. Configuration TCP/IP... 7 b. Sécurité OS/390 Sécurité Unix... 8 c. Prise d un DUMP lors d un incident... 8

3 Introduction Ce document a pour but de donner une liste des éléments de diagnostic des incidents qui peuvent intervenir avec SAS sur une plate-forme IBM Mainframe. Ces éléments contiennent des informations qui vous seront utiles dans l analyse du problème rencontré. Ils seront, de plus, probablement demandés lors de l ouverture d un dossier auprès du Support Clients de SAS France. Ils sont présentés suivant les grandes catégories de traitement et d architecture de SAS en environnement IBM mainframe. 1. Traitement SAS Batch Il faut impérativement récupérer la log COMPLETE du traitement. Cela signifie que tous les éléments suivants doivent être présents : Sous SDSF : JESMSGLG JESJCL JESYSMSG SASLOG... Sous IOF : LOG JCL MESSAGES SASLOG... Il faut également vérifier le(s) fichier(s) de configuration SAS utilisé(s). Leur emplacement apparaît dans le JCL ou la PROC, et dans la log JESJCL. 2. Session SAS Interactive Il faut dans un premier temps récupérer la log SAS. Si l incident fait que la session se termine brutalement, que la log ne peut pas être récupérée depuis la fenêtre LOG, utilisez l option ALTLOG pour rediriger celle-ci vers un fichier externe. Ajoutez cette option au lancement de SAS sous TSO comme dans cet exemple : SAS82 o( ALTLOG=USERID.SAS.LOG ) Vous pouvez également ajouter cette option dans le fichier de configuration (contacter votre administrateur système le cas échéant. Si des messages système apparaissent (ABEND), faire des copies d écrans aussi complètes que possible de ces messages. Récupérer la CLIST de lancement et le ficher de configuration. 1

4 3. SAS/IT et l Object Spawner (Ex: SAS Enterprise Guide) a. Principe de fonctionnement Le Spawner Objet SAS 9 : Le Spawner est un démon TCP, en écoute sur un port particulier. Le client se connecte sur ce port et est identifié. Le Spawner lance (spawn) la commande spécifiée dans son fichier de configuration, qui est en fait un shell script Unix. Celui-ci va lancer la session SAS (IOM) avec les paramètres adéquats, dans un espace adresse BPXAS. La connexion établie entre le client et le serveur, le Spawner se remet en écoute d une nouvelle connexion. b. L interface d administration du Spawner Une fois le Spawner démarré, il doit être en écoute sur les ports définis dans le fichier de configuration. On peut vérifier cela avec la commande netstat comme dans cet exemple : tso netstat(po 9902) Depuis un poste client, il est possible d accéder à l interface d administration du Spawner en se connectant via telnet au port opérateur : telnet host-name 9902 Une fois connecté, il faut taper le mot de passe, lui aussi défini dans le fichier de configuration. Le terminal confirme l établissement de la connexion avec le message suivant : Operator conversation established Les différentes commandes disponibles sont : help list btrace etrace quit bye Lister les commandes disponibles Lister les serveurs disponibles avec ce Spawner Démarrer un fichier log. Sur OS/390, la commande est de la forme : btrace //dsn:userid.objspawn.log Stopper (et libérer) le fichier log Quitter l interface d administration Arrêter le Spawner 2

5 c. ITConfig.exe Cet utilitaire permet de tester la connexion depuis un poste client, et d avoir des éléments de diagnostic en cas d échec. Ce programme est livré avec SAS Enterprise Guide 2.0, et il est également disponible sur le site de SAS. Par défaut, il est installé dans le répertoire : C:\Program Files\SAS Institute\Shared Files\Integration Technologies\ Au lancement de l utilitaire, choisissez Test Connection : Le serveur à tester est de type Workspace Server, et le protocole Bridge : 3

6 On donne ensuite le nom TCP/IP de la machine, le numéro de port du serveur, et on s identifie sur le serveur : Si le test est concluant, la fenêtre suivante s affiche : En cas d échec, des éléments de diagnostic se trouvent dans cette fenêtre. 4

7 d. En cas de problème Les éléments à vérifier sont les suivants : - la STC du Spawner - le fichier de configuration du Spawner - la log de la STC Spawner - le shell script (USS) - la log du shell script (USS) - la Clist SAS le fichier de configuration SAS - la log de l espace adresse BPXAS - la log du test ITConfig 4. SAS/CONNECT et le Spawner (Client/Serveur, SAS Enterprise Miner ) a. Principe de fonctionnement Le Spawner Connect : Le Spawner est un démon TCP, en écoute sur un port particulier. Le client se connecte sur ce port (1), et est identifié (2). Le Spawner lance (spawn) la commande spécifiée dans son fichier de configuration, qui fait appel à une Clist, et qui va lancer la session SAS/CONNECT dans un espace adresse BPX (3), avec les paramètres adéquats. Le Spawner passe la socket de la session cliente à la session serveur (4), et se remet en écoute d une nouvelle connexion. MVS Session SAS Cliente (1) Spawner (2) RACF (4) (3) Session SAS Serveur BPX 5

8 6

9 b. En cas de problème Les éléments à vérifier sont les suivants : - la STC du Spawner - le fichier de configuration du Spawner - la log de la STC Spawner - la Clist SAS le fichier de configuration SAS - la log de l espace adresse BPXAS - le script de connexion s il est utilisé - la log du poste client (client/serveur, SAS Entreprise Miner) Conclusion Ces informations, fournies au service Support Clients, permettront une analyse et un diagnostic plus rapide de votre problématique. Les annexes contiennent également des informations susceptibles d être utilisées dans le diagnostic des problèmes rencontrés, notamment sur la configuration TCP/IP et sur la prise de DUMP dans l environnement MVS. Annexes a. Configuration TCP/IP Pour l utilisation des modules SAS Integration Technologies et SAS/CONNECT avec le protocole TCP/IP, il faut que SAS puisse utiliser la configuration TCP du site. La procédure SAS TCPTEST permet de vérifier cette configuration : OPTIONS COMAMID=TCP; PROC TCPTEST;RUN; La sortie obtenue donne des informations sur la configuration TCP du site, et sera utile à la résolution d un problème. Il existe aussi le programme SASTCPCF, qui donne des informations similaires, et qui peut être lancé en dehors de SAS. Il se trouve dans la bibliothèque prefix.usage.library. On peut soit l appeler directement depuis ISPF en tapant CALL devant le nom du programme, soit via un batch, comme dans l exemple ci-dessous: //SASTCPCF EXEC PGM=SASTCPCF,PARM= =cnftrace //STEPLIB DD DSN=prefix.SAS82.LIBRARY,DISP=SHR // DD DSN=prefix.SAS82.SASC.TRANSLIB,DISP=SHR //SYSPRINT DD SYSOUT=* //SYSTERM DD SYSOUT=* 7

10 b. Sécurité OS/390 Sécurité Unix La tâche Sawner (IT ou CONNECT) doit avoir des autorisations particulières, pour pouvoir lancer un processus avec l identifiant donné par le client demandant la connexion. Du point de vue MVS, la bibliothèque du load module doit être contrôlée (autorisée APF), et un user doit être défini dans la classe BPX.DAEMON. Du point de vue Unix, ce user doit avoir un UID=0. Enfin, chaque utilisateur doit avoir un segment OMVS défini dans RACF. c. Prise d un DUMP lors d un incident Dans le cadre de la résolution de certains dossiers, le service Support Clients peut être amené à vous demander un DUMP de votre incident. Voici, pour information, les cartes et les commandes pour prendre un tel DUMP. DUMP formaté (transmettre en mode texte) : //SYSUDUMP DD SYSOUT=A DUMP non formaté (transmettre en mode binaire) : //SYSMDUMP DD DSN=USERID.SAVE.DATA,DISP=(NEW,CATLG), // UNIT=SYSDA,SPACE=(CYL,(20,5)) DUMP de la SVC : SLIP SET,EN,ERRTYPE=PROG,A=SVCD,J=jobname,END DUMP de la Console : DUMP COMM='problem description' R id,jobname=(jobname), SDATA=(CSA,GRSQ,LPA,LSQA,PSA,RGN,SQA,SUM,TRT), END Avant de transmettre un DUMP, il doit être compressé. L utilitaire TERSE est un programme de compression gratuit disponible auprès d IBM. Un fichier compressé doit avoir les DCB suivants : LRECL=1024 BLKSIZE=6144 RECFM=FB DSORG=PS Il doit être transféré en mode binaire. 8

11