fteListScheduledTransfers(列出所有计划中的转移)

使用 fteListScheduledTransfers 命令可列出先前使用命令行或 IBM® MQ Explorer创建的所有 Managed File Transfer 传输。

用途

可以根据源代理名称或协调队列管理器,列出所有调度的传输。

仅当您要使用不同于缺省值的配置选项时,才可为该命令指定可选的 -p 参数。 如果未指定 -p,那么将使用 installation.properties 中定义的配置选项。 请参阅 配置选项 以获取更多信息。

运行 fteListScheduledTransfers 命令时,如果任何已调度传输具有具有语义不正确的日期和时间组合的传输定义,那么会导致显示错误消息。 从 IBM MQ 9.3.0开始,这些消息是 BFGCL0810E 消息,其中包含无效调度传输的调度标识。 然后,可以运行带有 schedule_ID 参数的 fteDeleteScheduledTransfer 命令来删除无效的调度传输。

Syntax

fteListScheduledTransfers

Read syntax diagramSkip visual syntax diagramfteListScheduledTransfers -pconfiguration_options-mquseriduser_id-nolpw-mqpasswordpassword-nolpwpattern

参数

--p 配置选项
可选。 如果有多个协调队列管理器,使用该参数可显式指定要为其列出调度传输的代理。 使用非缺省协调队列管理器的名称作为该参数的输入。 然后,该命令将使用与该非缺省协调队列管理器关联的配置选项。
如果未指定该参数,那么将使用基于缺省协调队列管理器的配置选项。
-mquserid 用户ID
可选。 指定通过协调队列管理器进行认证时所使用的用户标识。
-mqpassword 密码
可选。 指定通过协调队列管理器进行认证时所使用的密码。
指定 -mqpassword参数时,还必须指定 -mquserid 参数。 如果指定 -mquserid,但未指定 -mqpassword,那么系统将提示您提供关联的密码,不会显示该密码。

[MQ 9.3.0 2022 年 6 月][MQ 9.3.0 2022 年 6 月]IBM MQ 9.3 开始,该命令缺省为使用 MQCSP 认证,并将要认证的用户标识和密码发送到 MQCSP 结构中的队列管理器。

[MQ 9.3.0 2022 年 6 月][MQ 9.3.0 2022 年 6 月]-nolpw
可选。 如果命令连接到不支持长度超过 12 个字符的密码的队列管理器,请指定此参数。
指定 -nolpw 参数时,还必须指定 -mquserid 参数。 如果指定 -mquserid-nolpw,但未指定 -mqpassword,那么系统会提示您提供不会显示的关联密码。
注: 如果指定 -nolpw 选项,并且密码长度超过 12 个字符,那么命令将失败并返回错误消息 BFGCL0829E
pattern
可选。 用于过滤 Managed File Transfer 调度传输列表的模式。 该模式与源代理名称匹配。 星号 (*) 字符解释为与零个或更多个字符匹配的通配符。
如果未指定该参数,那么缺省情况下会列出所有向协调队列管理器注册的调度传输。
-或-h
可选。 显示命令语法。

示例

在该示例中,列出源代理与模式 *2 匹配的所有调度传输:
fteListScheduledTransfers "*2"  
该示例命令产生以下输出。 调度开始时间和下一个传输时间以全球标准时间 (UTC) 显示:
Schedule Identifier:     1 
Source Agent Name:       AGENT2 
Source File Name:        C:/export/Test/workspace/A.exe 
Conversion Type:         binary 
Destination File Name:   C:/import/Test/workspace/B001.zzx 
Destination Agent Name:  AGENT1 
Schedule Start Time:     2008-10-23T16:08+0100 
Next Transfer:           2008-10-23T16:08+0100 
Schedule Time Base:      source 
Repeat Interval:         minutes 
Repeat Frequency:        1 
Repeat Count:            30 

返回码

0
命令成功完成。
1
命令结束但未成功。