Compare libraries print (JCMPLIBP)

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

Cmd JCMPLIBP Compare libraries Print > Compara librerie Stampa

http://www.neroni.it/NERONI2/JCMPLIBP.NERONI2.HTML

Stampa la comparazione del contenuto di due librerie "di provenienza" (FROM) con il contenuto di due librerie "di destinazione" (TO)

Note: I comandi JCMPLIBF "Compare libraries From" e JCMPLIBT "Compare libraries To" preparano ciascuno un file informativo sul contenuto di un gruppo di librerie. Il file informativo ricavato dal primo comando (librerie "From") viene comparato con il file informativo ricavato dal secondo comando (librerie "To") tramite il presente comando conclusivo JCMPLIBP "Compare libraries Print".

Il comando corrente emette una stampa di comparazione del contenuto delle librerie indagate tramite i due comandi preparatori. Genera inoltre un file di emissione che contiene le stesse righe di dettaglio della stampa, disponibile per ulteriori indagini a cura dell'utente.

Top

Parameters

Keyword Description Choices Notes
FRMCOL From data collection Qualified object name Optional, Positional 1
Qualifier 1: From data collection Name, JCMPLIBFR
Qualifier 2: library Name, QTEMP
TOCOL To data collection Qualified object name Optional, Positional 2
Qualifier 1: To data collection Name, JCMPLIBTO
Qualifier 2: library Name, QTEMP
OUTFILE Compare libraries outfile Qualified object name Optional, Positional 3
Qualifier 1: Compare libraries outfile Name, JCMPLIBOT
Qualifier 2: library Name, QTEMP
FRMDAT Start date CYYMMDD Character value Optional, Positional 4
FRMTIM Start time HHMMSS Character value Optional, Positional 5
CMPCRI Criteria for comparison Values (up to 2 repetitions): *NONE, *CRTDAT, *SRCDAT Optional, Positional 6
REFPGM Reference program for messages Name, *CPP Optional, Positional 7
Top

From data collection (FRMCOL) - name > Collezione dati provenienza - nome

Nome del file AS400 contenente la collezione dati estratta dalle librerie di provenienza "From".

Il file scelto deve avere il tracciato uguale a quello del relativo prototipo.

Valori permessi:

JCMPLIBFR
Nome di difetto del file collezione di provenienza.
nome-file-di-provenienza
Il file collezione di provenienza ha il nome richiesto.

From data collection (FRMCOL) - library > Collezione dati provenienza - libreria

Nome della libreria in cui risiede il file collezione di provenienza.

Valori permessi:

QTEMP
Il file collezione di provenienza viene cercato in libreria temporanea.
nome-libreria
Il file collezione di provenienza viene cercato nella libreria richiesta.
Top

To data collection (TOCOL) - name > Collezione dati destinazione - nome

Nome del file AS400 contenente la collezione dati estratta dalle librerie di destinazione "To".

Il file scelto deve avere il tracciato uguale a quello del relativo prototipo.

Valori permessi:

JCMPLIBTO
Nome di difetto del file collezione di destinazione.
nome-file-di-destinazione
Il file collezione di destinazione ha il nome richiesto.

From data collection (FRMCOL) - library > Collezione dati destinazione - libreria

Nome della libreria in cui risiede il file collezione di destinazione.

Valori permessi:

QTEMP
Il file collezione di destinazione viene cercato in libreria temporanea.
nome-libreria
Il file collezione di destinazione viene cercato nella libreria richiesta.
Top

Compare libraries outfile (OUTFILE) - name > File emissione comparazione librerie - nome

Nome del file AS400 destinato a contenere l'esito della comparazione tra le librerie di provenienza "From" e quelle di destinazione "To".

Se il file di emissione preesiste, il suo tracciato deve essere uguale a quello del relativo prototipo, e solo allora viene cancellato e ricreato.

Valori permessi:

JCMPLIBOT
Nome di difetto del file di emissione.
nome-file-di-emissione
Il file di emissione prende il nome richiesto.

Compare libraries outfile (OUTFILE) - library > File emissione comparazione librerie - libreria

Nome della libreria in cui risiede il file di emissione.

Valori permessi:

QTEMP
Il file di emissione viene creato in libreria temporanea.
nome-libreria
Il file di emissione viene creato nella libreria richiesta.
Top

Start date CYYMMDD (FRMDAT) > Data di partenza

Data limite: si esaminano solo gli oggetti creati a partire dalla data-ora composta dal valore corrente e dal valore del parametro FRMTIM.

Per il confronto con la data-ora dei parametri si usa la data-ora dell'oggetto piu' recente del gruppo NomeOggetto-TipoOggetto-AttributoOggetto-MembroSorgente non importa di che libreria.

