126384878 as400 initiation bases

C O M M U N I C A T I O N O R G A N I S A T I O N M E T H O D E 111, Avenue Victor Hugo 93307 Aubervilliers Cedex -Tlphone (1) 48 11 23 10

INITIATION A LAS/400

INITIATION A LAS/400 2

C o m m u n i c a t i o n O r g a n i s a t i o n M t h o d e Pascal HYRONDE - Janvier 1996 Rvision Octobre 1999

SOMMAIRE pages 1 Notions de base 1-1 Gnrales 3 Bibliothques Objets Membres Commandes et Menus 5 1-2 Gestion des travaux, exploitation Sous-systme 6 Travaux Files dattente 7 Profils utilisateurs 10 Liste de bibliothques 11 2 Les utilitaires de dveloppement 2-1 P.D.M. 12 2-2 SDA 16 2-3 SEU 17 2-4 DFU 21 2-5 RLU 22 2-6 QRY 23 2-7 DEBUG

2-7-1 STRDBG, ADDBKP 24 2-7-2 STRISDB 25 2-7-3 TRACE 26

3 Programmation

3-1 Base de Donnes AS/400 Annexe

3-1-1 Rpertoire 3-1-2 Fichiers physiques 3-1-3 Fichiers logiques

3-2 Langage de contrle 27 3-1 Introduction 3-2 Syntaxe des commandes systmes

3-3 Programmation de commandes utilisateur 28

3-3 Commandes particulires 29 3-3-1 CPYF 3-3-2 OPNQRYF



1 Notions de base 1-1 Gnrales Bibliothques Sur lAS/400, Les bibliothques contiennent tous les programmes et toutes les informations (donnes). Il faut distinguer deux types de bibliothques: les bibliothques systmes et utilisateurs. Les bibliothques systmes contiennent les programmes et donnes IBM, correspondant aux logiciels sous licence utiliss. Leur nom commence toujours par la lettre Q. Par exemple, QSYS (objets de base, systme dexploitation) ou QUSRSYS (Objets lis au profils utilisateurs et la scurit). Les bibliothques utilisateurs peuvent contenir la fois des donnes et des programmes, mais une mthode pratique consiste mettre les donnes (fichiers) dans une bibliothque diffrente de celle des programmes. Ainsi dans lorganisation des sauvegardes, le choix peut tre fait, par exemple, de ne sauvegarder que les donnes quotidiennement, les produits-programmes tant moins sujets modification peuvent tre sauvegards seulement une fois par mois. En plus du nom, il est possible dindiquer un texte descriptif pour chaque bibliothque, ce qui est vivement conseill pour faciliter la gestion et lexploitation. Une bibliothque ne contient que des objets. Objets Un objet est identifi par son nom, son type et la bibliothque o il se trouve. Autrement dit, dans une bibliothque, on ne peut pas avoir deux fois le mme nom dobjet pour un mme type. En plus du nom, il est possible dindiquer un texte descriptif pour chaque objet, ce qui est vivement conseill pour faciliter la gestion et lexploitation. Prenons un exemple: une bibliothque est un objet de type *LIB (Library). LAS/400 impose la rgle suivante: tous les objets de type *LIB (donc les bibliothques) se trouvent dans la bibliothque QSYS. Comme tout est objet, il y a de nombreux types dobjets. Pour nen citer que quelques uns: - *PGM Objet programme (que ce soit du RPG, du COBOL, du BASIC, du CL ou autres) - *FILE Objet fichier (sources,donnes, chemins daccs, crans, imprimantes, sauvegardes...) - *CMD Objet commande - *USRPRF Objet profil utilisateur - Etc... Pour certains objets, un attribut permet davoir des indications sur la nature ou lorigine des donnes de lobjet; pour un objet *FILE, lattribut PF (Physical file) indique un fichier physique, pour un objet *PGM, lattribut RPG signifie que le source compil est an langage RPG. Membres Cette notion sapplique pour certains objets (type *FILE). Sur AS/400, le source des programmes crits en langage volu est stock dans un fichier physique. Ce programme source prend alors le nom de membre. Cest la compilation de ce membre qui permet la cration dun programme excutable (objet de type *PGM). Ce type de fichier peut donc comporter plusieurs membres. Il en est de mme pour les fichier de donnes (clients ,commande etc...), mais dans la plupart des cas un tel fichier ne contient quun seul membre du mme nom.


C o m m

Schma classique sur un AS/400 de dveloppement

AS/400

Programmes de production Fichiers de production

Bibliothque de dveloppement

QDDSSRC MAJCLIFM CLIENTPF CDESPF

QCBLSRC - MAJCLI

CRTPFF CRTPFCRTLF CRTCBLPGM

CDES CLIENTPF MAJCLI

LIFM

BIBDEV1

BIBFIC1 BIBPGM1 u n i c a t i o n O r gPascal HYRONDE - Janvier a n i s a t i 1996 Rvision OctobMAJCo n M t h o d e re 1999



Commandes et Menus Tous les traitements sont effectus par des programmes. Des paramtres peuvent tre passs aux programmes. Dans ce cas, on utilise gnralement des commandes. Tout le systme dexploitation est gr par commandes. Ceci permet dautomatiser la plupart des traitements de gestion du systme et des utilisateurs (configuration, scurit, sauvegardes etc.). Les commandes peuvent tre lance, soit directement, soit par lintermdiaire de menus (ceci est vrai en particulier pour les commandes systmes). Chaque menu est identifi par un nom. La commande GO (aller) permet dafficher un menu. GO MAIN et Affiche le menu principal de lAS/400 MAIN AS/400 - Menu principal Systme: S4400440 Choisissez l'une des options suivantes : 1. Tches utilisateur 2. Tches bureautiques 3. Tches gnrales du systme 4. Fichiers, bibliothques et dossiers 5. Programmation 6. Communications 7. Dfinition ou modification du systme 8. Identification des incidents 9. Affichage d'un menu 10. Informations techniques 11. Tches de PCS/400 90. Fin de session Option ou commande ===> F3=Exit F4=Invite F9=Rappel F12=Annuler F13=Informations techniques F23=Dfinir menu initial Les menus sont caractriss par: - leur nom, en haut gauche; - leur titre; - la liste doptions disponibles; - la ligne de commande; - les touches de fonctions possibles. Certaines touches de fonction sont particulirement utiles: F4= Invite : permet dafficher lcran de saisie des paramtres dune commande. F9=Rappel: Permet de rappeler les dernires commandes entres.



