Unload database to CSV (JTOCSV)

Comando JTOCSV

Unload database to CSV

Scarica un file di database su IFS usando il formato CSV.

Con un FTP chiamato da pc o se l'IFS e' definito come disco PC, il file puo' essere portato su pc e poi aperto con EXCEL. Non e' opportuno aprirlo direttamente su IFS con Excel perche' normalmente l'apertura dura un tempo esagerato.

Il comando e' nato per trasferire dati su pc in un formato familiare all'utente Office.

Parameters

Keyword	Description	Choices	Notes
FROMFILE	From database file	Qualified object name	Required, Positional 1
	Qualifier 1: From database file	Name
	Qualifier 2: library	Name, *LIBL
TOCSV	To CSV file (no extension)	Path name, DFT, FROMFILE	Optional, Positional 2
TODIR	To directory	Path name, USR, '/home/mydir', UF, *XX	Optional, Positional 3
HEAD	Heading	BOTH, FIELD, TEXT, NONE	Optional, Positional 4
STRDLM	String delimiter	Character value, DBLQUOTE, NONE, '"'	Optional, Positional 5
RMVBLANK	Remove blanks	NONE, LEADING, TRAILING, BOTH, *EOR	Optional, Positional 6
REFPGM	Reference program for messages	Name, *CPP	Optional, Positional 7

Top

From database file (FROMFILE) - file

Nome del file fisico o logico contenente i dati da scaricare.

Valore obbligatorio.

Valori permessi:

nome-file-emissione: Il nome indicato viene usato per il file da scaricare.

From database file (FROMFILE) - library

Nome della libreria in cui risiede il file fisico o logico contenente i dati da scaricare.

Valori permessi:

*LIBL: Il file da scaricare viene cercato in lista librerie.
nome-libreria: Il file da scaricare viene cercato nella libreria richiesta.

To CSV file (no extension) (TOCSV)

Nome del file CSV da scrivere nell'indirizzario IFS (senza estensione)

Valori permessi:

nome-file-IFS: Il nome del file con tracciato CSV da scrivere sull'indirizzario IFS.

Valori speciali:

*DFT: Il nome del file IFS viene composto riunendo con un trattino nome libreria e nome file da scaricare.
*FROMFILE: Il nome del file IFS viene composto con il solo nome del file da scaricare.

To directory (TODIR)

Indirizzario ricevente del file scaricato.

Valori permessi:

nome-indirizzario-IFS: Il nome dell'indirizzario IFS ricevente del file scaricato con tracciato CSV.

Valori speciali:

*USR: Il nome dell'indirizzario IFS viene composto riunendo "/home/" con il nome dell'utente corrente.
/home/mydir: La presente entrata costituisce un semplice promemoria sulla forma del parametro.
*UF: Il nome dell'indirizzario IFS viene composto riunendo "/webufhtml/" con il nome dell'utente corrente.
*XX: Il nome dell'indirizzario IFS viene composto riunendo "/webufhtml/", il nome dell'utente corrente e "/xx".

Heading (HEAD)

Intestazioni

Inserisce in testa al file le intestazioni di colonna.

Valori permessi:

*BOTH: Inserisce due righe di intestazione. La prima come quella prevista per l'opzione *FIELD. La seconda come quella prevista per l'opzione *TEXT.
*FIELD: Inserisce una riga di intestazione composta con i nomi di campo del file datore.
*TEXT: Inserisce una riga di intestazione composta con il testo dei campi del file datore.
*NONE: Non inserisce alcuna intestazione.

String delimiter (STRDLM)

Delimitatore di stringa

Un solo carattere usato per contornare i dati alfanumerici.

Valori permessi:

carattere: Qualsiasi carattere.

Valori speciali:

*DBLQUOTE: Il carattere scelto e' doppio apice (").
*NONE: Nessun delimitatore per contornare i dati alfanumerici.
": Come *DBLQUOTE.

Remove blanks (RMVBLANK)

Rimuove spazi

Specifica se gli spazi vengono eliminati o conservati per ogni singolo campo dati.

Valori permessi:

*NONE: Tutti gli spazi iniziali e di coda vengono conservati.
*TRAILING: Gli spazi di coda vengono eliminati.
*LEADING: Gli spazi iniziali vengono eliminati.
*BOTH: Gli spazi iniziali e di coda vengono eliminati.
*EOR: Gli spazi in coda vengono eliminati dall'ultimo campo del record.

Reference program for messages (REFPGM)

Programma di riferimento dei messaggi.

La trappola permette di dare visibilita' a tutti i messaggi come se fossero spediti tutti dallo stesso programma, scelto tramite il presente parametro.

Valori permessi:

Nome del programma in lista di chiamata.

Il nome di un programma presente nella lista di chiamata del programma corrente.

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.

Valori speciali:

*CPP

Il valore *CPP viene sostituito con il nome del programma corrente.

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.

Esempi per JTOCSV

Esempio 1: Scarica su IFS un file di database

Genera un file da scaricare:

> DSPFD FILE(NERONI2/JRSNMSG) TYPE(*MBRLIST)
        OUTPUT(*OUTFILE) OUTFILE(QTEMP/TEST)
  Il file di emissione TEST e' stato creato nella libreria
    QTEMP.
  Il membro TEST e' stato aggiunto al file di emissione TEST
    nella libreria QTEMP.
  6 record sono stati aggiunti al membro TEST nel file TEST
    in QTEMP.

Scarica con i soli parametri necessari:

> JTOCSV FROMFILE(QTEMP/TEST) RMVBLANK(*TRAILING)
  Copiato il file di database datore QTEMP/TEST nel file IFS
    ricevente /home/NERONI/QTEMP-TEST.csv
> /**/DSPF STMF('/home/NERONI/QTEMP-TEST.csv')

Anche con i parametri di default:

> JTOCSV FROMFILE(QTEMP/TEST) TOCSV(*DFT) TODIR(*USR)
  HEAD(*BOTH) STRDLM(*DBLQUOTE) RMVBLANK(*TRAILING)
  REFPGM(*CPP)

Per vedere il risultato si puo' duplicare ed eseguire il comando prototipo /**/ visibile nel log.

Messaggi informativi e di completamento

Messaggi *INFO e *COMP

JTC0191: Copiato il file di database datore &1/&2 nel file IFS ricevente &3

Messaggi di errore

Messaggi *DIAG seguiti da *ESCAPE CPF0001

JTC0101: Il delimitatore di stringa &1 contiene piu' di un carattere
JTC0111: L'indirizzario IFS &1 non esiste
JTC0112: Il file &1/&2 non esiste