La parte 1 di queste FAQ, le prima 10 Domande-Risposte sono disponibili a questo link: RPG – FAQ & Howtos (IT Part.1)
Index
Per chi inizia a lavorare con RPG Free e Full-Free ci sono queste due ottime guide:
Nelle assegnazioni di valore alle variabili in RPG Free possiamo utilizzare le “short expressions”, rubate dal linguaggio C… sono comode perché si risparmia qualcosa in scrittura del codice ma bisogna prestare attenzione a non confondere la posizione del segno uguale (=) …. ad esempio ” i+=1″ incrementa di uno il valore di i … mentre “i=+1” setta i al valore 1 positivo!
i=i+1; --->equivale a ---> i+=1; i=i-1; --->equivale a ---> i-=1; r=r*2; --->equivale a ---> r*=2; r=r/2; --->equivale a ---> r/=2; Possiamo anche usare queste funzioni gestendo l'arrotondameno eval(h) r/=2;
Se ne è discusso in Ottobre 2019 sul gruppo di discussione RPG-L di Midrange.com: che differenza c’è tra i due modi di definire una DS come qualified template:
Method 1 dcl-f CUSTFILE keyed template qualified; dcl-ds cust_t likeRec(CUSTFILE.CUSTFILER) template; dcl-s custName like(cust_t.name); Method 2 dcl-ds cust_t extName('CUSTFILE') qualified template end-ds; dcl-s custName like(cust_t.name);
I due metodi diversi arrivano allo stesso risultato … in entrambi i casi possiamo definire la variabile “custName” come “cust_t.name” campo esterno preso dalla tabella “CUSTFILE” … potremmo dire che il metodo con extName non obbliga a definire nelle specifiche ‘F’ (o meglio DCL-F) il nostro file.
Un’altra differenza tra i due metodi sta nella sintassi delle specifiche di definizione “DCL-DS”: con EXTNAME dobbiamo indicare END-DS mentre con LIKEREC no: forse non tutti sanno che con DLC-DS ExtName possiamo aggiungere dei campi esterni alla DS, vediamo un esempio:
dcl-ds myds extname(mytable); extraFld1 char(10); extraFld2 char(15); end-ds;
Da una domanda sulla mailing list di Midrange.com:
Ho un programma che ha due differenti step … nel primo crea una tabella in QTEMP (cosa possibile solo con commit=*none) e nel secondo passo esegue un JSON_TABLE leggendo il documento JSON con la funzione get_CLOB_from_file() (cosa non possibile se commit=*none): e’ possibile cambiare il livello di commit nello stesso programma?
Ecco le risposte dal forum:
La BIF %Timestamp RPG non arriva oltre alle 3 cifre dopo i secondi … (millisecondo) … In alcuni casi potrebbe essere utile recuperare une precisione superiore, o tramite la API QWCCVTDT (fino al microsecondo) oppure con SQL Embedded: ecco un piccolo programma RPG proposto da Vernon Hamberg su Midrange.com:
dcl-s tstmp06 timestamp; dcl-s tstmp12 timestamp(12); dcl-s tstmp06from12 timestamp; dcl-s tstmp12from06 timestamp(12); dcl-s tstmp06sys timestamp; dcl-s tstmp12sys timestamp(12); dcl-s tstmp06s timestamp; dcl-s tstmp12s timestamp(12); dcl-s tstmp06sfrom12 timestamp; dcl-s tstmp12sfrom06 timestamp(12); // Use BIF timestamp alone tstmp06 = %timestamp; tstmp12 = %timestamp(*sys : 12); tstmp06from12 = %timestamp(*sys : 12); tstmp12from06 = %timestamp; // Use *SYS in BIF tstmp06sys = %timestamp(*sys : 6); tstmp12sys = %timestamp(*sys : 12); // Use SQL current timestamp exec sql set :tstmp06s = current timestamp; exec sql set :tstmp12s = current timestamp(12); exec sql set :tstmp06sfrom12 = current timestamp(12); exec sql set :tstmp12sfrom06 = current timestamp; *inlr = *on;
Con il seguente risultato:
> EVAL tstmp06 TSTMP06 = '2019-12-08-04.04.22.647000' > EVAL tstmp12 TSTMP12 = '2019-12-08-04.04.22.647000000000' > EVAL tstmp06from12 TSTMP06FROM12 = '2019-12-08-04.04.22.647000' > EVAL tstmp12from06 TSTMP12FROM06 = '2019-12-08-04.04.22.647000000000' > EVAL tstmp06sys TSTMP06SYS = '2019-12-08-04.04.22.647000' > EVAL tstmp12sys TSTMP12SYS = '2019-12-08-04.04.22.647000000000' > EVAL tstmp06s TSTMP06S = '2019-12-08-04.04.22.647548' > EVAL tstmp12s TSTMP12S = '2019-12-08-04.04.22.647802819335' > EVAL tstmp06sfrom12 TSTMP06SFROM12 = '2019-12-08-04.04.22.647935' > EVAL tstmp12sfrom06 TSTMP12SFROM06 = '2019-12-08-04.04.22.648147000000'
Naturalmente stiamo parlando di variabili di tipo ind … non di indicatori numerici che spero non utilizziate più nei nuovi sorgenti RPG. E’ una cosa semplice, forse non vale la pena neanche di dedicarci una FAQ su questo Blog … ma mi rendo conto che mi sono trovato spesso nella condizione di “invertire” segno di un indicatore (il classico tasto funzione che attiva/disattiva una impostazione) e di aver spesso utilizzato ben 5 righe di codice invece di una sola
dcl-s viewDetails ind inz(*off); // Long version, up to five lines of code ... // Flip viewDetails indicator if viewDetails=*on; viewDetails=*off; else; viewDetails=*on; endif; // Here the short version ... one row only! ... // Flip viewDetails indicator viewDetails= not viewDetails;
In questo Github GIST di Niels Liisberg vediamo una interessante tecnica per copiare tutti i nostri sorgenti (anche da diverse librerie e file-sorgenti) a directory IFS come file di testo per poi sincronizzarle su un progetto GIT, GITHUB ecc.
Niels Liisberg: Export Source to GIT
Oppure puoi lavorare con GIT anche direttamente da RDI con il plung EGIT … o anche da Rdi e SEU con il progetto “iForGit”
Se un programma RPG che vogliamo pubblicare come Web Service contiene delle Procedure Java potremmo ricevere l’errore “RNF0302 – Errors were found while generating the program information to be placed in the module” in fase di compilazione nella costruzione del “documento” PCML …
Per ovviare al problema dobbiamo indicare sulla Program Interface della procedure JAVA la keyword PGMINFO(*NO)
ctl-opt pgminfo(*PCML: *MODULE: *DCLCASE);
Dcl-Pr myrpgws ExtPgm('MYRPGWS');
*n Char(8) Const;
*n Char(8) Const;
*n Char(1) Const;
*n Char(1000);
End-Pr;
*
Dcl-Pi myrpgws;
InSundayDate Char(8) Const;
InSaturdayDate Char(8) Const;
InFinalFlag Char(1) Const;
OutResults Char(1000);
End-Pi;
...
...
Dcl-Proc newString Export;
D newString PI O Class(*java: jStrConst) PGMINFO(*NO)
D pString 32767A Const
....
Per gestire arrays a lunghezza variabile in programmi RPG con *PCML bisogna aggiungere l’opzione *V7 nella keyword PGMINFO():
ctl-opt pgminfo(*PCML: *MODULE:*DCLCASE: *V7);
Sappiamo che quando compiliamo un programma con l’opzione REPLACE(*YES), l’oggetto originale, prima di essere sostituito con il nuovo “compilato” viene spostato nella QRPLOBJ ed eventuali programmi in esecuzione continuano a funzionare utilizzando l’oggetto nella nuova posizione (QRPLOBJ) con un nome (Generato in fase di pre-compilazione).
Se avessimo la necessità di simulare questo tipo di gestione degli oggetti senza una vera e propria compilazione … quindi dobbiamo sostituire un oggetto programma mantenendo funzionanti eventuali JOB attivi al momento, possiamo ricorrere ad una API di sistema: QLIRNMO API
Come documentato nella IBM Knowledge Center la API QLIRNMO permette di spostare un oggetto, rinominarlo e sostiuirlo con un altro oggetto sempre nella stessa posizione … praticamente quello che fa il pre-compilatore con la QRPLOBJ:
In questa discussione di CODE400.com vediamo una interfaccia all’uso della API:
The API (From https://code400.com/forum/forum/iseries-programming-languages/free-format/1756-the-rename-object-api-qlirnmo)
* PROGRAM - @RENAME
* PURPOSE - rename object use API QLIRNMO
* WRITTEN -
* AUTHOR -
* PROGRAM DESCRIPTION
*--------------------------------------------------------
*
* Entry Plist
*
d @RENAME pr
d OldFile 10
d OldLib 10
d NewFile 10
d NewLib 10
d inType 10
*
d @RENAME pi
d OldFile 10
d OldLib 10
d NewFile 10
d NewLib 10
d inType 10
*
* Variable Definition
*
d Error s 34
d FromObject s 20
d ObjectType s 10
d ToObject s 20
d Replace s 1
*
* Program Info
*
d SDS
d @PGM 001 010
d @PARMS 037 039 0
d @MSGDTA 91 170
d @MSGID 171 174
d @JOB 244 253
d @USER 254 263
d @JOB# 264 269 0
//
// external calls
//
d $Rename pr extpgm('QLIRNMO')
d fromObject 20
d ObjectType 10
d ToObject 20
d Replace 1
d Error 34
/Free
//--------------------------------------------------------
// MAIN LINE
//--------------------------------------------------------
// take parms and rename --and/or-- move object
FromObject = OldFile + OldLib;
ToObject = NewFile + NewLib;
ObjectType = InType;
replace = '1';
$rename(FromObject : ObjectType : ToObject : Replace : Error);
*inlr = *on;
//--------------------------------------------------------
// *Inzsr - one time run subroutine
//--------------------------------------------------------
begsr *inzsr;
endsr;
/End-Free
---
Roberto De Pedrini
Faq400.com I primi di Aprile è uscita la "Spring Version" di ACS Access Client Solution, versione 1.1.9.5 Interessanti novità soprattutto in…
Se non vi bastava la ricca agenda delle sessioni del Common Europe Congress 2024, 3-6 Giugno Milano, ecco un altro…
Le funzioni di debug con Visual Studio Code sono disponibili da qualche tempo ma questa nuova versione 2.10.0 semplifica la…
A distanza di due anni e mezzo dal mio post Trasferire oggetti con ObjectConnect ed Enterprise Extender, sono finalmente riuscito…
Con un piccolo trucco anche una semplice istruzione SELECT può eseguire qualsiasi comando di sistema ! Vediamo come...
Una mini-guida a puntate per la configurazione, gestione, uso e risoluzione dei problemi di IBM i NetServer