1-2 Gestion des travaux, exploitation

Sous-Systmes Tous les travaux de lAS/400 ne sexcutent pas dans le mme environnement, le type de travail dterminant les ressources matrielles mettre en jeu, pour ces besoins trs diffrents des sous-systmes ont t crs. Lorsque lon saisit des donnes, les ressources ncessaires ne sont pas les mmes que lorsque lon veut lister un programme ou transfrer un objet sur un autre systme. Cest pourquoi il y a de nombreux sous-systmes, voici ceux que lon trouve frquemment : QBATCH Traitement par lot, compilation, traitement de calcul, ditions QCMN Traitement de communication QCTL Systme de contrle, mode restreint QINTER Travaux interactifs (saisie des commandes etc.) QSNADS Distribution dobjets QSPL Spoules QSYSWRK Travaux systmes

Travaux

Les traitements sont aussi appels travaux. Il y a principalement deux sortes de travaux: - les travaux interactifs; cest dire tout traitement de saisie lcran. En principe ces travaux utilisent peu de mmoire centrale. Une simple ouverture de session dmarre un travail interactif. Un travail interactif utilise systmatiquement un cran par dfinition dont la priorit dexcution est fixe 20 par dfaut. - les travaux batch ou par lots; cest dire tous les programmes de calcul ou ddition, qui brassent un quantit importante dinformations. Cest eux qui habituellement ncessitent beaucoup de ressources. Par exemple, le calcul de la paye du personnel ou ldition des bulletins de paye, sont des travaux batch. Un travail batch nutilise pas dcran par dfinition. Plusieurs travaux batch peuvent tre lancs partir dun travail interactif. La priorit dexcution par dfaut est fixe 50. Un travail est identifi par les trois points suivants: - Le nom du travail; - Lutilisateur; - Le numro du travail. Dans une session dcran, le nom du travail est le nom de lcran (DSP01 par exemple) Dans un travail batch, le nom est plutt celui du programme. Lexcution de ces travaux est toujours gre par lintermdiaire des files dattente de travail. Plus la valeur de la priorit dexcution est leve, moins le travail est prioritaire (le travail sur la console en en priorit 10). La commande DSPJOB permet dafficher (DSP) les informations du travail (JOB) en cours. Remarque : Il est fortement conseill de ne pas modifier les priorits des travaux car cela peut grandement perturber les temps de rponse de la machine.



Files dattente - Les files dattente de travaux (JOBQ: Interactifs ou Batch)

QINTERJOBQ travauxInteractifs

Autant de travauxque d'arrives

QINTER QBATCH

Un seul travail la fois



- Les file dattente de sorties (OUTQ: Impressions)

QBATCH

Un seul travail la fois

OUTQ:File d'attentede sortiespour les impressions

Quelques commandes permettant la gestion des travaux et des files dattente: WRKACTJOB Gestion de lactivit du systme WRKJOBQ Grer les files dattente de travail WRKSBMJOB Grer les travaux soumis (dans une file dattente) SBMJOB Soumettre un travail DSPJOB Visualiser un travail DSPJOBLOG Visualiser lhistorique dun travail WRKSPLF Grer les fichiers spoules WRKOUTQ Grer les files dattente de sortie( ou dimpression) - Les file dattente de messages (Oprateur systme, utilisateur ou programme) Il existe plusieurs sortes de file dattente de message: La file dattente des messages de loprateur systme, elle sappelle QSYSOPR. Cest elle que sont envoys les messages systmes sur le bon ou le mauvais droulement des traitements, ou bien par exemple les messages dtat des imprimantes (bourrage, fin de papier etc.), ou encore les messages envoys par les programmes Batch, ou les messages utilisateurs. Les files dattente de message Poste de travail, elles portent le noms des units crans (DSP01, DSP02 etc...) et sont cres automatiquement avec les crans. Elles reoivent les messages programmes ou utilisateurs. Les files dattente de messages utilisateurs, elles portent le noms des profils utilisateurs et sont cres automatiquement avec le profil. Chaque personne peut ainsi recevoir des messages spcifiquement. Si lutilisateur a ferm sa session, la file dattente de message (MSGQ) conservera le message qui pourra tre consult la prochaine ouverture. Quelques commandes permettant la gestion des files dattente de messages: DSPMSG Affichage des messages SNDMSG Envoi dun message WRKMSGQ Grer les files dattente de messages



Exemple denvoi de messages par la commande SNDMSG: Sur une ligne de commande, tapez SNDMSG et appuyez sur la touche F4, pour obtenir lcran suivant: Envoyer un message (SNDMSG)

Indiquez vos choix, puis appuyez sur ENTREE.

Texte du message . . . . . . . . ________________________________________ ___________________________________________________________________________

___________________________________________________________________________

___________________________________________________________________________

___________________________________________________________________________

Au profil utilisateur . . . . . ___________ Nom, *SYSOPR, *ALLACT...

