Configurazione di un'attività di registrazione

L'attività di registrazione deve essere eseguita sulla stessa immagine del gestore code di coordinamento. È possibile accedere a Db2®.

Creazione di un'attività di registrazione

Copiare il PDSE per rendere il PDSE specifico del programma di registrazione. Ad esempio, user.MFT.LOGGER.

Se è necessario utilizzare un file di credenziali diverso, crearne uno. Consultare Configuring MQMFTCredentials.xml on z/OS®.

Recensione del membro BFGCUSTM. Si noti che gran parte del contenuto rimane lo stesso della personalizzazione precedente.

Tuttavia, è necessario:

Modificare // SYSEXEC DD DSN=SCEN.FTE.JCL....
Modificare LIBRARY in modo che corrisponda al PDSE agent
Modificare QMGR con il nome del gestore code di coordinamento
Rendi TIPO_SERVIZIO=LOGGER
Modificare NAME in modo che sia il nome del programma di registrazione (corrispondente al PDSE)
Esaminare JOBCARD e modificare il nome lavoro in modo che sia diverso dai nomi lavoro degli agent.
Esamina BFG_JVM_PROPERTIES="-Xmx1024M"

Se si utilizza il programma di registrazione Db2 , è utile creare un file, in modo da poter catturare le tracce Db2 per identificare i problemi Db2 .

Il nome del file viene specificato nelle proprietà JVM, in cui il file delle proprietà di traccia JDBC ha il contenuto come

db2.jcc.traceDirectory=/u/johndoe/fte
db2.jcc.traceFile=jccTrace1
db2.jcc.traceFileAppend=false
# turn on all traces
# db2.jcc.traceLevel=-1
# turn off all traces
db2.jcc.traceLevel=0

Imposta due proprietà JVM

BFG_JVM_PROPERTIES=-Ddb2.jcc.propertiesFile=/u/.../sql.properties
-Ddb2.jcc.ssid=DBCA

Dove /u/.../sql.properties è il nome del file delle proprietà di traccia Db2 e DBCA è il nome del sottosistema Db2 .

Inoltrare questo lavoro, notando che il lavoro richiede accesso esclusivo al dataset. I lavori per l'agent hanno tutti nomi come BFGLG*.

Registrazione nei file

Per ulteriori informazioni sulla registrazione in Db2, consultare Creazione di un'attività di registrazione, quando si accede a Db2

Ridenominare il membro BFGLGCRS. Questo lavoro aggiorna i file nella directory Managed File Transfer (MFT) e utilizza CSQUTIL per creare code specifiche dell'agente nel gestore code locale.

Il file originale ha il comando %BFGCMD CMD=fteCreateLogger -h che elenca la sintassi del comando.

