| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
La procedura e' composta dai comandi JCLNPF1 JCLNPF2 JCLNPF3 JCLNPF4 JCLNPF5 documentati nei rispettivi help mentre la documentazione della procedura risiede nell'help del comando fittizio JCLNPF
Crea e riempie la libreria di lavoro per la pulizia dei file fisici.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| WRK | Cleaning work library suffix | Name | Required, Positional 1 |
| LIB | Library or Library list | Name, *LIBL, *USRLIBL, *ALLUSR, *ALL | Optional, Positional 2 |
| MBROPT | Info generation option | *REPLACE, *ADD, *RPLLIB | Optional, Positional 3 |
| TEXT | Short text of Work library | Character value, *SAME, *LIB, *LIBADD | Optional, Positional 4 |
| REFPGM | Reference program for messages | Name, *CPP | Optional, Positional 5 |
| Top |
La procedura utilizza un gruppo di file con prefisso "JCLN" che vengono creati, riempiti e gestiti in una "Work Library" il cui nome viene composto facendo uso dello stesso prefisso "JCLN" e del suffisso indicato in questo parametro.
Il suffisso e' il primo parametro in tutti i comandi della procedura ed identifica in modo elementare ed univoco l'operazione di pulizia intrapresa con il primo comando della serie (JCLNPF1).
Valori permessi:
| Top |
Nome della libreria da pulire.
Valori permessi:
Valori speciali:
| Top |
Opzione di Sostituzione/Aggiunta/SostituzioneParziale delle informazioni.
Valori permessi:
| Top |
Testo corto della libreria di lavoro per la pulizia.
Valori permessi:
Valori speciali:
Se corrono MBROPT(*REPLACE) e TEXT(*SAME), compone per la Clean Work Library un testo di 50 caratteri riunendo la costante "Clean Work: " con il contenuto del parametro LIB.
Se corrono MBROPT(*ADD) e TEXT(*LIBADD), accoda al testo gia' attribuito alla Clean Work Library un trattino seguito dal contenuto del parametro LIB.
Se corre TEXT(*SAME), lascia inalterato il testo gia' attribuito alla Clean Work Library.
Se corre TEXT(*LIB), compone per la Clean Work Library un testo di 50 caratteri riunendo la costante "Clean Work: " con il contenuto del parametro LIB.
In tutti gli altri casi, compone per la Clean Work Library un testo di 50 caratteri riunendo la costante "Clean Work: " con il contenuto del parametro TEXT.
| 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, direttamente o indirettamente, 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.
ATTENZIONE: Il valore *PRV e' previsto solo in qualche comando di ultimo livello allo scopo di renderne comoda la chiamata in un contesto non strutturato come detto sopra. Per sapere se uno specifico comando utilizza il valore *PRV, consultare l'elenco dei valori permessi premendo F4 sul parametro REFPGM.
| Top |
Esempio 1: Avvia l'esame di una libreria da pulire.
Con i soli parametri necessari:
JCLNPF1 WRK(NERO) LIB(NERONI2)
Anche con i parametri di default:
JCLNPF1 WRK(NERO) LIB(NERONI2) MBROPT(*REPLACE)
TEXT(*SAME) REFPGM(*CPP)
Questo comando avvia l'esame della libreria NERONI2 creando e utilizzando la libreria di work JCLNNERO. Il comando genera un log di cui si riporta esempio.
> JCLNPF1 WRK(NERO) LIB(NERONI2)
->Verifica esistenza database in WorkLib: JCLNNERO
->Display File Desc Type Member in corso lib NERONI2
->Display Object Desc Type File Detail Full in corso
lib NERONI2
->Creata e riempita WorkLib JCLNNERO per pulizia file
fisici di NERONI2
> /**/RUNQRY QRYFILE((JCLNNERO/JCLNPFMB)) RCDSLT(*YES)
> /**/RUNQRY QRYFILE((JCLNNERO/JCLNPFOD)) RCDSLT(*YES)
> /**/JCLNPF2 WRK(NERO) SLTUSE(CYYMMDD) SLTCNT(2)
SLTCHG(CYYMMDD)
Si osservino i messaggi informativi e i comandi promemoria duplicabili per indagare o per eseguire i passi successivi della procedura.
| Top |
Messaggi *INFO e *COMP
Messaggi *DIAG seguiti da *ESCAPE CPF0001
| Top |