Fin F3=Exit F4=Invite F5=Rafficher F10=Autres paramtres F12=Annuler F13=Mode d'emploi invite F24=Autres touches Soit un seul profil utilisateur est spcifi, soit tous les profils connects (*ALLACT) et dans ce cas, chacun recevra le mme message en une seule opration. Le mode de rception de message permet de spcifier si le message est affich ds son arrive (*break), si le tmoin de message en attente doit sactiver (*notify), ou si il ny a aucune incidence (*hold). Ce mode peut tre modifi, selon les besoin, avec la commande suivante : CHGMSGQ MSGQ(monprofil) DLVRY(*BREAK)



Profils utilisateurs Pour travailler sur lAS/400 il faut indiquer au systme sur quel profil utilisateur on souhaite travailler. Habituellement, le niveau de scurit en place impose en plus la saisie dun mot de passe. En effet, les actions autorises ne seront pas les mmes pour la personne qui doit calculer la paye, et celle qui soccupe des sauvegardes, si lon imagine que ce sont des personnes diffrentes. Le profil utilisateur permet de grer laccs et lutilisation de lAS/400.

Le PR O FIL U T ILISA T EU R perm et la dfinition:de l'environnem ent de travail, l'im prim ante utilise,les files d 'attentes, le m enu initial...

U tilisateur: ________

M ot de passe: ______

Exemples de commandes permettant la gestion des donnes utilisateurs: CHGPRF Changer son profil utilisateur Voir aussi le menu USER (GO USER) Visualisation des paramtres de la commande CHGPRF (Option 9 du menu USER) Modifier son profil (CHGPRF) Indiquez vos choix, puis appuyez sur ENTREE.

File d'attente de messages . . . HYRONDE Nom, *SAME, *USRPRF Bibliothque . . . . . . . . . QUSRSYS Nom, *LIBL, *CURLIB Mode de rception des messages *BREAK *SAME, *NOTIFY, *BREAK... Filtre code gravit . . . . . . 0 0-99, *SAME Unit imprimante . . . . . . . . PRT05 Nom,*SAME,*WRKSTN,*SYSVAL File d'attente en sortie . . . . PRT05 Nom, *SAME, *WRKSTN, *DEV Bibliothque . . . . . . . . . QUSRSYS Nom, *LIBL, *CURLIB Programme pour ATTN . . . . . . ATTNCL Nom,*SAME,*NONE,... Bibliothque . . . . . . . . . LIBPH Nom, *LIBL, *CURLIB Squence de tri . . . . . . . . *SYSVAL Nom,*SAME,*SYSVAL,*HEX... Bibliothque . . . . . . . . . Nom, *LIBL, *CURLIB Identificateur de langue . . . . FRA *SAME, *SYSVAL... Identificateur de pays . . . . . FR *SAME, *SYSVAL... ID cod de jeu de caractres . . 65535 *SAME, *SYSVAL, *HEX... Options utilisateur . . . . . . *NONE *SAME, *NONE, *CLKWD... + si autres valeurs Fin F3=Exit F4=Invite F5=Rafficher F12=Annuler F13=Mode d'emploi invite F24=Autres touches



1-3 Environnement Liste de bibliothques Lorsque le systme a besoin dune commande, ou dun objet en gnral, il ne le recherche pas parmi toutes les bibliothques du systme. Il nutilise que les bibliothques regroupes dans la liste de bibliothque. Cette liste est relie au travail. Ds quil trouve lobjet, il arrte la recherche et poursuit son traitement. Il faut donc grer correctement cette liste, qui est souvent la cause danomalie droutante pour le dbutant.

L IS T E D E B I B L IO T H E Q U E S

S Y S T E M E

C U R L IB

U T IL IS A T E U R S

S e n s d e la r e c h e rc h e

C A L L P G M X X X

P G M X X X * P G M

La commande DSPLIBL permet de visualiser la liste du travail en cours, ADDLIBLE permet lajout de bibliothque dans la liste. La commande EDTLIBL permet la modification de la liste lcran, par exemple: Rvision de la liste des bibliothques Indiquez vos modifications, puis appuyez sur ENTREE. Pour ajouter une bibliothque, entrez un nom et le numro de squence dsir. Pour enlever une bibliothque, mettez son nom blanc. Pour modifier la position d'une bibliothque, entrez un autre no de squence.

Numro Numro Numro squence Biblio squence Biblio squence Biblio 010 120 230 020 LIB_2SP 130 240 030 LIB_2 140 250 040 COMTEST 150 050 COMJESS 160 060 COMAPPL 170 070 QGPL 180 080 QTEMP 190 090 TAATOOL 200 100 210 110 220

F3=Exit F5=Rafficher F12=Annuler



2 Les utilitaires de dveloppement 2-1 P.D.M. Cest lutilitaire de base qui est utilis pour dvelopper les applications. Il permet la mise jour des membres sources, le lancement des compilations de programmes ou leur dition. Cest un outil personnalisable. On y accde soit par la commande STRPDM (dmarrer PDM) soit par le menu PROGRAM (Option 2) Gestionnaire de dveloppement - PDM AS/400

Choisissez l'une des options suivantes :

1. Gestion des bibliothques 2. Gestion des objets 3. Gestion des membres

9. Gestion des options dfinies par l'utilisateur

Option ou commande ===>

F3=Exit F4=Invite F9=Rappel F10=Entre de commandes F12=Annuler F18=Modifier valeurs par dfaut Les options permettent de travailler sur trois niveaux diffrents , du gnral au particulier. Si lon demande loption 3 on obtient peu prs lcran suivant: Slection des membres


Fichier . . . . . . . . . QCBLSRC Nom, F4 pour liste

Bibliothque . . . . . BIBDEV *LIBL, *CURLIB, nom

Membre : Nom . . . . . . . . . . PGM* *ALL, nom, *gnrique* Type . . . . . . . . . *ALL *ALL, type, *gnrique*, *BLANK

F3=Exit F4=Invite F5=Rafficher F12=Annuler



