Professional Documents
Culture Documents
Volubis.fr Conseil et formation sur OS/400, I5/OS puis IBM i depuis 1994 !
Christian Mass - cmasse@volubis.fr
Nouveauts concernant le CL
Avec la version 5.3, IBM met un coup de jeune au langage de contrle Nouveaux types de variables (integer) Boucles (dowhile, dountil, dofor) Support de fichiers multiples (jusqu' 5 par programme) Les versions 5,4 et 6.1 continuent ces volutions Sous programmes, par exemple. Enfin, une PTF en version 7 apporte de nouvelles fonctions intgres
il existe aussi le format *UINT (binaire non sign) la longueur est de 2 octets ou 4 octets la transformation de binaire en dcimal ou caractre est possible avec CHGVAR
DOUNTIL COND( mme test que sur un IF) ... ENDDO pour dountil, le test est ralis sur le ENDDO (on fait au moins une fois) et la condition donne est celle pour SORTIR.
DOFOR VAR(&cpt) FROM(1) TO(22) BY(3) ... ENDDO pour ces trois boucles on peut forcer: - une sortie anticipe par LEAVE
sans paramtre, on sort de la boucle en cours (la dernire) on peut mettre un LABEL devant le DOxxx et indiquer le label lors du LEAVE
et enfin, l'quivalent du CASE SQL ou du SELECT RPG : SELECT WHEN COND( ) THEN( ) /* seul le premier test vrai est trait */ WHEN COND( ) THEN() OTHERWISE CMD( ) ENDSELECT
l'OPNID est facultatif, mais un SEUL fichier peut ne pas en avoir, et nous sommes limits 5 fichiers en tout dans un mme programme.
ATTENTION : les variables seront prfixes par l'OPNID suivi de _ JOB -> &ECRAN_JOB , Indicateur 3 -> nomm &ECRAN_IN03
DOUNTIL COND(&ECRAN_IN03) RCVF OPNID(OBJD) MONMSG MSGID(CPF0864) EXEC(LEAVE CMDLBL(BCL1)) CHGVAR &ECRAN_ODOBNM &OBJD_ODOBNM CHGVAR &ECRAN_ODOBTP &OBJD_ODOBTP CHGVAR &ECRAN_ODOBTX &OBJD_ODOBTX SNDRCVF OPNID(ECRAN) ENDDO ENDPGM
- les sous programmes doivent tre placs en FIN de pgm - ils ne doivent pas tre imbriqus - ils peuvent bien sr sappeler les uns les autres dans la limite indique par la nouvelle commande DLCPRCOPT (dft = 99)
le sous programme peut retourner une valeur numrique ENDSUBR RTNVAL(&rt) cette valeur est alors rcupre lors de l'appel par CALLSUBR ..RTNVAL(&R)
(&R doit tre une variable de type *INT de 4 octets).
La PTF SI48166 propose %TRIM %TRIMR %TRIML limination d'un blanc d'extrmit d'une chane limination des blancs de droite limination des blancs de gauche
CHGVAR VAR(&V2) VALUE(%TRIM(&V1)) /* contient 'test de chane*****' */ /* on peut indiquer le(s) caractre(s) enlever */ CHGVAR VAR(&V3) VALUE(%TRIMR(&V2 '* ')) /* contient 'test de chane' */
La PTF SI49061 propose %CHECK %CHECKR %SCAN vrification des caractres d'une variable(gauche->droite) vrification des caractres d'une variable(droite->gauche) recherche d'une chane dans une variable
CHGVAR VAR(&V5) VALUE(%CHECK('123456789' &V4)) /* contient 4, la position de ',' */ CHGVAR VAR(&V5) VALUE(%CHECK('123456789, ' &V4)) /* contient 0, tout est OK */ /* on peut utiliser *LDA la place d'un nom de variable */ CHGDTAARA DTAARA(*LDA (1 10)) VALUE('03216549*7') CHGVAR VAR(&V5) VALUE(%CHECK('123456789' *LDA)) /* contient 1, la position du '0' */
Quelques exemples
UN outils assez ancien, CHGPROPRIO:
PGM PARM(&LIB &OWN) DCL VAR(&LIB) TYPE(*CHAR) LEN(10) DCL VAR(&OWN) TYPE(*CHAR) LEN(10) DCLF FILE(QADSPOBJ) /* VARIABLES UTILISEES PAR LA GESTION DE MESSGAES */ DCL &ERRORSW *LGL DCL &MSGID *CHAR LEN(7) DCL &MSGDTA *CHAR LEN(100) DCL &MSGF *CHAR LEN(10) DCL &MSGFLIB *CHAR LEN(10) MONMSG CPF0000 *N (GOTO ERRMSG)
/* /* /* /* /*
*/ */ */ */ */
CHKOBJ OBJ(&LIB) OBJTYPE(*LIB) AUT(*USE) IF (&OWN *EQ '*CURRENT') GOTO SUIT1 CHKOBJ OBJ(&OWN) OBJTYPE(*USRPRF) GOTO SUIT2 RTVJOBA USER(&OWN) DSPOBJD OBJ(&LIB/*ALL) OBJTYPE(*ALL) + OUTPUT(*OUTFILE) OUTFILE(QTEMP/CHGPROP) OVRDBF FILE(QADSPOBJ) TOFILE(QTEMP/CHGPROP) RCVF MONMSG CPF0864 *N (GOTO FINTRT) CHGOBJOWN OBJ(&ODLBNM/&ODOBNM) OBJTYPE(&ODOBTP) + NEWOWN(&OWN) GOTO LECTURE
/* RENVOI DES MESSAGES DE TYPE *COMP SI FIN NORMALE */ COMPMSG: RCVMSG MSGTYPE(*COMP) MSGDTA(&MSGDTA) MSGID(&MSGID) + MSGF(&MSGF) MSGFLIB(&MSGFLIB)
Quelques exemples
UN outils assez ancien, CHGPROPRIO:
IF SNDPGMMSG GOTO ERRMSG: /*----------------------------------------*/ /* GESTION DES ERREURS */ /*----------------------------------------*/ IF &ERRORSW SNDPGMMSG MSGID(CPF9999) + MSGF(QCPFMSG) MSGTYPE(*ESCAPE) /* 2EME FOIS*/ /* ARRET PGM*/ CHGVAR &ERRORSW '1' /* MISE EN PLACE DU SWTICH */ /* RENVOI DES MESSAGES DE TYPE *DIAG SI FIN ANORMALE */ DIAGMSG: RCVMSG MSGTYPE(*DIAG) MSGDTA(&MSGDTA) MSGID(&MSGID) + MSGF(&MSGF) MSGFLIB(&MSGFLIB) IF (&MSGID *EQ ' ') GOTO EXCPMSG SNDPGMMSG MSGID(&MSGID) MSGF(&MSGFLIB/&MSGF) + MSGDTA(&MSGDTA) MSGTYPE(*DIAG) GOTO DIAGMSG /* BOUCLE SUR MESSAGES *DIAG */ /* RENVOI DU MESSAGE D'ERREUR */ EXCPMSG: RCVMSG MSGTYPE(*EXCP) MSGDTA(&MSGDTA) MSGID(&MSGID) + MSGF(&MSGF) MSGFLIB(&MSGFLIB) SNDPGMMSG MSGID(&MSGID) MSGF(&MSGFLIB/&MSGF) + MSGDTA(&MSGDTA) MSGTYPE(*ESCAPE) ENDPGM COND(&MSGID *EQ ' ') THEN(RETURN) MSGID(&MSGID) MSGF(&MSGFLIB/&MSGF) + MSGDTA(&MSGDTA) MSGTYPE(*COMP) COMPMSG /* BOUCLE SUR MESSAGES *COMP
*/
Quelques exemples
Nouvelle version:
PGM PARM(&LIB &OWN) DCL VAR(&LIB) TYPE(*CHAR) LEN(10) DCL VAR(&OWN) TYPE(*CHAR) LEN(10) DCL VAR(&EOF) TYPE(*LGL) DCLF FILE(QADSPOBJ) /* DCL MSG*/ INCLUDE SRCMBR(MSGINC1) CHKOBJ OBJ(&LIB) OBJTYPE(*LIB) AUT(*USE) SELECT WHEN (&OWN *NE '*CURRENT') THEN( + CHKOBJ OBJ(&OWN) OBJTYPE(*USRPRF) ) OTHERWISE CMD(RTVJOBA USER(&OWN)) ENDSELECT DSPOBJD OVRDBF OBJ(&LIB/*ALL) OBJTYPE(*ALL) + OUTPUT(*OUTFILE) OUTFILE(QTEMP/CHGPROP) FILE(QADSPOBJ) TOFILE(QTEMP/CHGPROP)
CALLSUBR LECTURE DOWHILE COND(*NOT &EOF) CHGOBJOWN OBJ(&ODLBNM/&ODOBNM) OBJTYPE(&ODOBTP) + NEWOWN(&OWN) CALLSUBR LECTURE ENDDO SNDPGMMSG MSG(&OWN *BCAT 'est propritaire de tous les + objets de la bibliothque ' *CAT &LIB) MSGTYPE(*COMP)
/*MESSAGES*/ INCLUDE SRCMBR(MSGINC2) SUBR SUBR(LECTURE) RCVF MONMSG MSGID(CPF0864) EXEC(CHGVAR VAR(&EOF) VALUE('1')) ENDSUBR ENDPGM
Quelques exemples
Source inclure MSGINC2::
/* RENVOI DES MESSAGES DE TYPE *COMP SI FIN NORMALE */ CALLSUBR MSGCOMP DOWHILE COND(&MSGID *NE ' ') SNDPGMMSG MSGID(&MSGID) MSGF(&MSGFLIB/&MSGF) + MSGDTA(&MSGDTA) MSGTYPE(*COMP) CALLSUBR MSGCOMP ENDDO RETURN ERRMSG: /*----------------------------------------*/ /* GESTION DES ERREURS */ /*----------------------------------------*/ IF &ERRORSW SNDPGMMSG MSGID(CPF9999) + MSGF(QCPFMSG) MSGTYPE(*ESCAPE) /* 2EME FOIS*/ /* ARRET PGM*/ CHGVAR &ERRORSW '1' /* MISE EN PLACE DU SWTICH */ /* RENVOI DES MESSAGES DE TYPE *DIAG SI FIN ANORMALE */ CALLSUBR MSGDIAG DOWHILE COND(&MSGID *NE ' ') SNDPGMMSG MSGID(&MSGID) MSGF(&MSGFLIB/&MSGF) + MSGDTA(&MSGDTA) MSGTYPE(*DIAG) CALLSUBR MSGDIAG ENDDO
Quelques exemples
Source inclure MSGINC2::
/* RENVOI DU MESSAGE D'ERREUR FINAL EXCPMSG: RCVMSG SNDPGMMSG */
/* sous programmes */ SUBR ENDSUBR SUBR ENDSUBR SUBR(MSGDIAG) RCVMSG MSGTYPE(*DIAG) MSGDTA(&MSGDTA) MSGID(&MSGID) MSGF(&MSGF) MSGFLIB(&MSGFLIB) SUBR(MSGCOMP) RCVMSG MSGTYPE(*COMP) MSGDTA(&MSGDTA) MSGID(&MSGID) + MSGF(&MSGF) MSGFLIB(&MSGFLIB)
Quelques exemples
Autres exemples
L'api 'stat' indique si un fichier stream (IFS) existe: Cette api tant dans le programme de service QLECWI, il faut utiliser le type CLLE
PGM DCLPRCOPT DCL DCL DCL DCL DCL CHGVAR CALLPRC IF PARM(&PARM) BNDSRVPGM((QLECWI)) VAR(&PARM) VAR(&RTNVAL) VAR(&PATH) VAR(&NULL) VAR(&BUF) TYPE(*CHAR) LEN(256) TYPE(*int) LEN(4) TYPE(*CHAR) LEN(100) TYPE(*CHAR) LEN(1) VALUE(X'00') TYPE(*CHAR) LEN(4096)
VAR(&PATH) VALUE(&PARM *TCAT &NULL) PRC('stat') PARM(&PATH &BUF) + RTNVAL(&RTNVAL) COND(&RTNVAL *NE 0) THEN(SNDPGMMSG + MSGID(CPF9898) MSGF(QCPFMSG) + MSGDTA('Objet ' !! &PARM !< ' non + trouv.') MSGTYPE(*ESCAPE))
ENDPGM
Quelques exemples
L'api QDCRDEVD contient l'adresse IP du terminal en 878 (sur 15 c.)
PGM DCL DCL DCL DCL DCL DCL DCL PARM(&IPADR) VAR(&RETOUR) TYPE(*CHAR) LEN(900) VAR(&RETOUR_IP) TYPE(*CHAR) STG(*DEFINED) LEN(15) + DEFVAR(&RETOUR 878) VAR(&BIN) TYPE(*INT) LEN(4) VALUE(900) VAR(&FORMAT) TYPE(*CHAR) LEN(8) VALUE('DEVD0600') VAR(&DEV) TYPE(*CHAR) LEN(10) VAR(&ERR) TYPE(*CHAR) LEN(8) + VALUE(X'0000000000000000') VAR(&IPADR) TYPE(*CHAR) LEN(15) RTVJOBA CALL CHGVAR ENDPGM JOB(&DEV) QDCRDEVD PARM(&RETOUR &BIN &FORMAT &DEV &ERR )
&IPADR &retour_IP
Quelques exemples
Arrt de tous les jobs ayant le mme nom. On utilise la commande ENDJOB DUPJOBOPT(*MSG) et s'il y a des noms dupliqus , lecture (par RCVMSG) de tous les messages d'erreur pour en rcuprer les coordonnes
PGM DCL DCL DCL DCL DCL PARM(&JOB) &JOB *CHAR 10 &USR *CHAR 10 &NBR *CHAR 6 &MSGDTA *CHAR 26 &MSGID *CHAR 7
Quelques exemples
Arrt de tous les jobs ayant un nom donn. On utilise la commande ENDJOB DUPJOBOPT(*MSG) et s'il y a des noms dupliqus , lecture (par RCVMSG) de tous les messages d'erreur pour en rcuprer les coordonnes /* si le nom est dupliqu */
RCVMSG PGMQ(*SAME (*)) MSGDTA(&MSGDTA) MSGID(&MSGID) DOWHILE COND(&MSGID *NE ' ') IF (&MSGID = 'CPF0906') THEN(DO) CHGVAR &USR %SST(&MSGDTA 11 10) CHGVAR &NBR %SST(&MSGDTA 21 6) ENDJOB JOB(&NBR/&USR/&JOB) OPTION(*IMMED) MONMSG CPF0000 ENDDO RCVMSG PGMQ(*SAME (*)) MSGDTA(&MSGDTA) MSGID(&MSGID) ENDDO ENDPGM
Quelques exemples
Destruction de tous les rcepteurs d'une bibliothque.
L'api QUSLOBJ donne une liste d'objets dans un *USRSPC L'api QUSPTRUS retrouve le pointeur de dbut d'un User Space Dans l'entte du uSer Space, en position 124 on trouve, en binaire: - La position de dbut de la liste d'objets - Le nombre de postes (c.a.d d'objets dans notre exemple) - la taille d'un poste /* /* /* /* PGM PARM(&BIB) ===================================================================== BUT : lister les RCEPTEURS DE JOURNAUX AFIN DE LES DTRUIRE sauf ceux attachs ===================================================================== DCL VAR(&COMPTEUR) TYPE(*INT) DCL VAR(&QUAL) TYPE(*CHAR) LEN(20) VALUE(*ALL) DCL VAR(&BIB) TYPE(*CHAR) LEN(10) DCL VAR(&pointeur) TYPE(*PTR) */ */ */ */
Quelques exemples
Destruction de tous les rcepteurs d'une bibliothque.
DCL DCL DCL DCL DCL DCL DCL DCL DCL DCL VAR(&ptrinfos) TYPE(*PTR) VAR(&DATA) TYPE(*CHAR) STG(*BASED) LEN(16) + BASPTR(&PTRINFOS) VAR(&DEBUT) TYPE(*INT) STG(*DEFINED) DEFVAR(&DATA) VAR(&NOMBRE) TYPE(*INT) STG(*DEFINED) DEFVAR(&DATA 9) VAR(&TAILLE) TYPE(*INT) STG(*DEFINED) DEFVAR(&DATA 13) VAR(&ptrretour) TYPE(*PTR) VAR(&RETOUR) TYPE(*CHAR) STG(*BASED) LEN(30) + BASPTR(&PTRRETOUR) VAR(&OBJ) TYPE(*CHAR) STG(*DEFINED) LEN(10) + DEFVAR(&RETOUR) VAR(&OBJLIB) TYPE(*CHAR) STG(*DEFINED) LEN(10) + DEFVAR(&RETOUR 11) VAR(&OBJTYPE) TYPE(*CHAR) STG(*DEFINED) LEN(10) + DEFVAR(&RETOUR 21)
Quelques exemples
Destruction de tous les rcepteurs d'une bibliothque.
/* VARIABLES UTILISEES PAR LA GESTION DE MESSAGES */ DCL &MSGID *CHAR LEN(7) /* ID MSG DCL &MSGDTA *CHAR LEN(100) /* DATA DCL &MSGF *CHAR LEN(10) /* FICHIER DCL &MSGFLIB *CHAR LEN(10) /* BIBLI MONMSG MSGID(CPF0000) EXEC(GOTO ERREUR) DLTUSRSPC QTEMP/DLTLIBRCV MONMSG MSGID(CPF2105) EXEC(RCVMSG PGMQ(*SAME) + MSGTYPE(*EXCP)) /* CRATION DU USER SPACE */ CALL PGM(QUSCRTUS) PARM('DLTLIBRCV QTEMP' ' ' X'0000FFFF' X'00' '*USE' 'POUR DLTLIBRCV') /* /* /* /* /* /* USRSPC */ ATTRIBUT */ TAILLE */ VAL INITIALE*/ DROITS */ TEXTE */ + + + + + */ */ */ */
Quelques exemples
/* REMPLISSAGE, LISTE DES OBJETS */ CHGVAR VAR(%SST(&QUAL 11 10)) VALUE(&BIB) CALL QUSLOBJ PARM('DLTLIBRCV QTEMP' /* USRSPC */ 'OBJL0100' /* FORMAT */ &QUAL /* bib/obj */ '*JRNRCV' /* type */ ) /* positionnement sur dbut du USer Space */ CALL PGM(QUSPTRUS) PARM('DLTLIBRCV QTEMP' &Pointeur) /* rcupration de &DATA, donc de &DEBUT &TAILLE et &NOMBRE */ chgvar &ptrinfos &pointeur CHGVAR %OFFSET(&ptrinfos) VALUE(%OFFSET(&ptrinfos) + 124) /* positionnement dbut de liste (on place &retour DANS le User Space) */ chgvar &ptrretour &pointeur CHGVAR %OFFSET(&ptrretour) VALUE(%OFFSET(&ptrretour) &DEBUT ) + + + +
Quelques exemples
/* Lecture suivant le nombre d'objets indiqu */ DOFOR VAR(&COMPTEUR) FROM(1) TO(&NOMBRE) BY(1) DLTJRNRCV MONMSG JRNRCV(&OBJLIB/&OBJ) MSGID(CPF7022)
/* positionnement sur le suivant */ if (&compteur < &nombre) then(do) CHGVAR %OFFSET(&ptrretour) VALUE(%OFFSET(&ptrretour) + + &TAILLE) ENDDO ENDDO
Quelques exemples
/* RENVOI MESSAGE DE TYPE *COMP SI FIN NORMALE */ COMPMSG: DLTUSRSPC QTEMP/DLTLIBRCV SNDPGMMSG MSG('Mnage sur les rcepteurs de journaux + effectu') TOPGMQ(*PRV (*PGMBDY)) + MSGTYPE(*COMP) return /* RENVOI DU MESSAGE D'ERREUR RECU ERREUR: RCVMSG SNDPGMMSG ENDPGM */
MSGTYPE(*EXCP) MSGDTA(&MSGDTA) MSGID(&MSGID) + MSGF(&MSGF) MSGFLIB(&MSGFLIB) MSGID(&MSGID) MSGF(&MSGFLIB/&MSGF) + MSGDTA(&MSGDTA) TOPGMQ(*PRV (*PGMBDY)) + MSGTYPE(*ESCAPE)