| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
Imposta nel lavoro corrente la lista librerie recuperata da una descrizione lavoro.
Oltre a questa funzione principale, il presente comando permette di listare le descrizioni lavoro utilizzabili e anche di testare l'eseguibilita' delle relative liste librerie.
Quando richieste le liste con RUNTYPE(*LIST) o RUNTYPE(*TEST), il comando, per visualizzare la lista generata, usa dei messaggi informativi in log al programma chiamante ma sopprime ogni altro messaggio per pulire il log che, se presentato tramite RDI, risulterebbe poco leggibile. Infatti RDI visualizza il log dei comandi eseguiti per suo tramite in un solo modo molto simile alla stampa del log al massimo dettaglio possibile.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JOBD | Job description | Single values: *SYSVAL Other values: Qualified object name |
Optional, Positional 1 |
| Qualifier 1: Job description | Generic name, name, *ALL | ||
| Qualifier 2: library | Name, *LIBL, *USRLIBL, *CURLIB, *ALL, *ALLUSR | ||
| RUNTYPE | Run type | *EXEC, *LIST, *TEST | Optional, Positional 2 |
| OMITLOST | Omit lost libraries | *NO, *YES | Optional, Positional 3 |
| LOG | Messages in log | *NO, *YES | Optional, Positional 4 |
| DTAARA | Service data area | Single values: *NONE Other values: Qualified object name |
Optional, Positional 5 |
| Qualifier 1: Service data area | Name, JLIBL, JBDLBLARA | ||
| Qualifier 2: library | Name, QTEMP | ||
| REFPGM | Reference program for messages | Name, *CPP | Optional, Positional 6 |
| Top |
Solo per RUNTYPE(*EXEC), nome della descrizione lavoro dalla quale prelevare la lista librerie utente da imporre nel lavoro corrente.
Solo per RUNTYPE diverso da *EXEC, nome o nome generico delle descrizioni lavoro da listare o testare.
Valori singoli:
Valori permessi:
Valori speciali:
Nome della libreria in cui risiede la descrizione lavoro.
Valori permessi:
Valori speciali:
Valori speciali solo per RUNTYPE diversi da *EXEC:
| Top |
Tipo di run: Esecuzione, Lista o Test.
Valori permessi:
| Top |
Solo per "RUNTYPE(*EXEC) OMITLOST(*YES)", omette dalla lista librerie le librerie in errore (mancanti o non autorizzate).
Valori permessi:
| Top |
Il parametro permette di regolare il livello di log durante l'esecuzione.
Non vengono mai soppressi i messaggi usati come righe delle liste richieste con RUNTYPE(*LIST) o RUNTYPE(*TEST).
Valori permessi:
| Top |
Solo per RUNTYPE(*EXEC), nome delle aree dati nelle quali viene fotografata la lista librerie imposta al lavoro corrente. Da creare o da aggiornare se gia' esistenti.
La lista e' di 250 librerie. I primi 200 elementi vengono ospitati nell'area dati col nome assegnato. I rimanenti 50 in una seconda area dati con nome composto dal nome assegnato piu' il carattere "2".
Il testo di entrambe viene composto riunendo nome e libreria della descrizione lavoro datrice della lista librerie utilizzata nel run.
Valori singoli:
Valori permessi:
Nome della libreria in cui risiedono le aree dati da creare o da aggiornare.
Valori permessi:
| Top |
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:
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:
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 |
Esempio zero: Descrizioni lavoro di prova.
Date per esistenti le librerie TEST, ONE, TWO e THREE, si creano tre descrizioni lavoro nella libreria TEST.
Si riportano comandi e log.
> CRTJOBD JOBD(TEST/TEST1) TEXT('Test1 JLIBL cmd')
INLLIBL(QTEMP ONE TWO THREE QGPL)
La coda lavori QBATCH e' stata trovata nella libreria QGPL.
Descrizione lavoro TEST1 creata nella libreria TEST.
> CRTJOBD JOBD(TEST/TEST2) TEXT('Test2 JLIBL cmd')
INLLIBL(QTEMP TWO ONE THREE QGPL)
La coda lavori QBATCH e' stata trovata nella libreria QGPL.
Descrizione lavoro TEST2 creata nella libreria TEST.
> CRTJOBD JOBD(TEST/TEST3) TEXT('Test3 JLIBL cmd')
INLLIBL(QTEMP LOST ONE TWO THREE QGPL)
La coda lavori QBATCH e' stata trovata nella libreria QGPL.
Non e' stata trovata la libreria LOST nell'elenco iniziale
delle librerie di ricerca.
E' stata creata la descrizione del lavoro TEST3, ma
esistono dei messaggi di avvertimento.
Esempio 1: Elenca le descrizioni lavoro presenti nella libreria TEST.
> JLIBL JOBD(TEST/*ALL) RUNTYPE(*LIST) JLIBL JOBD(TEST/TEST1) /*^Test1 JLIBL cmd*/ JLIBL JOBD(TEST/TEST2) /*^Test2 JLIBL cmd*/ JLIBL JOBD(TEST/TEST3) /*^Test3 JLIBL cmd*/
Esempio 2: Elenca le descrizioni lavoro presenti nella libreria TEST evidenziando la validita' delle liste librerie corrispondenti.
> JLIBL JOBD(TEST/*ALL) RUNTYPE(*TEST) JLIBL JOBD(TEST/TEST1) /*ok^Test1 JLIBL cmd*/ JLIBL JOBD(TEST/TEST2) /*ok^Test2 JLIBL cmd*/ JLIBL JOBD(TEST/TEST3) /*ER^Test3 JLIBL cmd*/
Esempio 3: Imposta nel lavoro corrente la lista librerie presente sulla descrizione lavoro TEST1.
> JLIBL JOBD(TEST/TEST1) Jobd TEST/TEST1 Libl QTEMP ONE TWO THREE QGPL
Esempio 4: Tenta di impostare nel lavoro corrente la lista librerie presente sulla descrizione lavoro TEST3 ma riceve rifiuto per mancanza della libreria LOST.
> JLIBL JOBD(TEST/TEST3)
Libreria LOST non esiste.
Jobd TEST/TEST3 errore su Libl QTEMP LOST ONE TWO
THREE QGPL
Nel comando JLIBL e' stato trovato un errore.
Esempio 5: Imposta nel lavoro corrente la lista librerie presente sulla descrizione lavoro TEST3 scegliendo di omettere le librerie assenti.
> JLIBL JOBD(TEST/TEST3) OMITLOST(*YES) Libreria LOST non esiste. Jobd TEST/TEST3 Libl QTEMP ONE TWO THREE QGPL
Esempio 6: Imposta nel lavoro corrente la lista librerie presente sulla descrizione lavoro TEST2 scegliendo di creare le aree dati di servizio in QTEMP.
> JLIBL JOBD(TEST/TEST2) DTAARA(JBDLBLARA) Jobd TEST/TEST2 Libl QTEMP TWO ONE THREE QGPL
Visualizzando il contenuto della prima area dati di servizio si ottiene quanto segue.
Area dati . . . . . . . : JBDLBLARA Libreria . . . . . . : QTEMP Tipo . . . . . . . . . : *CHAR Lunghezza . . . . . . . : 2000 Testo . . . . . . . . . : TEST2 TEST Valore *...+....1....+....2....+....3....+....4....+....5 'QTEMP TWO ONE THREE QGPL '
Si osservano nome e libreria della descrizione lavoro nel testo dell'area dati.
| Top |
Messaggi *INFO e *COMP
Messaggi *DIAG seguiti da *ESCAPE CPF0001
| Top |