Remarque sur les noms des fichiers sources Bien que cela ne soit pas une obligation, il est recommand dutiliser les noms standards : QCBLSRC pour les source COBOL QRPGSRC pour les sources RPG QCLSRC pour les sources en langage de contrle (on peut prfrer QCLPSRC) QCMDSRC pour les commandes QDDSSRC pour les descriptions de donnes (crans, fichiers ou imprimantes) etc... le mme principe est utilis pour les autres langages. Les donnes saisir permettent de slectionner une liste de membres plus ou moins longue en fonction des critres demands, par exemple: PDM - Gestion des membres

Fichier . . . . . QRPGSRC Bibliothque . COMAPPL Afficher partir de . ________

Indiquez vos options, puis appuyez sur ENTREE. 2=Editer 3=Copier 4=Supprimer 5=Afficher 6=Imprimer 7=Rebaptiser 8=Afficher description 9=Sauvegarder 13=Modifier texte ...

Opt Membre Type Texte _ PGMBEN01 RPG Donnes d'un BENEFICIAIRE _ PGMBEN99 RPG Slection d'un bnficiaire _ PGMECH01 RPG Calcul d'un chancier avec taux=0% _ PGMECH05 RPG Liste de contrle des appels d'chance _ PGMECH10 RPG Appel d'chance _ PGMECH20 RPG Calcul des chanciers _ PGMECH21 RPG Liste des echeanciers _ PGMEDT01 RPG Edition d'une maquette A suivre... Paramtres ou commande ===> F3=Exit F4=Invite F5=Rafficher F6=Crer F9=Rappel F10=Entre de commandes F23=Autres options F24=Autres touches Cette liste est une sous-liste. Les options sont les traitements disponibles sur chaque membres. F23 permet laffichage doptions complmentaires. F24 permet laffichage de touches de fonction supplmentaires. Par exemple loption 2, permet de modifier un membre par SEU. Loption 5 permet laffichage dun membre, loption 6, limpression. Loption 14, la compilation. La commande WRKSPLF permet de visualiser les listes de compilation. La dernire ligne est rserve pour les messages. Ici lindication Cette liste est une sous-liste, nous rappelle que nous avons fait une slection sur lcran prcdent. Il est possible de changer les critres par F17.



La plupart des paramtres de PDM ont une valeur attribue par dfaut. F18 permet laccs lcran de modification de ces valeurs. En fin de session, ses valeurs seront conserves par le systme et retransmises pour lutilisateur sa prochaine session PDM. Modification des valeurs par dfaut


Bibliothque de cration . . *SRCLIB Nom, *CURLIB, *SRCLIB Remplacement objet . . . . . N O=Oui, N=Non Compilation par lots . . . . O O=Oui, N=Non Excution par lots . . . . . O O=Oui, N=Non Sauvegarde valeurs par dfaut O O=Oui, N=Non Option sauvegarde/restauration 1 1=Individuelle, 2=Globale Description de travail . . HYRONDE Nom, *USRPRF, F4 pour liste Bibliothque . . . . . . . LIBPH Nom, *CURLIB, *LIBL Modifier type et texte . . N O=Oui, N=Non Fichier d'options . . . . . QAUOOPT Nom Bibliothque . . . . . . . LIBPH Nom, *CURLIB, *LIBL Membre . . . . . . . . . . . QAUOOPT Nom Mode plein cran . . . . . . N O=Oui, N=Non

A suivre... F3=Exit F4=Invite F5=Rafficher F12=Annuler Indique la bibliothque utilise pour recevoir les objets programmes rsultats de compilation. La compilation peut ainsi sexcuter en JOBQ (File dattente de travail) Modifie laspect de la liste en permettant, ou non, la saisie de certaines donnes. Si lon veut plus ou moins de lignes par page.



PDM donne la possibilit au programmeur de se crer ses propres options. F16 donne accs aux Options Utilisateurs: Gestion des options dfinies par l'utilisateur

Fichier . . . . . : QAUOOPT Membre . . . . . . : QAUOOPT Bibliothque . . : LIBPH

Indiquez vos options, puis appuyez sur ENTREE. 2=Modifier 3=Copier 4=Supprimer 5=Afficher

