| 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
Sceglie i membri dei file fisici candidati alla pulizia.
Trascrive in un tracciato ridotto e dotato di flag i nomi dei membri candidati alla pulizia.
Utilizza i parametri SLT... per confezionare la prima proposta di membri candidati alla pulizia che potra' essere corretta apponendo un flag di scelta sui record dell'apposito file generato dal comando corrente nella libreria di work.
Il comando emette un messaggio finale che nel secondo livello espone l'analisi quantitativa dei candidati e dei flag di scelta, sia quelli predisposti dal run corrente che quelli predisposti precedentemente dall'operatore modificando i flag sul file.
La logica di candidatura di un membro alla rimozione e' la seguente.
Dati i parametri data ultimo uso, data ultima modifica, conta: 1) Assume Flag scelta iniziale "Rimuovi". 2) Se richiesta una data ultimo uso non valida, se richiesta una data ultima modifica non valida, annota flag scelta iniziale "Conserva". 3) Se richiesta una data ultimo uso valida, se la data di ultimo uso membro e' maggiore del parametro data ultimo uso, se la conta uso membro e' maggiore del parametro conta. annota flag scelta iniziale "Conserva". 4) Se richiesta una data ultima modifica valida, se la data di ultima modifica membro e' maggiore del parametro data ultima modifica, annota flag scelta iniziale "Conserva". 5) Se richiesta una data ultimo uso valida, se la data di creazione membro e' maggiore del parametro data ultimo uso, annota flag scelta iniziale "Conserva". 6) Se richiesta una data ultima modifica valida, se la data di creazione membro e' maggiore del parametro data ultima modifica, annota flag scelta iniziale "Conserva".
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| WRK | Cleaning work library suffix | Name | Required, Positional 1 |
| SLTUSE | Select last use date CYYMMDD | Character value, *NONE, *PRV | Required, Positional 2 |
| SLTCNT | Select use count | Decimal number, 2 | Optional, Positional 3 |
| SLTCHG | Select last chg date CYYMMDD | Character value, *SLTUSE, *NONE, *PRV | 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 |
Data obbligatoria da confrontare con l'ultimo utilizzo.
Il formato della data deve essere SAAMMGG dove: S = Secolo AA = Anno MM = Mese GG = Giorno
Condizione necessaria perche' un membro sia scelto per la pulizia, e' che la sua data di ultimo utilizzo sia piu' vecchia della data indicata nel presente parametro.
Valori permessi:
Valori speciali:
| Top |
Numero di giorni da confrontare con il numero di giorni di utilizzo.
Il parametro "conta" gioca nei criteri di conservazione/rimozione come gia' illustrato piu' sopra nella logica di candidatura di un membro alla rimozione:
3) Se richiesta una data ultimo uso valida, se la data di ultimo uso membro e' maggiore del parametro data ultimo uso, se la conta uso membro e' maggiore del parametro conta. annota flag scelta iniziale "Conserva".
Valori permessi:
| Top |
Data facoltativa da confrontare con l'ultima modifica.
Il formato della data deve essere SAAMMGG dove: S = Secolo AA = Anno MM = Mese GG = Giorno
Condizione necessaria perche' un membro sia scelto per la pulizia, e' che la sua data di ultima modifica sia piu' vecchia della data indicata nel presente parametro.
Valori permessi:
Valori speciali:
| 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: Genera il file delle candidature alla pulizia.
Con i soli parametri necessari:
JCLNPF2 WRK(NERO) SLTUSE(1160418)
Anche con i parametri di default:
JCLNPF2 WRK(NERO) SLTUSE(1160418) SLTCNT(2)
SLTCHG(*NONE) REFPGM(*CPP)
Questo comando esamina i dati gia' raccolti nella libreria di work JCLNBUM e genera un elenco di membri candidati alla pulizia con una data di ultimo utilizzo piu' vecchia del 18-04-2016. Il comando genera un log di cui si riporta esempio.
> JCLNPF2 WRK(NERO) SLTUSE(1160418) SLTCNT(2)
SLTCHG(*NONE) REFPGM(*CPP)
->Genera elenco membri candidati a pulizia.
WorkLib: JCLNNERO
->Da trasferire 123 membri. Vedi secondo livello
->Generato elenco di 689 membri candidati a pulizia.
WorkLib: JCLNNERO
> /**/RUNQRY QRYFILE((JCLNNERO/JCLNPFCA)) RCDSLT(*YES)
> /**/JCLNPF3 WRK(NERO)
Si osservino i messaggi informativi e i comandi promemoria duplicabili per indagare o per eseguire i passi successivi della procedura.
Si osservi in particolare il secondo livello del messaggio JCL0211 qui riportato perche' contiene una analisi dei flag di scelta.
Messaggio: ->Da trasferire 123 membri. Vedi secondo livello
Analisi delle ricorrenze dei "Selection Flag":
"Initial" "Forced" "Final".
Initial off 566
Initial on 123
Forced off 0
Forced on 0
Final off 566
Final on 123
Forced off <> Initial 0
Forced off = Initial 0 inutili
Forced on <> Initial 0
Forced on = Initial 0 inutili
| Top |
Messaggi *INFO e *COMP
Messaggi *DIAG seguiti da *ESCAPE CPF0001
| Top |