Archives old log (JOLDLOG)

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

Comando JOLDLOG

Archives old log

Archivia un vecchio log stampato

Trascrive in un file fisico le stampe di log di un lavoro preferibilmente gia' concluso.

Derivato dal comando JLOG che fa lo stesso recupero di log sul lavoro in cui viene eseguito.

Richiede che il lavoro in esame abbia stampato il log, anche se su stampe multiple, e che le stampe siano ancora presenti come spool file sul sistema.

Recuperandolo dalle stampe, archivia in un file fisico una copia della stampa del log del lavoro richiesto.

L'archiviazione parte dalla riga di richiesta che precede la riga ove giace l'ultima ricorrenza della stringa contenuta nel parametro FROMTAG e arriva fino alla fine del log disponibile su stampa.

La costante di identificazione della riga di richiesta e' esplicitata nel parametro RQSID al solo scopo di permettere l'uso del comando JOLDLOG anche in altri release e in altre lingue.

A fine recupero, emette un promemoria di invito ad eseguire un DSPPFM (Display phisical file member) per esaminare il log trascritto traendo beneficio dalla ricerca case insensitive di tale visualizzazione.

Le stampe di log del lavoro possono essere una o molte. Alla fine di ogni stampa di log trascritta nel file fisico di emissione viene inserita una riga di separazione che inizia con:

"<<<>>>-<<<>>> <<<>>> <<<>>> ".

Top

Parameters

Keyword Description Choices Notes
JOB Job name Single values: *
Other values: Qualified job name
Required, Positional 1
Qualifier 1: Job name Name
Qualifier 2: Job user Name
Qualifier 3: Job number 000001-999999, '      '
FROMTAG From tag in log Character value, JOLDLOGFRM Optional, Positional 2
RQSID Request ide in printed log Character value, 'Richiesta' Optional, Positional 3
OUTFILE Output file Qualified object name Optional, Positional 4
Qualifier 1: Output file Name, JOLDLOGT
Qualifier 2: Library Name, QTEMP
Top

Job (JOB) - name

Nome del lavoro. Obbligatorio.

Valori permessi:

nome-lavoro
Nome del lavoro di cui si vuole ottenere la trascrizione del log.
*
Il lavoro e' quello corrente.

Job (JOB) - user

Utente del lavoro.

Valori permessi:

nome-utente
Nome dell'utente del lavoro di cui si vuole ottenere la trascrizione del log.

Job (JOB) - number

Numero del lavoro.

Valori permessi:

numero-lavoro
Numero del lavoro di cui si vuole ottenere la trascrizione del log.
Top

From tag in log (FROMTAG)

Etichetta di partenza della trascrizione del log.

L'etichetta da cercare nel log da trascrivere per identificare la riga di partenza della trascrizione. I caratteri cercati sono i primi dieci della trascrizione nel log di un testo messaggio.

Se l'etichetta non vieve trovata nel log, la trascrizione e' totale.

Se l'etichetta e' presente piu' volte nel log, la trascrizione inizia dall'ultima ricorrenza.

Valori permessi:

etichetta
Stringa di caratteri da cercare.

Valori speciali:

JOLDLOGFRM
Valore da cercare.
Top

Request ide in printed log (RQSID)

Identificazione dei messaggi di richiesta nel log.

Valori permessi:

stringa
Stringa di caratteri che identifica le righe che portano i messaggi di richiesta presenti nel log.

Valori speciali:

'Richiesta'
Valore da cercare.
Top

Output file (OUTFILE) - file

Nome del file in cui scaricare il log trascritto.

Il file eventualmente preesistente viene cancellato e ricreato.

Valori permessi:

nome-file
Nome del file in cui scaricare il log trascritto.

Valori speciali:

JOLDLOGT
Nome di difetto del file in cui scaricare il log trascritto.

Output file (OUTFILE) - library

Nome della libreria del file in cui scaricare il log trascritto.

Valori permessi:

nome-libreria
Il file contenente il log trascritto si trova nella libreria richiesta.

Valori speciali:

QTEMP
La libreria temporanea del lavoro.
Top

Esempi per JOLDLOG

Esempio 1: Trascrive in un file fisico il log di un lavoro.

Si riportano comandi e log.

> JOLDLOG JOB(231329/UFNERONI/JCMPLIB.)
> /**/DSPPFM FILE(QTEMP/JOLDLOGT)

Anche con i parametri di default:

> JOLDLOG JOB(231329/UFNERONI/JCMPLIB.) FROMTAG(JOLDLOGFRM)
    RQSID('Richiesta') OUTFILE(QTEMP/JOLDLOGT)
> /**/DSPPFM FILE(QTEMP/JOLDLOGT)

Questo comando esegue la trascrizione nel file fisico il log del lavoro richiesto e propone un comando per la visualizzazione e la scansione del log trascritto.

Top

Messaggi informativi e di completamento

Messaggi *INFO, *COMP e *STATUS

JLG0002
Archivia il log dopo l'ultima label &1

Messaggi di errore

Messaggi *DIAG seguiti da *ESCAPE CPF0001

JLG0001
Nome &1 per file di output non e' permesso.
Top