Opt Option Commande C CALL &O/&N AT ? ATTSRC FIL(&F) LIB(&L) MBR(&N) TYP(CLP) AU ?GRTOBJAUT OBJ(&L/&N) OBJTYPE(&T) REFOBJ(COMAPPL/&N) CF CHGPF FILE(&O/&N) WAITFILE(3) REUSEDLT(*YES) CL ? CLRPFM FILE(&O/&N) CO ? CHGOBJOWN OBJ(&L/&N) OBJTYPE(&T) ??NEWOWN(CPLSCR01) CUROWNAUT(* CP CPROBJ OBJ(&L/&N) OBJTYPE(&t) CU crttaatool &n CY CPYF FROMFILE(&L/&N) TOFILE(comtestf/&N) MBROPT(*REPLACE) A suivre... Commande ===> F3=Exit F4=Invite F5=Rafficher F6=Crer F9=Rappel F10=Entre de commandes F24=Autres touches Remarque : La personnalisation de ces options peut tre propre chaque utilisateur. Pour cela il faut indiquer le fichier doption utilis au niveau des valeurs par dfaut (fichier doptions). Si le mme fichier est indiqu pour plusieurs utilisateurs, toutes les options disponibles seront identiques. Pour crer une option il suffit dappuyer sur F6 (Crer sur lcran Gestion des options dfinies par lutilisateur), dindiquer le code de loption et laction effectuer. Faites rfrence laide en ligne pour connatre la valeur des paramtres utiliser.



2-2 SDA Cet utilitaire permet de concevoir les images crans utilises par les programmes. On peut y accder par la commande STRSDA ou bien par loption 17 de PDM au niveau dun membre source. Aide la conception d'images-cran - SDA AS/400

Choisissez l'une des options suivantes :

1. Conception d'images-cran 2. Conception de menus 3. Test de fichiers cran

Option ou commande ===>

F1=Aide F3=Exit F4=Invite F9=Rappel F12=Annuler

Loption 1 propose limage suivante pour la saisie du membre crer ou modifier:

Conception d'images-cran


Fichier source . . . . . . QDDSSRC Nom, F4 pour liste

Bibliothque . . . . . . COMAPPL Nom, *LIBL, *CURLIB

Membre . . . . . . . . . . LOCPRO53 Nom, F4 pour liste

F3=Exit F4=Invite F12=Annuler

Loption 2 permet de crer des menus AS/400. Une fois crs, les crans peuvent tre affichs sans programmes par loption 3:

Test de fichier cran


Fichier cran . . . . . . . . . . . . MTEST1 Nom, F4 pour liste Bibliothque . . . . . . . . . . . . LIBPH Nom, *LIBL ...

Format tester . . . . . . . . . . . Nom, F4 pour liste

Formats supplmentaires afficher . . Nom, F4 pour liste

F3=Exit F4=Invite F12=Annuler



2-3 SEU Permet la modification ou cration pleine page des membres sources. Toute la description de lutilisation de lditeur est disponible dans laide en ligne, et il faut souvent sy rfrer. La syntaxe dpend du type de membre utilis, les lignes comportant des erreurs apparaissent en inversion, laide permet davoir des indications supplmentaires, voire des exemples pour chaque code opration. Dautre part, il est possible de dboguer les programmes en interactif, la correction des erreurs de compilation est simple et rapide, car il nest pas ncessaire dimprimer systmatiquement de liste ou de rfrences croises. Lcran de saisie se prsente peu prs comme celui-ci: Colonnes . . : 1 71 Edition COMAPPL/QRPGSRC SEU==> ______________________________________________________________________ LOCBEN01 ************** Dbut des donnes ************************************ 0001.00 T* DONNEES D'UN BENEFICIAIRE 0002.00 T* MODULE: LOCATIF DATE: 03 03 95 QUI: PH 0003.00 T* MODI. : 14 03 95 QUI: YM MISE A JOUR FICHIERS 0004.00 T* MODI. : 22 03 95 QUI: YM AJOUT MODE CREATION SI BEXXXX = 0 0005.00 T* MODI. : 13 06 95 QUI: PH MJ TIERS / IRIS 0006.00 T* 0007.00 T* UTILISATION DES INDICATEURS 0008.00 T* 99: *ON SI AU MOINS UNE ERREUR 0009.00 T* 0010.00 FLOCBEN01CF E WORKSTN 0011.00 F KINFDS DS$WS 0012.00 FBENEFP UF E K DISK A 0013.00 FCONVENP IF E K DISK 0017.00 I* Data structures du programme----------------------------------- 0018.00 IDSADR E DSMTRAD2DS 0019.00 IDSSMQ E DSOUTSMQDS 0020.00 IDS$WS E DSOUTFDSP1 Une ligne de commande permet par exemple de grer les recherches ou de se positionner au dbut ou la fin dun source. Autre exemple: SEU==> F BEGSR 28, signifie Trouve BEGSR en position 28 . Toutes les lignes sont accessibles en mise jour. La touche F4 permet laffichage dune ligne formate en fonction des spcifications utiliss (pour le RPG) Quelques ordres permettant une action directe sur les lignes du membre source. I Insertion de ligne(s) C Copier une ligne M Dplacer une ligne A Mettre la slection (Copie ou dplacement) aprs cette ligne (AFTER) B Mettre la slection (Copie ou dplacement) avant cette ligne (BEFOR) CC Dbut ou fin de bloc copier MM Dbut ou fin de bloc dplacer D Supprime une ligne (DELETE) DD Dbut ou fin de bloc supprimer D5 Supprime 5 lignes ...



Lorsque la modification ou cration est termine, un cran de sortie doit tre confirm: Sortie


Modification/cration du membre . . O O=Oui, N=Non Membre . . . . . . . . . . . . . PGMBEN01 Nom, F4 pour liste Fichier . . . . . . . . . . . . . QRPGSRC Nom, F4 pour liste Bibliothque . . . . . . . . . COMAPPL Nom Texte . . . . . . . . . . . . . . Donnes d'un BENEFICIAIRE

Renumrotation . . . . . . . . . N O=Oui, N=Non Dbut . . . . . . . . . . . . . 0001.00 0000.01-9999.99 Incrment . . . . . . . . . . . 01.00 00.01-99.99

Impression du membre . . . . . . . N O=Oui, N=Non

Retour l'cran d'dition . . . . N O=Oui, N=Non

Affichage de la liste des membres . N O=Oui, N=Non

F3=Exit F4=Invite F5=Rafficher F12=Annuler Loption 14 en regard du membre permet de compiler le source, PDM choisit automatiquement la commande de cration en fonction de lattribut du membre: - RPG CRTRPGPGM - CL CRTCLPGM - PF CRTPF - LF CRTLF - DSPF CRTDSPF - PRTF CRTPRTF ... Crer un programme RPG/400 (CRTRPGPGM)


Programme . . . . . . . . . . . > PGMBEN01 Nom, *CTLSPEC Bibliothque . . . . . . . . . > COMAPPL Nom, *CURLIB Fichier source . . . . . . . . . > QRPGSRC Nom, QRPGSRC Bibliothque . . . . . . . . . > COMAPPL Nom, *LIBL, *CURLIB Membre source . . . . . . . . . > PGMBEN01 Nom, *PGM Niveau de gravit gnration . . 9 0-99 Texte 'descriptif' . . . . . . . *SRCMBRTXT

Autres paramtres

Remplacer le programme . . . . . > *NO *YES, *NO

Fin F3=Exit F4=Invite F5=Rafficher F10=Autres paramtres F12=Annuler F13=Mode d'emploi invite F24=Autres touches Avant de crer lobjet, PDM demande si lon veut remplacer le programme de mme nom. Ce contrle nest fait que si la valeur par dfaut remplacement dobjet (voir plus haut) est N. Comparer cet cran avec lcran obtenu par CRTRPGPGM et F4.



Une fois la compilation termine, sil ny a pas derreur, le programme peut tre appel par CALL. Si elle nexiste pas, il serait utile de crer loption utilisateur C qui permettra dexcuter le programme slectionn sur une ligne PDM. En cas derreur de compilation Vous pouvez faire une liste de la compilation pour identifier les erreurs. Cependant, il sera souvent prfrable didentifier le erreurs lcran pour corriger simultanment le source du programme. Il est alors possible de procder ainsi :

1) PDM, Option 3, Gestion des membres (a priori vous y tes dj) 2) Gestion des membres, Option 2 en regard du programme concern 3) F15 Options

