| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
https://www.neroni.it/NERONI2/JFROMTXT.NERONI2.HTML
Il comando permette di caricare un file di testo dall'IFS ad un file fisico dell'AS400.
Il file di testo giace in un indirizzario IFS.
Per indirizzario IFS si intende un indirizzario giacente su AS400 ed indirizzabile tramite il comando WRKLNK. Sul lato pc si accede al medesimo indirizzario essenzialmente tramite FTP. Spesso e' possibile vedere un indirizzario IFS anche tramite la gestione risorse del pc.
Il comando e' una semplice interfaccia verso il CPYFRMIMPF veramente delicatuccio per un rapido uso.
La presente utility fornisce anche tre file di comodo JFROMTXT1, JFROMTXT2 e JFROMTXT32 da usare come prototipo per caricare testi con un solo campo lungo 1000, 2000 o 32000 caratteri.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| PROTOFILE | Prototype file | Qualified object name | Required, Positional 1 |
| Qualifier 1: Prototype file | Name, JFROMTXT1, JFROMTXT2, JFROMTXT32 | ||
| Qualifier 2: library | Name, *LIBL | ||
| TOFILE | To database file | Single values: *PROTOFILE Other values: Qualified object name |
Required, Positional 2 |
| Qualifier 1: To database file | Name | ||
| Qualifier 2: library | Name, QTEMP, *LIBL, *PROTOLIB | ||
| FROMFILE | From TXT file (no extension) | Path name, *PROTOFILE, *TOFILE | Required, Positional 3 |
| FROMEXT | From TXT file (extension) | Path name, '.txt', ' ', *BLANK | Optional, Positional 4 |
| FROMDIR | From directory | Path name, *USR, '/home/mydir', *UF, *XX | Optional, Positional 5 |
| FILEOPT | Replace file or add records | *REPLACE, *ADD | Optional, Positional 6 |
| REFPGM | Reference program for messages | Name, *CPP | Optional, Positional 7 |
| Top |
Nome del file prototipo di database contenente il tracciato secondo il quale deve essere ricaricato il file testo.
Il tracciato del file ricevente deve essere di soli campi carattere (e allora non si manifesteranno mai errori nei dati decimali) o, almeno, "piatti" cioe' contenenti anche campi numerici ma solo di tipo zonato (o segnato, che dir si voglia). In questo caso occorre fare in modo che i campi numerici zonati ricevano solo caratteri numerici. L'uso di campi impaccati, binari od altri tipi di numerici provochera' errori nei dati decimali, specialmente al momento dell'uso successivo del file caricato.
Il valore e' obbligatorio.
Valori permessi:
Valori speciali:
Nome della libreria in cui risiede il file prototipo.
Valori permessi:
Valori speciali:
| Top |
Nome del file AS400 destinato a contenere i dati provenienti dal file TXT.
Se il file ricevente non preesiste, viene creato nella libreria ricevente.
Se il file ricevente preesiste e non coincide con il prototipo, viene prima cancellato e poi ricreato.
Se la libreria ricevente e' *LIBL, il file ricevente deve preesistere in lista librerie affinche' si possa individuare una specifica libreria ricevente da usare invece di *LIBL.
Il valore e' obbligatorio.
Valori permessi:
Valori singoli:
Nome della libreria in cui risiede o risiedera' il file ricevente.
Valori permessi:
Valori speciali:
| Top |
Nome del file giacente nell'IFS in formato testo.
Il nome qui riportato puo' essere senza estensione poiche' l'estensione puo' essere indicata nel parametro apposito.
Il valore e' obbligatorio.
Valori permessi:
Valori speciali:
| Top |
Estensione del file di provenienza da aggiungere in coda al nome.
Valori permessi:
Valori speciali:
| Top |
Nome dell'indirizzario IFS in cui giace il file di provenienza da caricare.
Tutto quanto e' indirizzabile nel parametro OBJ del comando WRKLNK puo' essere indirizzato anche in questo parametro.
Si raccomanda tuttavia che sia un sottoindirizzario di "/home", come consigliato dalla letteratura per i dati utente.
Valori permessi:
Valori speciali:
| Top |
Sostituisce il file ricevente o aggiunge record in coda.
Valori permessi:
| Top |
Nei tool complessi a piu' livelli, il presente parametro compare in tutti i comandi di interfaccia dal primo all'ultimo dei chiamati in cascata e permette di condividere il programma di riferimento al cui chiamante verranno spediti i messaggi emessi da tutti i tool coinvolti.
Il programma di riferimento e' il command processing program del tool di cappello che in cascata chiama tutti gli altri. Il cappello, dopo aver riempito con il proprio nome il parametro "programma di riferimento", lo passa anche ai tool chiamati che lo utilizzano per spedire i propri messaggi.
Valori permessi:
I messaggi emessi dal programma corrente saranno indirizzati al chiamante del programma di riferimento, preferibilmete un video comandi.
Utile quando il comando corrente e' chiamato da un altro comando con il quale condivide il presente parametro.
Valori speciali:
I comandi da questo chiamati (e che prevedono lo stesso parametro) faranno riferimento al programma corrente e i messaggi emessi da tali programmi saranno indirizzati al chiamante del programma corrente.
Utile quando il comando corrente e' il primo chiamante da un video comandi e a sua volta chiama altri tool condividendo il presente parametro.
| Top |
Esempio zero: Crea ambiente di prova
Per costruire l'esempio avendo un file TXT con caratteristiche conosciute, si genera preliminarmente il file TXT in IFS facendo uso del comando JTOTXT e dell'esempio di scarico spiegato nell'help relativo, qui ricapitolato.
Scarica un file TXT:
> JTOTXT FROMFILE(QAUOOPT) TOTXT(PDMOPT)
TODIR('/home/neroni')
Copiato il file di database NERONI2/QAUOOPT
nel file TXT /home/neroni/PDMOPT.txt
Esempio 1: Carica da IFS un file TXT in un file di database usando come prototipo di definizione il file di database che genero' lo scarico
Carica il file ottenuto in IFS tramite il soprastante "Esempio zero".
> JFROMTXT PROTOFILE(QAUOOPT) TOFILE(PDMOPT)
FROMFILE(PDMOPT)
Copiato il file TXT /home/NERONI/PDMOPT.txt nel file
di database QTEMP/PDMOPT Prototipo: NERONI2/QAUOOPT
> /**/RUNQRY QRYFILE((QTEMP/PDMOPT)) RCDSLT(*YES)
Per vedere il risultato si puo' duplicare ed eseguire il comando prototipo /**/ visibile nel log.
| Top |
| Top |