fteListScheduledTransfers (list all scheduled transfers)

Use the fteListScheduledTransfers command to list all of the Managed File Transfer transfers that you previously created using the command line or the IBM® MQ Explorer.

Purpose

You can either list all scheduled transfers based on source agent names or based on the coordination queue manager.

Specify the optional -p parameter for this command only if you want to use configuration options different from your defaults. If you do not specify -p, the configuration options defined in installation.properties are used. See Configuration options for more information.

When you run the fteListScheduledTransfers command, any scheduled transfer that has a transfer definition with a semantically incorrect date and time combination causes error messages to be displayed. From IBM MQ 9.3.0, these messages are BFGCL0810E messages that include the schedule ID of the invalid scheduled transfer. You can then run the fteDeleteScheduledTransfer command with the schedule_ID parameter to delete the invalid scheduled transfer.

Syntax

fteListScheduledTransfers

Parameters

-p configuration_options: Optional. If you have more than one coordination queue manager, use this parameter to explicitly specify which agents you want to list scheduled transfers for. Use the name of a non-default coordination queue manager as the input for this parameter. The command then uses the configuration options associated with this non-default coordination queue manager.; If you do not specify this parameter, the configuration options based on the default coordination queue manager are used.
-mquserid user_id: Optional. Specifies the user ID to authenticate with the coordination queue manager.
-mqpassword password: Optional. Specifies the password to authenticate with the coordination queue manager.; When the -mqpasswordparameter is specified, you must also specify the -mquserid parameter. If you specify -mquserid, but do not specify -mqpassword, you are prompted to supply the associated password, which will not be displayed.
From IBM MQ 9.3 onwards, the command defaults to using MQCSP authentication, and sends the user ID and password to be authenticated to the queue manager in an MQCSP structure.
-nolpw: Optional. Specify this parameter if the command connects to a queue manager that does not support passwords longer than 12 characters.; When the -nolpw parameter is specified, you must also specify the -mquserid parameter. If you specify -mquserid and -nolpw, but do not specify -mqpassword, you are prompted to supply the associated password which will not be displayed.
Note: If you specify the -nolpw option, and the password is longer than 12 characters the command fails with error message BFGCL0829E.
pattern: Optional. The pattern to use to filter the list of Managed File Transfer scheduled transfers. This pattern is matched against the source agent name. Asterisk (*) characters are interpreted as wildcards that match zero or more characters.; If you do not specify this parameter, all of the scheduled transfers registered with the coordination queue manager are listed by default.
-? or -h: Optional. Displays command syntax.

Example

In this example, all of the scheduled transfers with source agents that match the pattern *2 are listed:

fteListScheduledTransfers "*2"

This example command produces the following output. The schedule start time and next transfer time are displayed in Coordinated Universal Time (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

Return codes

0: Command completed successfully.
1: Command ended unsuccessfully.