Options examen/copie


Option . . . . . . . . . . . . 2 1=Membre 2=Fichier spoule 3=File d'attente en sortie Copie de tous les enreg . . . . N O=Oui, N=Non Examen/copie du membre . . . . PRT04 Nom, F4 pour liste Fichier . . . . . . . . . . . QCLPSRC Nom, F4 pour liste Bibliothque. . . . . . . . PASCAL Nom, *CURLIB, *LIBL

Examen/copie du fichier spoule PRT04 Nom, F4 pour liste Travail . . . . . . . . . . . PRT04 Nom Utilisateur . . . . . . . . PASCAL Nom, F4 pour liste Numro de travail . . . . . *LAST Numro, *LAST Numro de spoule . . . . . . *LAST Numro, *LAST, *ONLY

Affichage file d'attente sortie QPRINT Nom, *ALL Bibliothque . . . . . . . . *LIBL Nom, *CURLIB, *LIBL

F3=Exit F4=Invite F5=Rafficher F12=Annuler F13=Modifier valeurs par dfaut F14=Options recherche/remplacement



4) Aprs avoir prcis la liste visualiser (*LAST pour la dernire compilation) appuyez sur la touche Entre pour faire apparatre lcran suivant :

Colonnes . . : 1 71 Edition PASCAL/QCLPSRC SEU==> PRT04 FMT ** ...+... 1 ...+... 2 ...+... 3 ...+... 4 ...+... 5 ...+... 6 ...+... 7 ************** Dbut des donnes ************************************

0001.00 PGM 0002.00 STRPRTWTR DEV(PRT04) CUTOEND(*YES) 0003.00 ENDPGM *************** Fin des donnes *************************************

___________________________________________________________________________

Colonnes . . : 1 71 Examen Fichier spoule : PRT04 SEU==> 0000.22 200- STRPRTWTR DEV(PRT04) CUTOEND(*YES) 0000.23 * CPD0043 30 Le mot cl CUTOEND est incorrect pour cette commande. 0000.24 300- ENDPGM 0000.25 * CPD0729 10 Aucune commande excutable dans le fichier source. 0000.26 * * * * * F I N D U S O U R C E 0000.27 5769SS1 V4R3M0 980729 Langage de contrle 0000.28 Rfrences croises

F3=Exit F4=Invite F5=Rafficher F9=Rappel F11=Basculer F12=Annuler F16=Rpter recherche F17=Rpter remplacement F24=Autres touches Le mot cl est incorrect pour cette commande. +

Sur la ligne SEU= => de la partie Examen, il suffit de taper *ERR et F16, pour afficher les erreurs commentes. Une fois lerreur corrige dans la premire partie de lcran, il est possible de passer lerreur suivante en appuyant sur F16 (le curseur positionn sur la deuxime partie de lcran) Ainsi, les erreurs sont vite identifies et corriges.



2-4 DFU Cet utilitaire permet la modification des donnes de fichier. Particulirement utile pour la gestion des jeux dessai, il faut nanmoins lutiliser avec prcaution car aucun contrle nest effectu sur le contenu des donnes modifies. STRDFU et F4 affiche lcran suivant: Dmarrer DFU (STRDFU)


Option: Option DFU . . . . . . . . . . *SELECT 1-5, *SELECT Option d'excution . . . . . . *NONE 1-2, *NONE Programme DFU . . . . . . . . . *PRV Nom, *PRV Bibliothque . . . . . . . . . *PRV Nom, *PRV, *LIBL, *CURLIB Fichier base de donnes . . . . *PRV Nom, *PRV, *SAME Bibliothque . . . . . . . . . *PRV Nom, *PRV, *LIBL, *CURLIB Membre . . . . . . . . . . . . . *PRV Nom, *PRV, *FIRST

Fin F3=Exit F4=Invite F5=Rafficher F12=Annuler F13=Mode d'emploi invite F24=Autres touches

Si loption *SELECT est demande, le menu DFU est affich: Utilitaire de maintenance de fichiers - DFU AS/400 Choisissez l'une des options suivantes : 1. Excution d'un programme DFU 2. Cration d'un programme DFU 3. Modification d'un programme DFU 4. Suppression d'un programme DFU 5. Mise jour de donnes l'aide d'un programme temporaire Option ou commande ===> F3=Exit F4=Invite F9=Rappel F12=Annuler Le programmeur peut dcider de conserver, ou non , un programme DFU. Loption 5 permet la cration dun programme temporaire, cest dire quune fois les modifications termines, le programme sera supprim automatiquement. Ceci est rendu possible par la prsence de la description des donnes lie lobjet *FILE.



