Si usi questo comando per decomprimere ("unzip-pare") un qualunque "zip" file, compresi quelli generati con il comando ZIPSAVE. I file decompressi vengono resi disponibili nell'indirizzario /home del profilo utente del lavoro. Esempio: /home/CARLA , dove CARLA è il profilo utente del lavoro.
Se l'indirizzario non esiste, viene automaticamente creato.

A seconda della scelta dell'utente, l'operazione di decompressione viene effettuata

• o dal comando JAR (Java ARchive) della Qshell
• o dal comando CPYFRMARCF (Copy from Archive File), a patto di essere almeno su un rilascio V7R2.

Nota: Se si vuole sottomettere il comando ad una esecuzione batch, assicurarsi che il comando SUBMIT specifichi JOBQ(QSYSNOMAX).

Nota sui CCSID - I dati del file compresso mantengono sempre il CCSID originario, mentre per il file compresso il CCSID (di etichetta) può essere stato variato dallo strumento di compressione. Per exempio: il comando ZIPSAVE assegna sempre il CCSID 819 (ASCII) ai file compressi.
Gli strumenti di un-zip possono comportarsi in modo diverso:

• JAR mantiene nel file decompresso lo stesso CCSID di file del file compresso (mentre il CCSID dei dati del file resta sempre invariato)
• Il comando CPYFRMARCF assegna al file decompresso il CCSID del lavoro (per esempio: 37).

    CHGATR OBJ('/home/judy/readme.txt') ATR(*CCSID) VALUE(37)

Parametri del comando

Unzip a ZIP stream file (UNZIPSAVE) Type choices, press Enter. ZIP stream file. . . . . . . . ZIPFILE /tmp/xxx.zip UNZIP tool. . . . . . . . . . . UNZIPTOOL *JAR *JAR, *CPYFRMARCF Zipped Savf stream file. . . . SAVFSTMF ABC.SAVF Load the save file. . . . . . . LOADSAVF *YES *YES, *NO Save file library. . . . . . . SAVFLIB QGPL name Display the loaded save file. . DSPSAVF *NO *YES, *NO Output messages. . . . . . . . OUTPUT * *, *PRINT, *NONE Display home directory. . . . . DSPHOMEDIR *YES *YES, *NO

Nota 1 - Per fornire informazioni appropriate ai parametri SAVSTMF e READMESTMF, può essere necessario usare il comando DSPZIPSAVE per conoscerne il contenuto.

• ZIP stream file (ZIPFILE)
  Nome qualificato (path e nome) dello zip file che contiene i file da decomprimere.
• UNZIP tool (UNZIPTOOL)
  Lo strumento che si vuole usare per decomprimere i file compressi nello zip file. Sono disponibili due strumenti:
  1. *JAR - Il comamndo 'Jar' della Qshell. Il comand JAR è disponibile in tutti i rilasci del sistema operativo.
     I file vengono decompressi nell'indirizzario corrente.
     Il comando UNZIPSAVE predispone temporaneamente l'indirizzario corrente all'indirizzario home del profilo utente del lavoro.
  2. *CPYFRMARCF (Copy from Archive File) - Comando disponibile dal rilascio V7R2.
     Esso decomprime i file nell'indirizzario specificato in un parametro del comando. Tuttavia nell'ambito di UNZIPSAVE, anche CPYFRMSARCF viene diretto a decomprimere i file nell'indirizzario home del profilo utente del lavoro.
• Zipped Savf stream file (SAVSTMF) - questo è esattamente il nome del file di flusso - contenente il file di savataggio - che si vuole decomprimere nell'indirizzario home del profilo utente. Esempio: 'MYLIB.SAVF', il file di salvataggio della libreria MYLIB.
  Nota 2 - Un errore di questo nome causa il fallimento del caricamento dei dati nel file di salvataggio.
  Si immetta *NONEse nello zip file non c'è un file di salvataggio compresso, oppure se si vuole elaborare tale file separatamente, a decompressione avvenuta.
• Load the save file (LOADSAVF) -
  Questo parametro è disponibile solo quando nel parametro SAVSTMF viene specificato il nome di un file di salvataggio.
  Si specifica *YES se si vuole che i dati del file di flusso decompresso venìgano caricati in un file di salvataggio con lo stesso nome.
  La libreria di tale file di salvataggio va specificata nel parametro successivo SAVFLIB.
  Se questo file di salvataggio non esiste in quella libreria, esso viene creato automaticamente.
  Nota - Se si specifica LOADSAVF(*YES), il file di flusso temporaneamente memorizzato nell'indirizzario home del profilo utente viene cancellato una volta che i suoi dati sono stati caricati nel file di salvataggio.
• Save file library (SAVFLIB) -
  Questo parametro è disponibile solo quando si specifica LOADSAVF(*YES).
  Immettere il nome della libreria del file di salvataggio che deve ricevere i dati del file decompresso. Esempi: QTEMP, QGPL, ...
• Display the inflated save file (DSPSAVF) -
  Questo parametro è disponibile solo se si è specificato LOADSAVF(*YES)
  Immettere *YES per visualizzare il contenuto del file di salvataggio una volta che sia stato caricato.
• Output messages (OUTPUT) -
  Questo parametro è disponibile solo se si è specificato UNZIPTOOL(*JAR)
  Il parametro dice come i messaggi emessi dal comando JAR della Qshell (e relativi ai processi di decompressione nell'indirizzario home debbano essere visualizzati.
  Scelte possibili:
  • * - Se il comando viene eseguito in ambiente interattivo, i messaggi compaiono sullo schermo; altrimenti vengono scritti in un file di stampa di nome JAROUT.
  • *PRINT - I messaggi vengono scritti su un file di stampa denominato JAROUT.
  • *NONE - I messaggi non vengono riportati.
• Display home directory (DSPHOMEDIR) - Specifica se alla fine del processo debba essere visualizzato l'indirizzario home del profilo utente.
  Questo parametro viene ignorato in un lavoro batch.

Esempi

1. UNZIPSAVE ZIPFILE('/myzip.zip') ZIPTOOL(...)
   Questo comando fa sì che i file compressi contenuti nello zip file vengano decompressi nell'indirizzarion corrente, l'indirizzario home del profilo utente del lavoro
2. UNZIPSAVE ZIPFILE('/myzip.zip') ZIPTOOL(...) DSPHOMEDIR(*YES)
   Come nel caso precedente, ma in più alla fine del lavoro viene visualizzato l'indirizzario corrente.
3. UNZIPSAVE ZIPFILE('/myzip.zip') ZIPTOOL(...) SAVFSTMF('/mylib.savf') LOADSAVF(*YES) SAVFLIB(QGPL) DSPSAVF(*YES) OUTPUT(*)
   I file compressi vengono espansi nell'indirizzario corrente. Successivamente i dati del file di flusso decompresso 'mylib.savf' vengono caricati nel file di salvataggio QGPL/MYLIB. Alla fine viene visualizzato il file di salvataggio QGPL/MYLIB.

indietro