Zips IFS directory (JZIP)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

Comando JZIP

Zips IFS directory

Zippa un indirizzario IFS in un file ".zip"

Il comando permette di zippare un intero indirizzario dell'area IFS su AS400 con lo stesso algoritmo usato dalle utility PKZIP o WINZIP del PC.

Lo zippaggio a bordo dell'AS400 permette di ridurre sia la quantita' di dati che il numero di file da maneggiare quando e' necessario inviare dati da AS400 a PC via FTP o via MAIL o in qualunque altro modo.

Lo zippaggio viene eseguito chiamando il comando Control Language QSH che, a sua volta, chiama il comando di tipo shell interpreter jar al quale viene impedita l'apertura della propria interfaccia.

Il passaggio a jar del parametro env - QIBM_QSH_CMD_OUTPUT="NONE" evita la visualizzazione del video QSH che verrebbe presentato in caso di errore, richiedendo INVIO per continuare.

Il comando jar, opportunamente parametrizzato, esegue la sola funzione di zippaggio e ritorna immediatamente restituendo messaggi interpretati dal comando corrente per restituire l'esito dell'azione.

Il file zippato e' sempre omonimo dell'indirizzario con l'estensione standard ".zip" e non e' prevista alternativa. E' comunque possibile scegliere l'indirizzario in cui posizionarlo.

Top

Parameters

Keyword Description Choices Notes
FROMDIR From directory Path name, '/home/JZIP', '/home/JZIP/MYDIR' Required, Positional 1
TODIR To directory Path name, *FOOT, '/home/JZIP' Optional, Positional 2
TREE Tree reproduction in zip *YES, *NO Optional, Positional 3
Top

From Directory (FROMDIR)

Percorso e Nome dell'indirizzario IFS su AS400 che contiene i dati da zippare.

Valori permessi:

nome-percorso-indirizzario-IFS
Il valore e' obbligatorio.

Esempio di valore: /home/jziptest

Top

To Directory (TODIR)

Percorso e indirizzario nel quale viene depositato il file zippato.

Valori permessi:

*FOOT
Il file zippato viene depositato nell'indirizzario contenente l'indirizzario da zippare. Ad esempio se FROMDIR('/home/jziptest'), *FOOT equivale a TODIR('/home').
nome-percorso-indirizzario-IFS
Percorso destinatario.

Esempio di valore: /home

Top

Tree reproduction in zip (TREE)

Riproduzione dell'albero indirizzari nel file zip.

Valori permessi:

*YES
Il file zip di emissione riprodurra' l'albero degli indirizzari.

*YES fa in modo che il compressore jar NON riceva il parametro -P (Preserve leading '/').

*NO
Il file zip di emissione NON riprodurra' l'albero degli indirizzari.

*NO fa in modo che il compressore jar riceva il parametro -P (Preserve leading '/').

Top

Esempi per JZIP

Premessa: Si creino i seguenti elementi per il test

Si riportano comandi e log. 

Creare i seguenti indirizzari
> MKDIR DIR('/home/jziptest')
  Indirizzario creato.
> MKDIR DIR('/home/jziptest/uno')
  Indirizzario creato.
> MKDIR DIR('/home/jziptest/due')
  Indirizzario creato.
Creare un semplice file di testo facendo uso,
ad esempio, di edit file:
> EDTF STMF('/home/jziptest/testox.txt')
Contenuto esemplificativo senza importanza
visualizzato con display file:
> DSPF STMF('/home/jziptest/testox.txt')
 ************Inizio dei dati****************
prima riga
seconda riga
 ************Fine dati**********************
Con dei copy, creare qualche file per popolare
gli indirizzari.
> CPY OBJ('/home/jziptest/testox.txt')
    TOOBJ('/home/jziptest/uno/testoa.txt')
  Oggetto copiato.
> CPY OBJ('/home/jziptest/testox.txt')
    TOOBJ('/home/jziptest/uno/testob.txt')
  Oggetto copiato.
> CPY OBJ('/home/jziptest/testox.txt')
    TOOBJ('/home/jziptest/due/testoc.txt')
  Oggetto copiato.
> CPY OBJ('/home/jziptest/testox.txt')
    TOOBJ('/home/jziptest/due/testod.txt')
  Oggetto copiato.
Esplorare l'indirizzario tramite work link:
> WRKLNK OBJ('/home/jziptest/*')
Si e' realizzata la seguente struttura:
/home
     /jziptest
              testox.txt
              /uno
                   testoa.txt
                   testob.txt
              /uno
                   testoc.txt
                   testod.txt

Esempio 1: Genera lo zip file jziptest.zip che riproduce la struttura di partenza con all'interno i file zippati. 

> JZIP FROMDIR('/home/jziptest')
  Zippato l'indirizzario "/home/jziptest".

Se si visualizza il file zippato con WINZIP, si ottiene la medesima struttura sopra illustrata lungo la quale sono sparpagliati i file zippati. 

/home
     /jziptest
              testox.txt
              /uno
                   testoa.txt
                   testob.txt
              /uno
                   testoc.txt
                   testod.txt

Esempio 2: Genera lo zip file jziptest.zip che contiene i file zippati in un elenco senza strutture intermedie. 

> JZIP FROMDIR('/home/jziptest') TREE(*NO)
  Zippato l'indirizzario "/home/jziptest".

Se si visualizza il file zippato con WINZIP, si ottiene un elenco semplice di tutti i file zippati senza riguardo alla loro posizione negli indirizzari. 

testox.txt
testoa.txt
testob.txt
testoc.txt
testod.txt

Top

Messaggi informativi e di completamento

Messaggi *INFO e *COMP

JZP0191
Zippato l'indirizzario "&1".

Messaggi di errore

Messaggi *DIAG seguiti da *ESCAPE CPF0001

JZP0101
Non esiste l'indirizzario da zippare "&1"
JZP0102
Non esiste l'indirizzario di destinazione "&1"
JZP0103
Errore zippando l'indirizzario "&1".
JZP0104
Errore imprevisto zippando l'indirizzario "&1".
Top