fteShowAgentDetails (visualizza i dettagli dell'agente 'MFT )
Utilizzare il comando fteShowAgentDetails per visualizzare i dettagli di uno specifico Managed File Transfer Agent. Questi sono i dettagli memorizzati dal gestore code di coordinamento Managed File Transfer dell'agente.
Finalità
È possibile eseguire il comando fteShowAgentDetails da qualsiasi sistema che può connettersi al gestore code di coordinamento. Questo comando utilizza il file coordination.properties per connettersi al gestore code di coordinamento.
Specificare il parametro facoltativo -p per questo comando solo se si desidera utilizzare una serie di opzioni di configurazione diverse dalla serie predefinita. Per ulteriori informazioni, consultare Opzioni di configurazione.
Le informazioni sullo stato dell'agent prodotte da questo comando vengono generate dai messaggi di stato pubblicati dall'agent nel SISTEMA SYSTEM.FTE . Questi messaggi sono descritti in Formato del messaggio di stato dell'agent MFT. Le informazioni sullo stato prodotte dal comando fteShowAgentDetails forniscono lo stato dell'agent al momento della pubblicazione dell'ultimo messaggio di stato. La frequenza di questi messaggi di stato dipende dal valore della proprietà agentStatusPublishRateLimit . Per ulteriori informazioni, consultare Il file MFT agent.properties.
Per IBM® WebSphere® MQ 7.5.0 Fix Pack 1 o versioni successive, specificare il parametro -d facoltativo per questo comando se si desidera visualizzare le informazioni diagnostiche su un agente locale. Queste informazioni comprendono i trasferimenti correnti, i trasferimenti pianificati, i controlli e le profondità della coda dell'agente. È possibile utilizzare queste informazioni per determinare l'integrità e lo stato di un agent locale.
![[z/OS]](ngzos.gif)
Per z/OS®, da IBM MQ 9.0.2 e IBM MQ 9.0.0 Fix Pack 1, il parametro -d può essere specificato solo se il comando fteShowAgentDetails viene eseguito da:- Lo stesso ID utente con cui è in esecuzione il processo agent.
- I membri del gruppo specificato dalla proprietà agent adminGroup.
Per IBM WebSphere MQ 7.5, o versioni successive, lo stato dell'agent process controller e del gestore code è disponibile se si esegue il comando sullo stesso sistema dell'agent. È possibile utilizzare queste informazioni per facilitare la determinazione dei problemi. Inoltre, quando si esegue il comando sullo stesso sistema dell'agent, sono disponibili informazioni più dettagliate sullo stato dell'agent per il caso in cui l'agent è terminato in modo imprevisto.
Per un elenco dei possibili valori di stato dell'agent e dei relativi significati, consultare Valori di stato dell'agent MFT.
Per un elenco dei valori di stato possibili per Agent Process Controller e relativi significati, consultare Valori di stato di MFT Agent Process Controller.
Per un elenco dei valori di tracciamento degli agenti e delle specifiche FFDC e dei loro significati, vedere fteSetAgentTraceLevel (modifica del livello di tracciamento corrente di un agente)
Syntax
Parametro
- -bl
- Facoltativo. Inoltre emette il livello di creazione del prodotto per l'agente.
- --p configurazione_opzioni
- Facoltativo. Questo parametro determina la serie di opzioni di configurazione utilizzata per emettere la richiesta di visualizzazione dei dettagli di un agente. Utilizzare il nome di un gestore code di coordinamento non predefinito come input per questo parametro. Il comando utilizza quindi la serie di file delle proprietà associati a questo gestore code di coordinamento non predefinito.
Se non si specifica questo parametro, viene utilizzata la serie di opzioni di configurazione basate sul gestore code di coordinamento predefinito.
- -d
- Facoltativo. Specifica che vengono raccolte informazioni diagnostiche per agent_name.
Le informazioni diagnostiche vengono emesse nella console e scritte in un file denominato diagnostics.<yyyyMMdd>.<HHmmss>.<ssss>.<number>.properties nella directory MQ_DATA_PATH\mqft\logs\coordination_qmgr_name\agents\agent_name\logs. Verrà creato un massimo di cinque file cronologici contenenti informazioni diagnostiche su un agente. Se sono stati creati cinque file cronologici per un agent quando il comando fteShowAgentDetails viene eseguito con il parametro -d specificato, il file cronologico meno recente verrà eliminato e sostituito con un nuovo file contenente le informazioni diagnostiche più recenti sull'agent.
È possibile utilizzare questo parametro solo quando l'agente è in esecuzione e sul sistema locale.
- -t
- Facoltativo. Specifica la modalità concisa. Da IBM MQ 9.1, l'output include le informazioni Status Age per impostazione predefinita. Se non si desidera visualizzare queste informazioni, è possibile emettere il comando con il parametro -t . Per ulteriori informazioni, consultare Cosa fare se un agent viene visualizzato come in uno stato SCONOSCIUTO.
- -v
- Facoltativo. Specifica la modalità dettagliata, che genera ulteriore output per l'agente. Questi includono il nome host, la versione del prodotto, il livello di build del prodotto, il livello di traccia e la specifica FFDC (First Failure Data Capture) e un elenco di stati di trasferimento per ogni trasferimento di origine e di destinazione corrente.
Le informazioni di trasferimento correnti vengono ottenute da una pubblicazione sullo stato dell'agente, descritta in Formato del messaggio di stato dell'agente MFT. Pertanto, queste informazioni di trasferimento sono precise solo entro il valore della proprietà agentStatusPublishRateLimit. Per ulteriori dettagli su questa proprietà, consultare Il file MFT agent.properties.
- nome_agent
- Obbligatorio. Il nome del Managed File Transfer Agent che si desidera visualizzare.
- -mquserid id_utente
- Facoltativo. Specifica l'ID utente da autenticare con il gestore code di coordinamento.
- -mqpassword password
- Facoltativo. Specifica la password da autenticare con il gestore code di coordinamento. È necessario anche specificare il parametro -mquserid . Se si specifica -mquserid, ma non si specifica -mqpassword, verrà richiesto di fornire la password associata. La password non verrà visualizzata.
- -o -h
- Facoltativo. Visualizza la sintassi del comando.
![[MQ 9.2.0 Lug 2020]](ng920.gif)
-x- Facoltativo. Fornisce informazioni su tutte le istanze attive e, se esistono, in standby.
Esempio
Nel seguente esempio, eseguendo l'agent di bind, emettendo il comando fteShowAgentDetails localmente all'agent:
fteShowAgentDetails -v AGENT1 5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Agent Information:
Name: AGENT1
Type: Standard
Description:
Operating System: Windows Server 2003
Time Zone: Greenwich Mean Time
Product Version: 7.5
Build Level: f000-20120312-0957
Trace Level: com.ibm.wmqfte.Agent=all
com.ibm.wmqfte.common=all
Trace FFDC: com.ibm.wmqfte.common:Any
com.ibm.wmqfte.Agent:1
Agent Controller Information:
Controller type: MQMFT Process Controller
Status: STARTED
Status Details: The agent process controller has
started the agent process.
Agent Restarts within Interval: 0
Total Agent Restart Count: 0
Agent Availability Information:
Status: READY
Status Details: The agent is running and is publishing
its status at regular intervals. The
last update was received within the
expected time period. The agent is
ready to process transfers, but none
are currently in progress.
Queue Manager Information:
Name: QM1
Transport: Bindings
Last Status Reported: AVAILABLE (Last Error MQRC: 0)
Status Details: The queue manager is available.
Maximum Number of Running Source Transfers: 25
Maximum Number of Queued Source Transfers: 1000
Source Transfer States:
No current transfers
Maximum Number of Running Destination Transfers: 25
Destination Transfer States:
TransferId State
414d51204d49414f5720202020202020822c5b4a648c0b20 progress
414d51204d49414f5720202020202020822c5b4a346c0b20 progressfteShowAgentDetails -p QMGR1 -d AGENT1
5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Agent Information:
Name: AGENT1
Type: Standard
Description:
Operating System: Linux
Time Zone: Greenwich Mean Time
Agent Controller Information:
Controller type: MQMFT Process Controller
Status: STARTED
Status Details: The agent process controller has started
the agent process.
Agent Restarts within Interval: 0
Total Agent Restart Count: 0
Agent Availability Information:
Status: ACTIVE
Status Details: The agent is running and is publishing
its status at regular intervals. The last
update was received within the expected
time period. The agent is currently
processing one or more transfers.
Queue Manager Information:
Name: QMGR1
Transport: Client
Host: host1.hursley.ibm.com
Port: 2021
Channel: SYSTEM.DEF.SVRCONN
Last Status Reported: UNKNOWN
Status Details: Information about the queue manager is
not available because the agent has a
client connection to the queue manager.
Agent Diagnostic Information:
Command Handler Diagnostics:
Last Command Queue Read Time: 2012-07-30T15:23:10.705Z
Pending Command Queue Size: 0
Last Internal Command Type: Resync Request (from sender) - 414d5120514d43414e4445202020202079e20f5064230010
Last Internal Command Time: 2012-07-30T14:17:10.506Z
Last External Command Type: New Monitor Request
Last External Command Time: 2012-07-30T14:10:57.751Z
Diagnostic Properties File name: C:\Program Files (x86)\IBM\WebSphere
MQ\mqft\logs\MUNGEE\agents\MUNGEE\logs\di
agnostics.20121031.083420.0477.1.properti
es
Command Handler Worker Thread 0 Diagnostics:
Status: Waiting
Command Handler Worker Thread 1 Diagnostics:
Status: Waiting
Command Handler Worker Thread 2 Diagnostics:
Status: Waiting
Command Handler Worker Thread 3 Diagnostics:
Status: Waiting
Command Handler Worker Thread 4 Diagnostics:
Status: Waiting
File Transfer Diagnostics:
Source Transfers: 1
Destination Transfers: 2
File Transfer 0 Diagnostics:
Transfer Id: 414d5120514d43414e4445202020202079e20f5064230010
Role: SOURCE
State: ReSynchronisingTransfer
Status: INACTIVE
Start Time: Not started
Retry Count: 0
CheckPoint Index: 0
CheckPoint Position: 0
File Transfer 1 Diagnostics:
Transfer Id: 414d5120514d43414e44452020202020c8fbd54f144f0d20
Role: DESTINATION
State: RunningTransfer
CheckPoint Index: 0
CheckPoint Position: 0
Write Index: 0
Write Position: 0
File Transfer 2 Diagnostics:
Transfer Id: 414d5120514d43414e4445202020202079e20f5086020010
Role: DESTINATION
State: RunningTransfer
CheckPoint Index: 9
CheckPoint Position: 0
Write Index: 3
Write Position: 140923
Monitor 0 Diagnostics:
Name: MONITOR1
Status: STARTED
Resource Type: directory
Resource: /tmp/monitor
Poll Interval: 1 minutes
Batch Size: 2
Condition Match
Pattern: * (wildcard)
Executing: false
Last Execute Start Time: 2012-04-04T16:19:01.852Z
Last Execute End Time: 2012-04-04T16:19:01.852Z
Last Execute Match Count: 0
Schedule 1 Diagnostics:
Id: 1
Next Trigger Time: 2012-07-17T16:00+0100
Occurrences So Far: 14
Repeat Interval: hours
Repeat Frequency: 5
Source Agent: AGCANDE
Destination Agent: AGCANDE
Source File: /tmp/source/a.txt, ...
Destination File: /tmp/dest/a.txt, ...
fteShowAgentDetails AGENT2
5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Agent Information:
Name: AGENT2
Type: Standard
Description:
Operating System: Linux
Time Zone: Greenwich Mean Time
Agent Controller Information:
Controller type: MQMFT Process Controller
Status: UNKNOWN
Status Details: Information about the agent controller
is not available, either because the
agent is not running or the agent is
running on a different system.
Agent Restarts within Interval: 0
Total Agent Restart Count: 0
Agent Availability Information:
Status: STOPPED
Status Details: The agent has been stopped. It was shut
down in a controlled manner.
Queue Manager Information:
Name: QM2
Transport: Bindings
Last Status Reported: UNKNOWN
Status Details: Information about the queue manager is
not available, either because the agent
is not running or the agent is running
on a different system.
fteShowAgentDetails AGENT1
5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Agent Information:
Name: AGENT1
Type: Standard
Description:
Operating System: Windows Server 2003
Time Zone: Greenwich Mean Time
Agent Controller Information:
Controller type: MQMFT Process Controller
Status: WAITING
Status Details: The agent process controller is waiting
for the queue manager to become
available before starting the agent.
Agent Restarts within Interval: 0
Total Agent Restart Count: 1
Agent Availability Information:
Status: STOPPED
Status Details: The agent has been stopped. It was shut
down in a controlled manner.
Queue Manager Information:
Name: QM1
Transport: Bindings
Last Status Reported: UNAVAILABLE (Last Error MQRC: 2059)
Status Details: The queue manager is unavailable. It
might be that the queue manager has not
been started or an incorrect queue
manager name has been configured. Look
up the MQ reason code reported against
the status to understand the problem.
maxRestartDelay . Il valore predefinito della proprietà dell'agente " maxRestartDelay è -1 e ciò causa l'interruzione del controllore del processo dell'agente; pertanto, in questo esempio, il valore della proprietà " maxRestartDelay deve essere stato impostato su un valore superiore a 0. GliCurrent Agent Restart Count: 4implica che si sono verificati 4 riavvii all'interno del periodo di tempo della proprietà dell'agent maxRestartInterval . Se la proprietà dell'agent maxRestartCount è 4, dopo 4 riavvii all'interno di maxRestartInterval, l'agent process controller attenderà maxRestartDelay secondi prima di riavviare l'agent, come in questo caso. GliTotal Agent restart Count: 8suggerisce che ciò si sia verificato in precedenza. Questo esempio non è tipico e si prevede di vedere l'agent terminare in modo imprevisto solo se l'agent esaurisce la memoria o se un'uscita utente personalizzata ha causato un qualche tipo di errore di runtime. I dettagli completi sul motivo per cui l'agent è terminato in modo imprevisto si trovano nel file output0.log dell'agent:fteShowAgentDetails AGENT3
5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Agent Information:
Name: AGENT3
Type: Standard
Description:
Operating System: Windows Server 2003
Time Zone: Greenwich Mean Time
Agent Controller Information:
Controller type: MQMFT Process Controller
Status: RECOVERING
Status Details: The agent process unexpectedly stopped
and the process controller will attempt
to restart it.
Current Agent Restart Count: 4
Total Agent Restart Count: 8
Agent Availability Information:
Status: ENDED UNEXPECTEDLY
Status Details: The agent has ended unexpectedly due to
an unrecoverable problem. The agent
will be automatically restarted.
Queue Manager Information:
Name: QM3
Transport: Client
Host: host3.hursley.ibm.com
Port: 3031
Channel: SYSTEM.DEF.SVRCONN
fteShowAgentDetails AG_CD1
5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Agent Information:
Name: AG_CD1
Type: Connect:Direct bridge
Description:
Connect:Direct Node Name: CDNODE
Connect:Direct Node Host: localhost:1363
Operating System: Windows Server 2003
Time Zone: Greenwich Mean Time
Agent Controller Information:
Controller type: MQMFT Process Controller
Status: UNKNOWN
Status Details: Information about the agent controller
is not available, either because the
agent is not running or the agent is
running on a different system.
Agent Restarts within Interval: 0
Total Agent Restart Count: 0
Agent Availability Information:
Status: STOPPED
Status Details: The agent has been stopped. It was shut
down in a controlled manner.
Queue Manager Information:
Name: QM_JUPITER
Transport: Bindings
Last Status Reported: UNKNOWN
Status Details: Information about the queue manager is
not available, either because the agent
is not running or the agent is running
on a different system.
fteShowAgentDetails AGENTZ
5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Agent Information:
Name: AGENTZ
Type: Standard
Description:
Operating System: z/OS
Time Zone: Greenwich Mean Time
Agent Controller Information:
Controller Type: z/OS Automatic Restart Manager (ARM)
Agent registered with ARM: Yes (ELEMTYPE: SYSBFGAG, ELEMENT: AGENTZ)
Agent Restarted: No
Agent Availability Information:
Status: READY
Status Details: The agent is running and is publishing
its status at regular intervals. The last
update was received within the expected
time period. The agent is ready to
process transfers, but none are currently
in progress.
Queue Manager Information:
Name: ZQM
Transport: Bindings
Last Status Reported: AVAILABLE
Status Details: The queue manager is available.
24-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Host Name: Type: Version:
9.122.123.124 Active 9.1.4.0
myhost.ibm.com Standby 9.1.4.0
10.20.40.123 Standby 9.1.4.0
24-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
Host: Type: Version:
9.122.123.124 Active 9.1.4.0
BFGCL0790I: No standby instance information available for agent ''<agent name>''.
The agent is either not running or is not publishing status.Codici di ritorno
- 0
- Comando completato correttamente.
- 1
- Comando terminato con esito negativo.