Work active jobs outfile (JWAJ)

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

Cmd JWAJ Work active jobs outfile > Elenca lavori attivi

Scarica in un file di emissione l'elenco dei lavori attivi completo o permettendo la scelta di tipo, nome e utente.

Il file di emissione ha una corrispondenza riga per riga con l'elenco video ottenibile dalla contemporanea esecuzione del comando WRKACTJOB "Work with active jobs", dopo la scelta F14=Include.

Il reperimento dell'elenco avviene tramite le API di sistema a cio' delegate. In particolare la QGYOLJOB "Open List of Jobs".

Il programma di interfaccia verso l'API e' stato ricavato dal materiale oggi recuperabile al link https://apimymymy.wordpress.com di Carsten Flensburg.

Top

Parameters

Keyword Description Choices Notes
TYPE Job type *, A, B, I, M, R, S, W, X Optional, Positional 1
JOBNAM Job name Generic name, name, *ALL Optional, Positional 2
JOBUSR Job user Generic name, name, *ALL Optional, Positional 3
OUTFILE Output file Qualified object name Optional, Positional 4
Qualifier 1: Output file Name, JWAJT
Qualifier 2: in library Name, QTEMP
REFPGM Reference program for messages Name, *CPP Optional, Positional 5
Top

Job type (TYPE) > Tipo lavoro

Tipo dei lavori attivi da elencare.

Valori permessi:

*
Saranno elencati tutti i tipi di lavoro.
A
Saranno elencati solo i lavori di autostart.
B
Saranno elencati solo i lavori batch.
I
Saranno elencati solo i lavori interattivi.
M
Saranno elencati solo i lavori monitor di sottosistema.
R
Saranno elencati solo i lavori di spool di lettura.
S
Saranno elencati solo i lavori di sistema.
W
Saranno elencati solo i lavori di spool di scrittura.
X
Saranno elencati solo i lavori di sistema SCPF.
Top

Job name (JOBNAM) > Nome lavoro

Nome dei lavori attivi da elencare.

Valori permessi:

nome-lavoro
Solo i lavori col nome richiesto e che soddisfano le altre scelte saranno elencati.
nome-lavoro-generico
Solo i lavori col nome generico richiesto e che soddisfano le altre scelte saranno elencati.

Valori speciali:

*ALL
Tutti i lavori che soddisfano le altre scelte saranno elencati a prescindere dal nome lavoro.
Top

Job user (JOBUSR) > Utente lavoro

Nome utente dei lavori attivi da elencare.

Valori permessi:

utente-lavoro
Solo i lavori con l'utente richiesto e che soddisfano le altre scelte saranno elencati.
utente-generico
Solo i lavori con l'utente generico richiesto e che soddisfano le altre scelte saranno elencati.

Valori speciali:

*ALL
Tutti i lavori che soddisfano le altre scelte saranno elencati a prescindere dal nome utente.
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 speciali:

JWAJT
Nome di default del 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

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, direttamente o indirettamente, 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.

*PRV
Il valore *PRV viene sostituito con il nome del programma chiamante del programma corrente.

ATTENZIONE: Il valore *PRV e' previsto solo in qualche comando di ultimo livello allo scopo di renderne comoda la chiamata in un contesto non strutturato come detto sopra. Per sapere se uno specifico comando utilizza il valore *PRV, consultare l'elenco dei valori permessi premendo F4 sul parametro REFPGM.

Top

Esempi d'uso

Esempio 1: Scarica l'elenco di tutti i lavori attivi sul sistema

Si chiama il comando senza parametri o con tutti i default e si ottiene il seguente log.

> JWAJ
oppure:
> JWAJ TYPE(*) JOBNAM(*ALL) JOBUSR(*ALL)
    OUTFILE(QTEMP/JWAJT)
  Creato in QTEMP/JWAJT l'elenco dei lavori attivi
    di tipo "*"
> /**/RUNQRY QRYFILE((QTEMP/JWAJT)) RCDSLT(*YES)

Si osservi il messaggio di invito alla visualizzazione del risultato.

Esempio 2: Scarica nel file INTER l'elenco dei lavori attivi e interattivi dell'utente NERONI

Si chiama il comando e si ottiene il seguente log.

> JWAJ TYPE(I) JOBUSR(NERONI) OUTFILE(INTER)
  Creato in QTEMP/INTER l'elenco dei lavori attivi
    di tipo "I"
> /**/RUNQRY QRYFILE((QTEMP/INTER)) RCDSLT(*YES)

Si riporta uno stralcio del query che si ottiene eseguendo il messaggio di invito alla visualizzazione del risultato.

List Job    Job    Job    Job Job Job     Actv Job
sequ name   user   number typ sub status  stat pty
   1 N1NERO NERONI 595306  I      *ACTIVE DSPW  5
   2 N2NERO NERONI 595307  I      *ACTIVE RUN   5
Run Enter   Enter  Current Submitter Submitter Submtr
pty date    time   user     name      user     number
20  1170711 100609 NERONI
20  1170711 100726 NERONI

Top

Messaggi informativi e di completamento

Messaggi *INFO e *COMP

JWA0191
Creato in &1/&2 l'elenco dei lavori attivi di tipo "&3"

Messaggi di errore

Messaggi *DIAG seguiti da *ESCAPE CPF0001

Nessun messaggio specifico previsto.

Top