Compare libraries Global (JCMPLIB)

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

Cmd JCMPLIB Compare libraries Global > Compara librerie Globale

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

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

Note: Il comando corrente puo' sostituire la sequenza dei comandi JCMPLIBF "Compare libraries From" JCMPLIBT "Compare libraries To" JCMPLIBP "Compare libraries Print" quando tutte le librerie esaminate si trovano sulla stesso AS400.

Il dettaglio delle funzioni svolte e' desumibile dai testi d'aiuto dei tre comandi menzionati.

Top

Parameters

Keyword Description Choices Notes
FRMLIB From libraries group Values (up to 2 repetitions): Name, *NONE Required, Positional 1
TOLIB To libraries group Values (up to 2 repetitions): Name, *NONE Required, Positional 2
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 library group (FRMLIB) > Gruppo librerie di provenienza

Elenco delle librerie dalle quali estrarre informazioni.

Valori permessi:

nome-libreria
E' obbligatorio almeno un valore.
Top

To library group (TOLIB) > Gruppo librerie di destinazione

Elenco delle librerie dalle quali estrarre informazioni.

Valori permessi:

nome-libreria
E' obbligatorio almeno un valore.
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 JCMPLIB Compare libraries Global

Esempio 1: Confronta due librerie

Si esegue il comando.

Con i soli parametri necessari:
   JCMPLIB FRMLIB(NERONI1) TOLIB(NERONI2)

Questo comando permette di confrontare il contenuto delle librerie richieste facendo uso dei default.

Esempio 2: Confronta due librerie

Si esegue il comando.

   JCMPLIB FRMLIB(NERONI1) TOLIB(NERONI2)
     OUTFILE(BUTTA/TERZO)

Questo comando permette di confrontare il contenuto delle librerie richieste facendo uso di file di emissione che resta nella libreria di comodo.

Esempio 3: Confronta due librerie su data sorgente

Si aggiunge il criterio di comparazione nell'esempio 2.

   JCMPLIB FRMLIB(NERONI1) TOLIB(NERONI2)
     OUTFILE(BUTTA/QUARTO) CMPCRI(*SRCDAT)

Questo comando permette di confrontare il contenuto delle librerie richieste per date sorgente disuguali.

Top

Messaggi rilanciati

Tutti i messaggi previsti dai comandi JCMPLIBF JCMPLIBT JCMPLIBP

Messaggi informativi e di completamento

Messaggi *INFO e *COMP

JCLA001
JCMPLIB FRMLIB(&1) TOLIB(&2) OUTFILE(&3/&4) FRMDAT(&5) FRMTIM(&6) CMPCRI(&7) REFPGM(&8)

Messaggi di stato

Messaggi *STATUS

Nessun messaggio

Messaggi di errore

Messaggi *DIAG seguiti da *ESCAPE CPF0001

JCL0102
Libreria &1 da esaminare non esiste
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