£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.
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)