Valori permessi:

data-partenza
Nel formato CYYMMDD C=Century digit (0=1900 1=2000) YY=Year MM=Month DD=Day
data-in-bianco
Data-ora in bianco neutralizza l'effetto dei parametri FRDAT e FRMTIM
Top

Start time HHMMSS (FRMTIM) > Ora di partenza

Ora limite: si esaminano solo gli oggetti creati a partire dalla data-ora composta dal valore corrente e dal valore del parametro FRMDAT.

Per il confronto con la data-ora dei parametri si usa la data-ora dell'oggetto piu' recente del gruppo NomeOggetto-TipoOggetto-AttributoOggetto-MembroSorgente non importa di che libreria.

Valori permessi:

ora-partenza
Nel formato HHMMSS HH=Hour MM=Minute SS=Second
ora-in-bianco
Data-ora in bianco neutralizza l'effetto dei parametri FRDAT e FRMTIM
Top

Criteria for comparison (CMPCRI) > Criteri di comparazione

Il parametro permette di scegliere quali righe stampare in base ad un paio di criteri.

Se la lista e' completamente in bianco, non si operano scelte basate sui criteri qui richiedibili.

Se almeno un elemento e' valorizzato, si stampano solo i record che soddisfano uno dei criteri in elenco.

Valori permessi:

*CRTDAT
Si stampano le righe che hanno data-ora di creazione diversa tra libreria di provenienza e libreria di destinazione.
*SRCDAT
Si stampano le righe che hanno data-ora del sorgente diversa tra libreria di provenienza e libreria di destinazione.
*NONE
Il valore non significa un criterio ma equivale a blank e viene usato solo per superare il problema del passaggio della corrente lista da un comando all'altro.
Top

Reference program for messages (REFPGM) > Programma riferimento messaggi

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 in cascata 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:

nome-di-un-programma-in-lista-di-chiamata
Il nome di un programma presente nella lista di chiamata del lavoro 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 con il quale condivide il presente parametro.

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 e a sua volta chiama altri tool condividendo il presente parametro.

Top

Esempi d'uso del comando JCMPLIBP Compare libraries Print

Esempio 1: Confronta due librerie

Si esegue la sequenza di comandi.

Con i soli parametri necessari:
   JCMPLIBF FRMLIB(NERONI1)
   JCMPLIBT TOLIB(NERONI2)
   JCMPLIBP

Questa sequenza permette di confrontare il contenuto delle librerie richieste facendo uso dei default.

Esempio 2: Confronta due librerie

Si esegue la sequenza di comandi.

   JCMPLIBF FRMLIB(NERONI1) FRMCOL(BUTTA/PRIMO)
   JCMPLIBT TOLIB(NERONI2) TOCOL(BUTTA/SECONDO)
   JCMPLIBP FRMCOL(BUTTA/PRIMO) TOCOL(BUTTA/SECONDO)
     OUTFILE(BUTTA/TERZO)

Questa sequenza permette di confrontare il contenuto delle librerie richieste facendo uso di file di transito e di emissione che restano nella libreria di comodo.

Esempio 3: Confronta due librerie su data sorgente

Si cambia solo il comando di stampa dell'esempio 2.

   JCMPLIBP FRMCOL(BUTTA/PRIMO) TOCOL(BUTTA/SECONDO)
     OUTFILE(BUTTA/QUARTO) CMPCRI(*SRCDAT)

Questa sequenza permette di confrontare il contenuto delle librerie richieste sfruttando i dati gia' raccolti che vengono stampati per date sorgente disuguali.

Top

Messaggi informativi e di completamento

Messaggi *INFO e *COMP

JCLA004
JCMPLIBP FRMCOL(&1/&2) TOCOL(&3/&4) OUTFILE(&5/&6) FRMDAT(&7) FRMTIM(&8) CMPCRI(&9) REFPGM(&10)
JCL0491
Creato e stampato elenco di comparazione librerie. Vedi outfile &1/&2.

Messaggi di stato

Messaggi *STATUS

Nessun messaggio

Messaggi di errore

Messaggi *DIAG seguiti da *ESCAPE CPF0001

JCL0201
Libreria &1 della lista FROM non esiste
JCL0203
File FROM &1/&2 non ha il tracciato previsto &3
JCL0211
Libreria &1 della lista TO non esiste
JCL0212
File &1/&2 della lista TO non esiste
JCL0213
File TO &1/&2 non ha il tracciato previsto &3
JCL0232
Non esiste libreria &1 per file di emissione &2
JCL0233
File &1/&2 attributo &3 non e' fisico
JCL0234
File &1/&2 non ha il tracciato previsto &3
Top