2-5 RLU Cet utilitaire permet de concevoir les fichiers imprimantes (*PRTF) utiliss par les programmes. On peut y accder par la commande STRRLU ou bien par loption 19 de PDM au niveau dun membre source. Il fonctionne un peu comme SDA. Un des aspects trs utile de cet utilitaire est la possibilit de mettre au point ldition sans avoir encore de programme en langage volu (RPG ou COBOL par exemple). On peut en effet diter des maquettes dtat trs facilement, mme option 19 mais en faisant F4 pour slectionner loption 6 (dition). Comme pour les DSPF, il est possible dinitialiser un source par SEU et F15 pour rcuprer des lments dun autre source, puis de passer par RLU pour faire les modifications.



2-6 QRY Cet utilitaire permet de formuler des requtes, cest dire des interrogations, sur les donnes de lAS/400. Le rsultat pouvant tre soit: - afficher lcran; - imprimer sur une liste; - placer dans un fichier base de donnes. Ces requtes peuvent tre conserves dans une bibliothque, et par la suite rutilises ou modifies. Le rsultat peut tre obtenu trs rapidement et la prsentation tant trs soigne, les requtes vitent souvent la programmation des demandes simples . Le menu QUERY est appel par la commande STRQRY: QUERY Utilitaires de requtes Systme: S4400440 Choisissez l'une des options suivantes :

QUERY/400 1. Gestion d'analyses 2. Lancement d'une analyse existante 3. Suppression d'une analyse

A suivre... Option ou commande ===>

F3=Exit F4=Invite F9=Rappel F12=Annuler F13=Informations techniques F16=Menu principal La dfinition dune analyse concerne les points suivants: Dfinition de l'analyse

Analyse . . . . . : Option . . . . . : CREER Bibliothque . : LIBPH CCSID . . . . . . : 65535

Indiquez vos options, puis faites Entre. F21 pour choisir toutes les options. 1=Choisir

Opt Options de dfinition de l'analyse 1 Choisir les fichiers _ Dfinir les zones rsultat _ Choisir les zones et leur squence _ Choisir les enregistrements _ Choisir les zones de tri _ Choisir la squence de classement _ Choisir le formatage des colonnes _ Choisir les fonctions rcapitulatives du rapport _ Dfinir des ruptures de contrle _ Choisir le type et la nature de la sortie _ Indiquer les options de traitement

F3=Exit F5=Rapport F12=Annuler F13=Dessin F18=Fichiers F21=Toutes les options



2-7 DEBUG

Le DEBUG est lopration de mise au point des programmes. Il permet de vrifier lexcution de certaines parties de programme, de visualiser le contenu des zones et des indicateurs (pour le RPG). 2-7-1 STRDBG

Dmarrage du dbogage :

Dmarrer le dbogage (STRDBG)


Programme . . . . . . . . . . . MONPGM Nom, *NONE Bibliothque . . . . . . . . . Nom, *LIBL, *CURLIB + si autres valeurs

Programme par dfaut . . . . . . *PGM Nom, *PGM, *NONE Nb maxi d'instructions trace . . 200 Nombre Trace pleine . . . . . . . . . . *STOPTRC *STOPTRC, *WRAP MJ fichiers de production . . . *YES *NO, *YES Dbogage de niveau source OPM . *NO *NO, *YES Programme de service . . . . . . *NONE Nom, *NONE Bibliothque . . . . . . . . . Nom, *LIBL, *CURLIB + si autres valeurs

A suivre... F3=Exit F4=Invite F5=Rafficher F10=Autres paramtres F12=Annuler F13=Mode d'emploi invite F24=Autres touches Ajouter un point d'arrt (ADDBKP) Indiquez vos choix, puis appuyez sur ENTREE.

Numro d'instruction . . . . . . > 200 Valeur alpha + si autres valeurs Variables du programme: Variable programme . . . . . . *NONE

Variable de pointeur base . .

+ si autres valeurs

+ si autres valeurs Format de sortie . . . . . . . . *CHAR *CHAR, *HEX Programme . . . . . . . . . . . *DFTPGM Nom, *DFTPGM Fin F3=Exit F4=Invite F5=Rafficher F10=Autres paramtres F12=Annuler F13=Mode d'emploi invite F24=Autres touches Point d'arrt lexcution : Spcification/Instruction . . . . . . . : 200 /0009 Programme . . . . . . . . . . . . . . . : PRT04 Niveau de rcursivit . . . . . . . . . : 1

Appuyez sur ENTREE pour continuer.

F3=Sortir du programme F10=Entre de commandes

ENDDBG pour arrter le mode DEBUG



2-7-2 STRISDB Les mmes fonctions que celles dcrites ci-dessus, mais en interactif, cest dire que lon put suivre lexcution du programme, pas pas, en visualisant le source du programme simultanment, et en plaant les points darrt au fur et mesure des besoins.

Dmarrer ISDB (STRISDB)


Programme . . . . . . . . . . . > PRT04 Nom Bibliothque . . . . . . . . . *LIBL Nom, *CURLIB, *LIBL MJ fichiers de production . . . > *YES *YES, *NO Appeler le programme . . . . . . *YES *YES, *NO, *CMD Paramtres d'appel . . . . . . .

+ si autres valeurs

Fin F3=Exit F4=Invite F5=Rafficher F10=Autres paramtres F12=Annuler F13=Mode d'emploi invite F24=Autres touches

