%%(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)