fteDelete (generate scripts to remove configuration)

Use the fteDelete command to generate the configuration scripts necessary to remove the specified Agent Queue Manager objects.

Purpose

You would expect to use the fteDelete command when some configuration steps need to be run on a system that is remote to the one containing the configuration data. For example, removing the queues for a remote client agent on a local queue manager.

Syntax

fteDelete

Parameters

-t type: Required. The type of object to be delete. The options for type are agent.
-d outputDir: Optional. A directory path in which the scripts are written. If not provided, the scripts are written to the standard output stream.
name: Required. One or more names of the objects to be delete. To specify names for more than one object, separate them with a space. For example, name1 name2...
-? or -h: Optional. Displays command syntax.

Examples

In this example, the fteDelete command is specified with the -t agent parameter and a single agent name. The output is written to a file.

fteDelete -t agent EXAMPLE.AGENT >EXAMPLE.AGENT_delete.mqsc

The output that is generated from this command are the MQSC command scripts to be run against the agent queue manager to delete the agent queues:

$ fteDelete -t agent EXAMPLE.AGENT
5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
CLEAR QLOCAL(SYSTEM.FTE.COMMAND.EXAMPLE.AGENT)
DELETE QLOCAL(SYSTEM.FTE.COMMAND.EXAMPLE.AGENT)
CLEAR QLOCAL(SYSTEM.FTE.DATA.EXAMPLE.AGENT)
DELETE QLOCAL(SYSTEM.FTE.DATA.EXAMPLE.AGENT)
CLEAR QLOCAL(SYSTEM.FTE.REPLY.EXAMPLE.AGENT)
DELETE QLOCAL(SYSTEM.FTE.REPLY.EXAMPLE.AGENT)
CLEAR QLOCAL(SYSTEM.FTE.STATE.EXAMPLE.AGENT)
DELETE QLOCAL(SYSTEM.FTE.STATE.EXAMPLE.AGENT)
CLEAR QLOCAL(SYSTEM.FTE.EVENT.EXAMPLE.AGENT)
DELETE QLOCAL(SYSTEM.FTE.EVENT.EXAMPLE.AGENT)
...
etc.

In this example, the fteDelete command is specified with the -d outputDir parameter and several agent names.

fteDelete -t agent -d /tmp EXAMPLE.AGENT.1 EXAMPLE.AGENT.2 EXAMPLE.AGENT.3

The output that is generated from this command are the absolute file paths to the locations of the MQSC command scripts:

$ fteDelete -t agent -d /tmp EXAMPLE.AGENT.1 EXAMPLE.AGENT.2 EXAMPLE.AGENT.3
5724-H72 Copyright IBM Corp. 2008, 2025. ALL RIGHTS RESERVED
BFGCM0241I: A file has been created containing the MQSC definitions to delete the agent EXAMPLE.AGENT.1. The file can be found here: '/tmp/EXAMPLE.AGENT.1_delete.mqsc'.
BFGCM0241I: A file has been created containing the MQSC definitions to delete the agent EXAMPLE.AGENT.2. The file can be found here: '/tmp/EXAMPLE.AGENT.2_delete.mqsc'.
BFGCM0241I: A file has been created containing the MQSC definitions to delete the agent EXAMPLE.AGENT.3. The file can be found here: '/tmp/EXAMPLE.AGENT.3_delete.mqsc'.

Return codes

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