Compare libraries From (JCMPLIBF)

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

Cmd JCMPLIBF Compare libraries From > Compara librerie Da

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

Colleziona informazioni da librerie "di provenienza" 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".

Note: Il comando JCMPLIBF "Compare libraries From" e' usato anche come generatore delle informazioni necessarie nel comando JRAS "Retrieve all sources" di valutazione e ricostruzione dell'insieme dei sorgenti degli oggetti presenti nel gruppo di librerie richiesto.

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
FRMLIB From libraries group Values (up to 2 repetitions): Name, *NONE Required, Positional 1
FRMCOL From data collection outfile Qualified object name Optional, Positional 2
Qualifier 1: From data collection outfile Name, JCMPLIBFR
Qualifier 2: library Name, QTEMP
REFPGM Reference program for messages Name, *CPP Optional, Positional 3
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

From data collection outfile (FRMCOL) - name > File emissione collezione dati provenienza - nome

Nome del file AS400 destinato a contenere la collezione dati dalle librerie "From".

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:

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

From data collection outfile (FRMCOL) - library > File emissione collezione dati provenienza - 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 JCMPLIBF Compare libraries From

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

Restituisce nel file JCMPLIBFR 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:
   JCMPLIBF FRMLIB(UFNEROTRE UFNEROSEI)
Anche con i parametri di default:
   JCMPLIBF FRMLIB(UFNEROTRE UFNEROSEI)
            FRMCOL(QTEMP/JCMPLIBFR) 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.

   JCMPLIBF FRMLIB(NERONI2) FRMCOL(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