Per creare il task logger, commentare %BFGCMD CMD=fteCreateLogger -h mettendo /* davanti all'istruzione, assicurandosi che la colonna uno sia vuota.

Rimuovere i commenti dal secondo comando e configurare le istruzioni. Ad esempio:

%BFGCMD CMD=fteCreateLogger   +
-p MQPH     +
-loggerQMgr MQPH      +
-loggerType FILE        +
-fileLoggerMode circular    +
-fileSize 5MB +
-fileCount 5 +
-p MQPH +
-credentialsFile //'<MFTCredentialsDataSet(MemberName)>'
LOGGER

Controllare l'output per verificare che sia stato elaborato correttamente.

Suggerimento: copiare il nome percorso del file logger.properties dall'output del lavoro a un membro nel PDSE dell'agente.

Ad esempio, copia nel membro APATH

/u/user_ID/fte/wmqmft/mqft/config/MQPH/loggers/LOGGER/logger.properties

Ciò è utile se è necessario visualizzare il file delle proprietà.

Aggiungere la directory a questo file:

/u/user_ID/fte/wmqmft/mqft/logs/MQPH/loggers/LOGGER/

Se si sta effettuando l'accesso al file, i file di log vengono memorizzati in questa directory, ad esempio LOGGER0-20140522123654897.log.

I file di traccia si trovano nella sottodirectory di log, ad esempio

/u/user_ID/fte/wmqmft/mqft/logs/MQPH/loggers/LOGGER/logs

È ora possibile avviare l'attività di registrazione.

Creazione di un'attività di registrazione, quando si accede a Db2

Ridenominare il membro BFGLGCRS.

Questo lavoro aggiorna i file nella directory MFT e utilizza CSQUTIL per creare code specifiche dell'agente nel gestore code locale.

Devi sapere:

Tabella 1. Db2 variabili
Nome Db2	Esempio
`-dbName databaseName`	È possibile ottenere tale valore dal valore di posizione nel messaggio DSNL004I per il proprio sottosistema Db2
`- dbDriver filePath`	Ad esempio /db2/db2v10/jdbc/classes/db2jcc.jar
`-dbLib filePath`	Ad esempio /db2/db2v10/jdbc/lib/libdb2jcct2zos_64.so

Modifica il file. Il file originale ha il comando %BFGCMD CMD=fteCreateLogger -h che elenca la sintassi del comando.

Rimuovere i commenti dal secondo comando e configurare le istruzioni. Per esempio

%BFGCMD CMD=fteCreateLogger   +
-p MQPH     +
-loggerQMgr MQPH      +
-loggerType DATABASE      +
-dbType DB2           +
-dbName DSNDBCP         +
-dbDriver /db2/db2v10/jdbc/classes/db2jcc.jar  +
-dbLib /db2/db2v10/jdbc/lib/            +
-credentialsFile //'<MFTCredentialsDataSet(MemberName)>' +
LOGGER

Per creare il task logger, commentare %BFGCMD CMD=fteCreateLogger -h mettendo /* davanti all'istruzione, assicurandosi che la colonna uno sia vuota.

Inoltrare il lavoro e controllare l'output per verificare che sia stato elaborato correttamente.

Suggerimento: copiare il nome percorso del file logger.properties dall'output del lavoro a un membro nel PDSE degli agent.

Ad esempio, copiare nel membro APATH:

/u/user_ID/fte/wmqmft/mqft/config/MQPH/loggers/LOGGER/logger.properties into member USS

Ciò è utile se è necessario visualizzare il file delle proprietà

I file di traccia si trovano nella sottodirectory di log, ad esempio:

/u/user_ID/fte/wmqmft/mqft/logs/MQPH/loggers/LOGGER/logs

Creazione di tabelle Db2

È necessario creare le tabelle Db2 . Le definizioni si trovano nel z/OS UNIX System Services file mqft/sql/ftelog_tables_zos.sql.

Creare un membro Db2 nel PDSE. Modificare questo membro ed utilizzare il comando COPY sulla riga comandi. Copiare dal file di definizione z/OS UNIX System Services .

Poiché i requisiti specifici del sito possono variare notevolmente, questo file specifica solo le strutture di base delle tabelle e un tablespace in cui si trovano.

Lo spazio tabella viene specificato, mediante lo script SQL, per garantire che venga creato utilizzando un pool di buffer con una dimensione di pagina sufficiente a contenere le righe di tabelle più grandi possibili. Notare che gli attributi come le ubicazioni LOB e così via non vengono specificati.

L'amministratore del database potrebbe voler modificare una copia di questo file, per definire questi attributi relativi alle prestazioni.

Questo file presuppone inoltre un nome schema predefinito di FTELOG, un nome tablespace predefinito di FTELOGTSe un nome database FTELOGDB. È possibile modificare questi nomi se necessario, in modo che corrispondano a un database esistente e a qualsiasi convenzione di denominazione locale, seguendo il processo descritto nei commenti all'inizio del file.

Importante: utilizzare le funzioni in linea come SPUFI per eseguire i comandi, poiché ci sono commenti nel file e i programmi batch come DSNTINAD non accettano commenti.

Per ulteriori informazioni, vedere Esecuzione di SQL tramite SPUFI. Inoltre, CSQ45STB in SCSQPROC dispone di un JCL di esempio che è possibile personalizzare per eseguire i comandi Db2 SELECT.

Avvio dell'attività del programma di registrazione

Ridenominare, rivedere e inoltrare il membro BFGLGST. Si dovrebbe ricevere il messaggio BFGDB0023I: il programma di registrazione ha completato attività di avvio ed è ora in esecuzione.

Operazioni logger

Per visualizzare lo stato del programma di registrazione, ridenominare, esaminare e inoltrare il membro BFGLGSH

Per arrestare il programma di registrazione, rinominare, rivedere e inoltrare il membro BFGLGSP.