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

https://www.neroni.it/NERONI2/JWAJ.NERONI2.HTML

Scarica in un file di emissione l'elenco dei lavori attivi completo o scegliendo per tipo, nome, utente lavoro e utente corrente.

L'elenco lavori ottenuto senza fare uso dei quattro parametri di parzializzazione 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.

L'elenco lavori ottenuto facendo uso dei parametri di parzializzazione li soddisfa invece tutti in relazione "and".

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 da materiale di Carsten Flensburg recuperato al link

https://apimymymy.wordpress.com

Una successiva verifica (16-11-2019) del link non ha permesso di ritrovare tale materiale ma solo info similari.

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
CURUSR Current user Generic name, name, *ALL Optional, Positional 4
OUTFILE Output file Qualified object name Optional, Positional 5
Qualifier 1: Output file Name, JWAJT
Qualifier 2: in library Name, QTEMP
REFPGM Reference program for messages Name, *CPP Optional, Positional 6
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 lavoro dei lavori attivi da elencare.

Valori permessi:

nome-utente
Solo i lavori con l'utente lavoro richiesto e che soddisfano le altre scelte saranno elencati.
nome-utente-generico
Solo i lavori con l'utente lavoro 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 lavoro.
Top

Current user (CURUSR) > Utente corrente

Nome utente corrente dei lavori attivi da elencare.

Valori permessi:

nome-utente
Solo i lavori con l'utente corrente richiesto e che soddisfano le altre scelte saranno elencati.
nome-utente-generico
Solo i lavori con l'utente corrente 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 corrente.
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 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, preferibilmente 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 JWAJ Work active jobs outfile

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, con tutti i default:
> JWAJ TYPE(*) JOBNAM(*ALL) JOBUSR(*ALL) CURUSR(*ALL)
    OUTFILE(QTEMP/JWAJT) REFPGM(*CPP)
  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 del comando JWAJ Work active jobs outfile

Messaggi di rilascio nel comando

Messaggi informativi

Messaggi di completamento

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

Messaggi di stato

Messaggi diagnostici seguiti da rilascio

Top