Placez le curseur sur la ligne o vous voulez le point darrt, elle apparat alors en inversion dimage. F17 lance lexcution (jusquau prochain point darrt F5 lance lexcution pas pas F11 affiche le contenu de la variable o est plac le curseur F23 modifie le contenu de la variable o est plac le curseur F6 ajoute ou retire le point darrt F3 pour sortir du mode DEBUG

Dbogage Aller Programme Options Aide PASCAL/PRT04:/0001 ISDB/400 A suivre: > 000100 PGM 000200 STRPRTWTR DEV(PRT04) CUTOEND(*YES) 000300 ENDPGM

ISDB ===> F3=Sortie F5=Pas pas F6=Point d'arrt F11=Variable F12=Annuler F17=Excuter F23=Modifier variable F24=Autres touches Point d'arrt ajout l'instruction 200.



2-7-3 TRACE

Une trace permet de suivre, par ordre dexcution, tout ou partie des lignes dun programme. Pour ajouter une trace il faut que le mode DEBUG soit dj dmarr. ADDTRC

Ajouter une trace au dbogage (ADDTRC)


Instructions tracer: Numro d'instruction de dbut *ALL Valeur alpha, *ALL, *ALLINST Numro d'instruction de fin . Valeur alpha + si autres valeurs Variables du programme: Variable programme . . . . . . *NONE

Variable de pointeur base . .

+ si autres valeurs

+ si autres valeurs Format de sortie . . . . . . . . *CHAR *CHAR, *HEX A suivre... F3=Exit F4=Invite F5=Rafficher F10=Autres paramtres F12=Annuler F13=Mode d'emploi invite F24=Autres touches Ensuite, il faut excuter le programme puis, afficher le rsultat de la trace : DSPTRCDTA Afficher rsultats de trace (DSPTRCDTA)


Sortie . . . . . . . . . . . . . * *, *PRINT Mise blanc . . . . . . . . . . *NO *NO, *YES

Fin F3=Exit F4=Invite F5=Rafficher F12=Annuler F13=Mode d'emploi invite F24=Autres touches Il est possible, soit dimprimer, soit dafficher le rsultat lcran.



3 Programmation

3-1 Base de donnes AS400

Document annexe

3-2 Langage de contrle

Introduction La programmation en langage de contrle est trs puissante car toutes les commandes du systme dexploitation sont disponibles. Dautres par, les programmes de ce type sont compils et ne comportent donc par derreur de syntaxe, et leur excution est optimise. La programmation de pilote dexploitation est facilite par un monitorage de la plupart des erreurs de commandes, autrement dit, le programmeur peut prvoir certaines erreurs possibles et dcider de faire tel ou tel traitement en consquence. Aussi, il est conseill de stocker dans des programmes CL les actions effectues sur le systme, car cela fournit un historique des oprations, trs utile surtout six mois aprs..., et dautre part cela permet de recommencer plusieurs fois un traitement, en phase de test et mise au point par exemple. Syntaxe des commandes systmes La syntaxe des commandes est rigoureuse ce qui permet souvent de les retrouver facilement sans les connatre par cur:

V E R B E O B J E T S E T C O M P L E M E N T S

C O M M A N D E

D S PW R KC R T

P F MO B JP G M

D S P P F M

D S P P G M

Comment retrouver une commande systme?: - principalement par le menu MAJOR (GO MAJOR ou F4 sur une ligne de commande vide). Il permet en effet des recherches par sujets, verbes ou nom gnrique (tout ce qui commence par...). - loption 2 de PDM peut aussi tre utilise



Programmation de commandes utilisateur Il est possible de crer des commandes utilisateur ayant les mmes caractristiques que les commandes systmes. Elles procurent de nombreux avantages dans la programmation en langage de contrle. Dcrivons les points communs toute commande en utilisant lexemple de WRKCFGSTS et F4: Grer tat de la configuration (WRKCFGSTS)


Type . . . . . . . . . . . . . . ______ *NWI, *LIN, *CTL, *DEV Description de configuration . . *ALL Nom, gnrique*, *ALL... Sortie . . . . . . . . . . . . . * *, *PRINT

Fin F3=Exit F4=Invite F5=Rafficher F10=Autres paramtres F12=Annuler F13=Mode d'emploi invite F24=Autres touches ! - Le titre et le nom de la commande; " - La description de paramtre; # - La valeur du paramtre (valeur par dfaut); $ - Le type de valeurs permises (F4 permet den avoir la liste); % - Les touches de fonctions standards. Un programme de contrle des paramtres peut venir complter les contrles de saisie, par exemple si on veut quun paramtre reprsente le nom dun fichier, on peut ainsi vrifier que le fichier existe avant dxcuter la commande. Cest un moyen simple de permettre la saisie de paramtres pour une procdure envoyer en JOBQ.



Commandes particulires

CPYF Cration de fichiers, rcupration de donnes, impressions OPNQRYF Slectionner des enregistrements

************** Dbut des donnes ************************************ 0001.00 PGM 0002.00 0003.00 /* EDITION ARTICLES DU FOURNISSEUR 123 */ 0004.00 0005.00 OVRDBF FILE(ARTICLPF) SHARE(*YES) 0006.00 OPNQRYF FILE((ARTICLPF)) QRYSLT('ARCFOU *eq 123') 0007.00 0008.00 CALL PGMXXX 0009.00 0010.00 CLOF OPNID(ARTICLPF) 0011.00 DLTOVR FILE(ARTICLPF) 0012.00 0013.00 ENDPGM *************** Fin des donnes *************************************

Crer un fichier de requte

************** Dbut des donnes ************************************ 0001.00 PGM 0002.00 0003.00 /* EDITION ARTICLES DU FOURNISSEUR 123 */ 0004.00 0005.00 OVRDBF FILE(ARTICLPF) SHARE(*YES) 0006.00 OPNQRYF FILE((ARTICLPF)) QRYSLT('ARCFOU *eq 123') 0007.00 0008.00 CPYFRMQRYF FROMOPNID(ARTICLPF) TOFILE(QTEMP/ARTICLPF) + 0009.00 CRTFILE(*YES) 0010.00 CALL PGMXXX 0011.00 0012.00 CLOF OPNID(ARTICLPF) 0013.00 DLTOVR FILE(ARTICLPF) 0014.00 0015.00 ENDPGM *************** Fin des donnes *************************************

Introduction

126384878 as400 initiation bases

Documents