| At line 1 added 75 lines |
| %%(display:none) |
| {{{ |
| WikiUp |
| }}} |
| /% |
| [{TableOfContents }]\\ |
| !!! £G80 FUNZIONI SU IFS\\ |
| !!! OBIETTIVO\\ |
| Gestire i file e le cartelle dell'IFS dell'AS400 da un programma RPG |
|
| !! SIGNIFICATO DEI CAMPI DI INPUT\\ |
| ::R02 FUNZIONE E METODO1. La funzione WRITE richiede che dopo la scrittura dell'ultimo record venga effettuata una chiamata alla £G80 con funzione CLOSE. |
| 2. Prima della DELETE eseguire la G80 con funzione e metodo *BLANKS per farsi restituire il tipo oggetto da cancellare (da mettere nel metodo della DELETE) |
| *blanks : controlla l'esistenza di un oggetto dell'ifs. |
| WRITE : crea o scrive un oggetto dell'ifs. |
| - '*STMF': scrive il contenuto di £G80ST nel file specificato in £G80PH. Se il file non esiste lo crea, altrimenti accoda il contenuto a quello esistente. |
| - '*DIR' : crea la cartella specificata in £G80PH. Nota bene: la cartella viene creata con autorizzazione PUBLIC(*ALL) |
|
| READ: legge il contenuto di un oggetto dell'ifs. |
| - '*STMF': legge il contenuto del file specificato in £G80PH, un record alla volta |
| - '*DIR' : legge il contenuto della cartella specificata £G80PH, un oggetto alla volta. |
|
| __- DELETE__ : cancella un oggetto dell'ifs. |
| Prima della DELETE eseguire la G80 con funzione e metodo blanks |
| per farsi restituire il tipo (*STMF o *DOC o *DIR) dell'oggetto da cancellare. |
| Questo tipo oggetto andrà messo poi nel metodo della funzione DELETE. |
| £G80ME='*STMF': cancella il file specificato in £G80PH (questo file deve essere di tipo *STMF) |
| £G80ME='*DOC' : cancella il file specificato in £G80PH (questo file deve essere di tipo *DOC) |
| £G80ME='*DIR' : cancella la cartella specificata £G80PH, solo se è vuota. |
|
| __- CLOSE__ : chiude (termina l'elaborazione) di un oggetto dell'ifs. |
| £G80ME='*STMF': va specificato dopo la scrittura dell'ultimo record scritto (funzione WRITE/*STMF), oppure |
| dopo l'ultimo record letto, nel caso si voglia ripetere il ciclo di lettura. |
| £G80ME='*DIR' : va specificato dopo la lettura dell'ultimo record letto (funzione READ/*DIR), nel caso si |
| voglia ripetere il ciclo di lettura. |
|
| __£G80PH__= Path |
| - è il path completo dell'oggetto ifs da gestire. Il primo byte deve essere il carattere '/'. |
| Esempio di oggetto *STMF: /tmp/prova.txt |
| Esempio di oggetto *DIR : /tmp/ |
|
| __£G80CP__= Code page |
| - è la code page dell'oggetto *STMF da creare. Se il campo è lasciato *blanks, assume il default italiano (850). |
|
| __£G80ST__= Stringa |
| - è la stringa (record) da scrivere con la funzione WRITE/*STMF |
|
| __£G80RL__= Lunghezza record |
| - fissa la lunghezza di in record con la funzione WRITE/*STMF. Se questa non viene indicata viene assunta la lunghezza della stringa trimmata a destra passata con la WRITE |
|
| __£G80EO__= Caratteri fine record |
| - fissa i caratteri che vengono aggiunti alla fine record con la funzione WRITE/*STMF. Se il parametro non viene passato vengono assunti i caratteri ASCII CR/LF (cioè i valori esadecimaili 0D/0A) che indificano l'"a capo". Se invece voglio che non venga aggiunto alcun carattere va passata come costante '*NONE'. |
|
| !! SIGNIFICATO DEI CAMPI DI OUTPUT\\ |
|
| __£G80CO__= contenuto |
| - è il contenuto dell'oggetto specificato con la funzione READ. |
| .se il metodo è *STMF contiene il record del file |
| .se il metodo è *DIR contiene il nome dell'oggetto contenuto nella cartella |
|
| __£G80OG__= oggetto |
| - è il path completo dell'oggetto letto con la funzione READ o *blanks |
|
| __£G80TO__= tipo oggetto |
| - è il tipo oggetto dell'oggetto letto con la funzione READ o *blanks |
|
| __£G80D1/£G80H1__= Data e ora della modifica dello stato dell'oggetto |
| __£G80D2/£G80H2__= Data e ora della modifica del contenuto dell'oggetto |
| __£G80D3/£G80H3__= Data e ora dell'ultimo accesso all'oggetto |
|
| __£G8035/*IN35__= indicatore di errore |
| - impostato a '1' nei seguenti casi: |
| .oggetto non trovato (funzione *blanks) |
| .fine file/file cartella (funzione READ) |
| .errore generico (tutte le funzioni) |
