Compare libraries To (JCMPLIBT)

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

Cmd JCMPLIBT Compare libraries To > Compara librerie A

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

Colleziona informazioni da librerie "di destinazione" per comparazione librerie.

Note: I comandi JCMPLIBF "Compare libraries From" e JCMPLIBT "Compare libraries To" utilizzano lo stesso command processing program che prepara un file informativo sul contenuto di un gruppo di librerie. Il file informativo ricavato dal primo comando (librerie "From") verra' in seguito comparato con il file informativo ricavato dal secondo comando (librerie "To") tramite il comando conclusivo JCMPLIBP "Compare libraries Print".

Il file di emissione del presente comando ha il tracciato del DSPOBJD "Display Object Description" ma, mancando da questo outfile le informazioni sui sorgenti degli oggetti ILE, esse vengono reperite tramite i comandi JMOD "List embedded modules" e JMRG "Merge object info". Il record di object description che fotografa l'oggetto ile viene ripetuto piu' volte: ogni record programma dotato di moduli viene duplicato tante volte quanti sono i moduli referenziati dal programma stesso. Ogni record porta le informazioni sorgenti relative ad un solo modulo.

I campi completati per i programmi con moduli sono i seguenti.
CAMPI MODIFICATI        CAMPI DI PROVENIENZA MODIFICHE
SU DESCRIZIONE OGGETTI  DA DESCRIZIONE MODULI
----------------------- -----------------------------------
ODSRCF SourceFile       MOSRCF             SourceFile
ODSRCL SourceLibrary    MOSRCL             SourceLibrary
ODSRCM SourceMember     MOSRCM             SourceMember
ODSRCC ChgSourceCentury %subst(MOSRCD:1:1) ChgSourceCentury
ODSRCD ChgSourceDate    %subst(MOSRCD:2:6) ChgSourceDate
ODSRCT ChgSourceTime    %subst(MOSRCD:8:6) ChgSourceTime
ODUATR UserAttribute    MOATTR             ModuleAttribute

Per differenziare i file fisici sorgente dai file fisici dati il comando raccoglie l'informazione S=Source / D=Data da un display file description dei file fisici.

I campi completati per i file fisici sono i seguenti.
CAMPI MODIFICATI        CAMPI DI PROVENIENZA MODIFICHE
SU DESCRIZIONE OGGETTI  DA DESCRIZIONE *BASATR FILE FISICI
----------------------- ----------------------------------
ODDCEN DspDateCentury   ATDTAT File type: D=*DATA, S=*SRC

Top

Parameters

Keyword Description Choices Notes
TOLIB To libraries group Values (up to 2 repetitions): Name, *NONE Required, Positional 1
TOCOL To data collection outfile Qualified object name Optional, Positional 2
Qualifier 1: To data collection outfile Name, JCMPLIBTO
Qualifier 2: library Name, QTEMP
REFPGM Reference program for messages Name, *CPP Optional, Positional 3
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

To data collection outfile (TOCOL) - name > File emissione collezione dati destinazione - nome

Nome del file AS400 destinato a contenere la collezione dati dalle librerie "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:

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

To data collection outfile (TOCOL) - library > File emissione collezione dati destinazione - 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

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 JCMPLIBT Compare libraries To

Esempio 1: Genera collezione dati con nome e libreria di difetto

Restituisce nel file JCMPLIBTO della libreria QTEMP l'elenco degli oggetti presenti nelle librerie UFNEROTRE e UFNEROSEI completato con le informazioni sorgente riguardante i moduli ILE e con il tipo file quando si tratta di file fisici.

Con i soli parametri necessari:
   JCMPLIBT TOLIB(UFNEROTRE UFNEROSEI)
Anche con i parametri di default:
   JCMPLIBT TOLIB(UFNEROTRE UFNEROSEI)
            TOCOL(QTEMP/JCMPLIBTO) REFPGM(*CPP)

Questo comando permette di estrarre le info riguardanti gli oggetti delle librerie richieste nel file di emissione di default.

Esempio 2: Genera collezione dati nel file richiesto

Restituisce nel file SCIOPA della libreria UFNERONI l'elenco degli oggetti presenti nella libreria NERONI2 completato con le informazioni sorgente riguardante i moduli ILE e con il tipo file quando si tratta di file fisici.

   JCMPLIBT TOLIB(NERONI2) OUTFILE(UFNERONI/SCIOPA)

Questo comando permette di estrarre le info riguardanti gli oggetti della libreria richiesta nel file di emissione in una libreria diversa dalla temporanea e con un nome di fantasia.

Top

Messaggi informativi e di completamento

Messaggi *INFO e *COMP

JCLA002
JCMPLIBF FRMLIB(&1) FRMCOL(&2/&3) REFPGM(&4)
JCLA003
JCMPLIBT TOLIB(&1) TOCOL(&2/&3) REFPGM(&4)
JCL0191
Creato elenco oggetti con aggiunta di info moduli e tipo file fisici per librerie &1 in outfile &2/&3.
JCL0131
Creato elenco oggetti per libreria &1 in outfile &2/&3.
JCL0132
Creato elenco fisici per libreria &1 in outfile &2/&3.

Messaggi di stato

Messaggi *STATUS

JCL0111
Creazione elenco oggetti in corso per libreria &1
JCL0112
Creazione elenco file fisici in corso per libreria &1

Messaggi di errore

Messaggi *DIAG seguiti da *ESCAPE CPF0001

JCL0231
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
JCL0101
Libreria &1 per il file di emissione non esiste
JCL0102
Libreria &1 da esaminare non esiste
JCL0132
Creato elenco fisici per libreria &1 in outfile &2/&3.
Top