IV: Accès à l`AS400 en JAVA : 4.1 Organisation CLIENT

IV: Accès à l’AS400 en JAVA :
4.1 Organisation CLIENT-SERVEUR de l'AS400
Ressources du système OS400 :
- FILES : fichiers physiques et logiques , ils contiennent les données ainsi que les vues et les
jointures sur ces données ( tables et autres éléments de DB2/400).
- IFS : Integrated File System , c’est un système de fichiers parallèle au précédent , il permet
de manipuler de fichiers organisés sous forme de bytes dans un environnement de type
SHELL-UNIX.Les fichiers de ce système sont organisés en arborescence.
- *DTAQ : data queues ; elles permettent l’échange de données entre programmes .
- Spooled files : fichiers d’impression .
- *PGM : programmes C,COBOL,CL , RPG ou autres
Serveurs du système OS400 :

- DB Server et DDM : serveurs permettant l’accès aux fichiers physiques( en Lecture-mise à
jour-écriture) et logiques ainsi que leur interrogation via des requêtes SQL .
- Byte stream Server : serveur permettant l’accès aux fichiers IFS(lecture-écriture-mise à jour)
.
- Dist Pgm call Server : ce serveur permet l’activation de programmes tournant sur l’AS400 à
partir d’un client distant ainsi que la récupération des messages générés par ce programme .
- DataQ Server : il permet l’accès aux DATAQ
- Signon Server : il gère les connexions à l’AS400(user et mot de passe)
- Network Print Server : il gère les accès aux fichiers d’impression.
Classes et Objets JAVA sur le CLIENT :
- classe AS400 : elle contient en ensemble de sockets(une par serveur) . Il est possible de
créer plusieurs connexions AS400 simultanées dans la même application cliente , mais il est
préférable pour des raisons d’efficacité de ne créer qu’une seule connexion à la fois .
- classe JDBC : JAVA DATA BASE CONNECTIVITY : elle permet l’accès aux DB via des
requêtes SQL .
- classe DataQueue : représente des data queues .
- classe Program : représente un programme activable à distance .
- objets Serveurs : objets prédéfinis représentant un des serveurs de l’OS400.
Remarques :
-Pour les classes et objets mentionnés ci-dessus soient accessibles à partir du client , il faut
installer sur celui-ci le package com.ibm.as400.access . Ce package est distribué gratuitement
par IBM et il s’installe indifféremment sur des plates-formes UNIX,LINUX,MICROSOFT ou
AS400. Ces classes sont regroupées dans une archive intitulée jt400.jar .
-Pour accéder à ce package depuis un environnement Microsoft , il faut enregistrer cette
archive sur le poste client dans un répertoire quelconque de la racine (par exemple packIBM)
et modifier la variable d'environnement classpath :
classpath = . ;c:\packIBM\jt400.jar ;
ou compiler explicitement avec l’option classpath :
java -classpath . ;c:\packIBM\jt400.jar MaClasse.java

ou encore paramétrer les librairies de son environnement de développement
(Jcreator,Jbuilder,Netbeans,Eclipse,Websphere Studio etc…) pour qu’elles pointent sur
l’archive jt400.jar .
Vous trouverez dans le bric-à-brac le package jt400.jar permettant l'accès à l'AS400 en JAVA
4.2 L'Integrated File System(IFS) et le QSHELL
L’ IFS vous permet d’accéder au système de fichiers de l’AS400 selon une organisation en
dossiers à la manière des environnements WINDOWS ou UNIX . La librairie QSYS apparaît
alors sous la forme d’un dossier QSYS.LIB rattaché à la racine .
Pour gérer cet environnement on utilise soit le QSHELL , sorte de shell unix permettant
d’enter des commandes en mode texte , soit le I5 NAVIGATOR, permettant un accès
graphique à l’arborescence à la manière de l’explorateur WINDOWS .
Pour activer le QSHELL à partir de la ligne de commande CL taper : QSH . Pour sortir du
QSHELL taper <F3> .
cd /
$
ls
FICS QJAVA QSYS.LIB hp
ISEtools QNTC QTCPTMM javaIBM
QDLS QOPT dev publichtml
QFileSvr.400 QOpenSys etc tmp
QIBM QSR home usr
$
Les principaux répertoires de l’IFS sont :
 ROOT  arborescence typée UNIX de l’AS400
o home  répertoires home des utilisateurs (disque Z : )
o QIBM  ensemble de fichiers propres à l’AS400
 fichiers d’entête .h pour le langage C
 archive jt400.jar
 les JDK
 fichiers nécessaires au fonctionnement du serveur websphere
etc..
 QSYS.LIB  arborescence classique de l’OS400
 QOpenSys  arborescence du système AIX
 QOPT  lecteur de DVD
Pour visionner vos fichiers OS400:
cd /QSYS.LIB
cd J…..LIB
ls

COPIE.PGM OPER.FILE RPGDEG.FILE
DDSDEG.FILE OPER.PGM RUPTURE.PGM
DTAQ1.DTAQ PFVUECLI.FILE SNDMES.PGM
DTAQ2.DTAQ PGMCLI2.PGM SQLAS4002.FILE
DTATEST.DTAARA PGMSUB.PGM SUB1.FILE
DTATEST2.DTAARA PGMSUB2.PGM TABLE1.FILE
DTFACP.FILE PGMSUB3.PGM TEST1.PGM
ECR.FILE PRCLI2.FILE TEST2.PGM
ECREX1.FILE PRODUP.FILE TESTCAT.PGM
EX1.PGM PROG.FILE TESTDTA.DTAARA
EXEMPLE1.FILE QCLSRC.FILE TESTMSG.PGM
EXEMPLE1.PGM QDDSSRC.FILE VUEPER.FILE
EXEMPLE1B.FILE QJAVASRC.FILE
$
Les droits dans l’espace « ROOT » sont gérés selon un modèle proche de UNIX : on utilise
notamment les droits :
LECTURE-ECRITURE-EXECUTION ainsi que EXCLUDE .
Ces droits sont gérables par I5 Navigator ou par la commande chmod en ligne de commande
QSH .
4.3 Préparation de votre environnement de travail
Modification de votre profil utilisateur :
Vous disposez dans le répertoire home , d’un répertoire personnel correspondant à votre
username (J…) . Pour que la commande QSH vous dirige directement dans ce répertoire ,
vous devez modifier votre profil utilisateur :
(autres paramètres)
- Répertoire Initial : /home/J….
Ce répertoire correspond à votre disque Z:\
Création de votre espace de travail
Dans votre répertoire personnel QSHELL créez un répertoire « mesClasses » à l’aide de la
commande mkdir .
Préparation de votre .profile
Toujours en mode CL :
EDTF <F4>
 Stream File : /home/J…./.profile
Vous accédez alors à un éditeur type SEU , à l’aide duquel vous introduisez :

export -s
CLASSPATH=.:/home/j…/mesClasses:/home/classesJava:/home/classe
sJava/jt400.jar
echo "Bienvenue dans l'environnement QSHELL de l'I5 "
Le positionnement de la variable CLASSPATH vous permettra d’activer les différentes
classes JAVA nécessaires à votre application à partir de l’environnement QSH . Vous devez
également positionner cette variable à partir de l’environnement CL .
Positionnement de CLASSPATH en mode CL :
En mode CL :
ADDENVVAR ENVVAR(CLASSPATH)
VALUE('=.:/home/j…/mesClasses:/home/classesJava:/home/classesJava/jt400.jar
')
Cette variable d’environnement est liée au JOB interactif dans lequel elle est positionnée , elle
ne subsiste donc pas d’une session à l’autre . Il est donc conseillé d’intégrer la commande ci-
dessus dans un petit programme CL que l’on appellera lors de l’entrée en session grâce à
l’option « programme initial à appeler » du profil utilisateur .
PGM
ADDENVVAR CLASSPATH '.:/home/j0001/mesClasses+
/home/classesJava:/home/classesJava/jt400.jar’
ENDPGM
4.4 Création de sources JAVA
Pour créer des sources java sur l’AS400 on peut :
-encoder le programme depuis une plate-forme LINUX ou WINDOWS puis le transférer par
FTP (il faut se connecter sur son home directory)
-idem mais utiliser le copier-coller pour transférer le fichier à l’aide de I5 NAVIGATOR .
-encoder le programme à l’aide de l’utilitaire EDTF sur l’AS400 .
-paramétrer son environnement de développement afin qu’il dépose ses sources dans le
répertoire Z : \mesClasses
4.5Compilation des sources java et exécution
1°) en mode QSH  javac etc…
on peut alors lancer l’application par la commande java etc…
2°) optimisation