Compare library list from jobd (JLLCMP)

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

Comando JLLCMP

Compare library list from jobd

Compara fino a 10 liste librerie da descrizioni lavori

Scarica le liste in un file da portare in excel in separata sede. Il file ha 10 colonne e contiene in ogni colonna la lista librerie presente sulla job description corrispondente.

Il comando e' nato per facilitare il confronto delle liste librerie che fanno parte di descrizioni lavoro diverse. Le liste librerie vengono fotografate in un file IFS in formato csv che puo' essere letto e manipolato con EXCEL.

Il comando riceve i nomi delle job description da confrontare.
Al termine dell'esecuzione emette due inviti.
Il primo a consultare il file di emissione su AS400.
   /**/RUNQRY QRYFILE((QTEMP/JLLCMP1T)) RCDSLT(*YES)
Il secondo a scaricare il file di emissione sull'IFS
del medesimo AS400.
   /**/JTOCSV FROMFILE(QTEMP/JLLCMP1T) RMVBLANK(*TRAILING)
Con un FTP chiamato da pc o se l'IFS e' definito come
disco PC, copia il file sul pc ed aprilo con Excel.
Non aprirlo direttamente su IFS con Excel perche'
normalmente l'apertura dura un tempo esagerato.

Top

Parameters

Keyword Description Choices Notes
JOBDFIRST First job description Qualified object name Required, Positional 1
Qualifier 1: First job description Name
Qualifier 2: library Name, *LIBL, *CURLIB
JOBDOTHER Other job descriptions Values (up to 9 repetitions): Qualified object name Required, Positional 2
Qualifier 1: Other job descriptions Name
Qualifier 2: library Name, *FIRSTLIB, *LIBL, *CURLIB
OUTFILE Output file Qualified object name Optional, Positional 3
Qualifier 1: Output file Name, JLLCMP1T
Qualifier 2: library Name, QTEMP
REFPGM Reference program for messages Name, *CPP Optional, Positional 4
Top

First job description (JOBDFIRST) - name

Nome della prima descrizione lavoro da confrontare.

Valore obbligatorio.

nome-descrizione-lavoro
Nome di una descrizione lavoro.

First job description (JOBDFIRST) - library

Nome della libreria in cui risiede la descrizione lavoro.

Valori permessi:

*LIBL
La descrizione lavoro viene cercata in lista librerie.
*CURLIB
La descrizione lavoro viene cercata nella libreria corrente.
nome-libreria
La descrizione lavoro viene cercata nella libreria richiesta.
Top

Other job descriptions (JOBDOTHER) - name

Nome della altre descrizioni lavoro da confrontare.

Fino a nove elementi, il primo obbligatorio.

nome-descrizione-lavoro
Nome di una descrizione lavoro.

Other job description (JOBDOTHER) - library

Nome della libreria in cui risiede la descrizione lavoro.

Valori permessi:

*FIRSTLIB
La descrizione lavoro viene cercata nella sressa libreria nella quale si trova la prima descrizione lavoro.
*LIBL
La descrizione lavoro viene cercata in lista librerie.
*CURLIB
La descrizione lavoro viene cercata nella libreria corrente.
nome-libreria
La descrizione lavoro viene cercata nella libreria richiesta.
Top

Output file (OUTFILE) - file

Nome del file fisico ricevente l'elenco comparativo delle librerie.

Non e' permesso il nome del prototipo "JLLCMP1".

Se il file di emissione preesiste rispetto alla richiesta corrente, per evitare la cancellazione di file estranei al comando, si verifica il level check del file che deve essere identico a quello del prototipo.

Valori permessi:

JLLCMP1T
Il file di emissione prende il nome di default JLLCMP1T.
nome-file-emissione
Il nome indicato viene usato per il file di emissione.

Output file (OUTFILE) - library

Nome della libreria in cui risiede il file fisico ricevente l'elenco comparativo delle librerie.

Valori permessi:

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

Reference program for messages (REFPGM)

Programma di riferimento dei messaggi.

La trappola permette di dare visibilita' a tutti i messaggi come se fossero spediti tutti dallo stesso programma, scelto tramite il presente parametro.

Valori permessi:

Nome del programma in lista di chiamata.
Il nome di un programma presente nella lista di chiamata del programma 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.

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.

Top

Esempi per JLLCMP

Esempio 1: Genera il file che permette di confrontare le liste librerie di tre job description.

Con i soli parametri necessari:
   JLLCMP JOBDFIRST(JOBDUNO) JOBDOTHER(JOBDDUE JOBDTRE)
Anche con i parametri di default:
   JLLCMP JOBDFIRST(JOBDUNO) JOBDOTHER(JOBDDUE JOBDTRE)
          OUTFILE(QTEMP/JLLCMP1T) REFPGM(*CPP)

Questo comando genera il file fisico QTEMP/JLLCMP1T che contiene l'immagine delle liste librerie comparate. Il comando genera un log di cui si riporta esempio visibile al meglio se la chiamata avviene dal video comandi QCMD.

> JLLCMP JOBDFIRST(JOBDUNO) JOBDOTHER(JOBDDUE JOBDTRE)
> /**/RUNQRY QRYFILE((QTEMP/JLLCMP1T)) RCDSLT(*YES)
> /**/JTOCSV FROMFILE(QTEMP/JLLCMP1T) RMVBLANK(*TRAILING)

I messaggi che iniziano con /**/ sono comandi non eseguiti ma duplicabili ed eseguibili per completare le attivita' di confronto preparate dal comando JLLCMP.

Tramite il RUNQRY il file puo' essere visionato estemporaneamente.

Jobd 01     Jobd 02     Jobd 03
library     library     library
JOBDUNO     JOBDDUE     JOBDTRE
NERONI2     NERONI2     NERONI2
----------  ----------  --------
QTEMP       QTEMP       QTEMP
NERONI1     NERONI2     NERONI1
NERONI2     NERONI8     NERONI2
NERONI3     NERONI4     NERONI3
NERONI4     NERONI1     NERONI4
NERONI5     QGPL        NERONI6
QGPL                    NERONI7
                        NERONI8
                        QGPL

Tramite il comando JTOCSV, il file puo' essere scaricato sotto forma di csv su un indirizzario IFS.

Con un FTP o se l'IFS e' definito come disco pc, lo scarico puo' essere portato su pc e da li' aperto con EXCEL.

Top

Messaggi errore per JLLCMP

Messaggi *DIAG seguiti da *ESCAPE CPF0001

Durante esecuzione

JLC0101
->Per il file di emissione e' vietato il nome del prototipo &1
JLC0102
->Non esiste la libreria di emissione &1
JLC0103
->Il file di emissione &2/&1 ha tracciato imprevisto
JLC0104
->Descrizione lavoro &2 non esiste in libreria &1
JLC0105
->Jobd &2/&1 Libl in bianco e percio' errata
Top