List embedded modules (JMOD)

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

Cmd JMOD List embedded modules > Lista moduli incorporati

www.neroni.it/NERONI2/JMOD.NERONI2.HTML

Elenca i moduli incorporati nei programmi ILE di una libreria.

Da un originale di Scott Klement del 07-05-1997 trovato al link www.think400.dk/apier_2.htm#eks0006

Top

Parameters

Keyword Description Choices Notes
LIB Library name Name Required, Positional 1
PGM Program name Generic name, name, *ALL Optional, Positional 2
PRINT Print *YES, *NO Optional, Positional 3
OUTFILE Output file Single values: *NONE
Other values: Qualified object name		 Optional, Positional 4
Qualifier 1: Output file Name
Qualifier 2: library Name, QTEMP
MBROPT Replace or add records *REPLACE, *ADD Optional, Positional 5
REFPGM Reference program for messages Name, *CPP Optional, Positional 6
Top

Library name (LIB) > Nome della libreria

Nome della libreria contenente programmi e programmi di servizio ILE dai quali estrarre le informazioni d'uso dei moduli.

Il valore e' obbligatorio.

Valori permessi:

nome-libreria
Il nome indicato viene usato per la libreria da esaminare.
Top

Program name (PGM) > Nome programma

Nome del programma dal quale estrarre le informazioni.

Valori permessi:

nome-programma
Il nome del programma da esaminare.
nome-programma-generico
Le iniziali del gruppo di programmi da esaminare.

Valori speciali:

*ALL
E' richiesto l'esame di tutti i programmi della libreria.
Top

Print (PRINT) > Stampa

Richiede la stampa dell'elenco.

Valori permessi:

*YES
E' richiesta la stampa dell'elenco.
*NO
Non e' richiesta la stampa dell'elenco.
Top

Output file (OUTFILE) - name > File di emissione - nome

Il nome individua il file fisico ricevente dei dati scaricati dal sistema tramite API.

Se il file di emissione manca, viene creato. Se esiste viene sostituito.

Valori permessi:

nome-file-di-emissione
Nome del file di emissione.

Valori singoli:

*NONE
Il file di emissione non e' richiesto.

Valori speciali:

JMOD1T
Esempio di nome per il file di emissione.

Output file (OUTFILE) - library > File di emissione - libreria

Nome della libreria in cui risiedera' il file di emissione.

Valori permessi:

nome-libreria-di-emissione
Il file di emissione verra' creato nella libreria richiesta.

Valori speciali:

QTEMP
Nome di default della libreria di emissione.
Top

Replace or add records (MBROPT) > Sostituisce o aggiunge record

Se richiesto il file di emissione, sceglie tra sostituzione e aggiunta record.

Valori permessi:

*REPLACE
E' richiesta la sostituzione del file di emissione.
*ADD
E' richiesta l'aggiunta di nuovi record al file di emissione.
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 JMOD List embedded modules

Esempio 1: Elenca i moduli contenuti nei programmi della libreria NERONI2

Si esegua il seguente comando: 

> JMOD LIB(NERONI2)
  JMOD LIB(NERONI2) PGM(*ALL) PRINT(*YES) OUTFILE(/*NONE)
    MBROPT(*REPLACE) REFPGM(JMODC)
  Stampata Lista moduli per libreria NERONI2.

La stampa e' visibile al link www.neroni.it/NERONI2/JMOD.pdf

Esempio 2: Come per esempio 1 ma con file di emissione

Si esegua il seguente comando: 

> JMOD LIB(NERONI2) OUTFILE(JMOD1T)
  JMOD LIB(NERONI2) PGM(*ALL) PRINT(*YES)
    OUTFILE(QTEMP/JMOD1T) MBROPT(*REPLACE) REFPGM(JMODC)
  Creata e stampata Lista moduli per libreria NERONI2
    in outfile QTEMP/JMOD1T.

Oltre alla stampa si esamini il file di emissione, ad esempio con il query estemporaneo: 

> RUNQRY QRYFILE((QTEMP/JMOD1T)) RCDSLT(*YES)

Esempio 3: Come per esempi 1 e 2 ma senza stampa

Si esegua il seguente comando: 

> JMOD LIB(NERONI2) PRINT(*NO) OUTFILE(JMOD1T)
  JMOD LIB(NERONI2) PGM(*ALL) PRINT(*NO)
    OUTFILE(QTEMP/JMOD1T) MBROPT(*REPLACE) REFPGM(JMODC)
  Creata Lista moduli per libreria NERONI2
    in outfile QTEMP/JMOD1T.

Si puo' esaminare il file di emissione con il query estemporaneo: 

> RUNQRY QRYFILE((QTEMP/JMOD1T)) RCDSLT(*YES)

Top

Messaggi informativi e di completamento

Messaggi *INFO e *COMP

JMDA001
JMOD LIB(&1) PGM(&2) PRINT(&3) OUTFILE(&4/&5) MBROPT(&6) REFPGM(&7)
JMD0121
Creata e stampata Lista moduli per libreria &1 in outfile &2/&3.
JMD0122
Stampata Lista moduli per libreria &1.
JMD0123
Creata Lista moduli per libreria &1 in outfile &2/&3.

Messaggi *STATUS

JMD0111
Lista moduli in corso per libreria &1

Messaggi di errore

Messaggi *DIAG seguiti da *ESCAPE CPF0001

JMD0101
Richiedi almeno un'emissione.
JMD0102
Il file di emissione &1/&2 deve preesistere.
Top