Force (FORCE)

Specifies whether the command should be forced to complete when conditions are such that completing the command affects an open queue. The conditions depend on the type of the queue that is being changed:

Alias Queue

The TGTQNAME keyword is specified with a queue name and an application has the alias queue open.

Local Queue

Either of the following conditions indicate that a local queue will be affected:

  • SHARE(*NO) is specified and more than one application has the local queue open for input.

  • The USAGE attribute is changed and one or more applications has the local queue open, or, there are one or more messages on the queue. (The USAGE attribute should not normally be changed while there are messages on the queue; the format of messages changes when they are put on a transmission queue.)

Remote Queue

Either of the following conditions indicate that a remote queue will be affected:

  • The TMQNAME keyword is specified with a transmission-queue name (or *NONE) and an application with the remote queue open will be affected by this change.

  • Any of the RMTQNAME, RMTMQMNAME or TMQNAME keywords is specified with a queue or queue manager name, and one or more applications has a queue open that resolves through this definition as a queue manager alias.

Note: FORCE(*YES) is not required if this definition is in use as a reply-to queue definition only.

The possible values are:

*NO

The command fails if the relevant conditions are true.

*YES

The command is forced to complete successfully even if the relevant conditions are true.