CICS DISABLE

This command makes a resource unavailable to applications, except for those currently using it. See Additional usage informationfor more information. 


Command

Parameters

CICS DISABLE

(FILE | TRAN | PROGRAM | DEST)

Identifier

Related topic

CICS

CICS-ENABLE

The following table describes the parameters:

Parameter

Function

Notes

Type

Type of resource to affect

Valid values are:

  • FILE: a file
  • TRAN: a CICS transaction
  • PROGRAM: a CICS application program
  • DEST: a transient data queue

Important

BBI-SS PAS to CICS communication must be active if the CICS DISABLE statement uses any of these parameters.

Identifier

Resource ID for each type

Valid values are:

  • file id: Identifier is a 1 to 8-alphanumeric file name.
  • tran id: Identifier is a 1 to 4-alphanumeric transaction name.
  • program id: Identifier is a 1 to 8-alphanumeric program name.
  • dest id: Identifier is a 1 to 4-character queue name defined in the Destination Control Table (DCT).

Example

This example command disables a CICS transaction.

/* REXX */
"IMFEXEC CICS DISABLE TRAN ABRW"

CLIST example:

IMFEXEC CICS DISABLE TRAN ABRW

Additional usage information

  • Generic specifications are available with a limit 2000 resources that can be attempted.

    The limit of 2000 presents how many items are considered for disabling and does not guarantee how many resources are successfully disabled.  For example, if you specify CICS ENABLE TRAN * and during the scan of the CICS transactions to disable, those that are not eligible to be disabled are still counted as part of the 2000 limit.
  • You can use the plus sign ( + ) sign anywhere in the resource name to replace a single character. You can also use multiple plus signs to replace multiple characters. 
    For example you might specify L+P1 or L+P+. 

  • You can also use an asterisk ( * )  to replace all of the characters following the asterisk. Specifying DM* produces the same result as DM*1. 

 The CICS DISABLE command cannot disable the following items:

  • Transactions supplied CICS
  • Transactions supplied by BMC
  • Some BMC programs
  • DFH* programs
  • Indirect transient data queues (DEST)
  • Remote transient data queues (DEST)

The following lists additional REXX examples:

"IMFEXEC CICS DISABLE TRAN DM+K"
"IMFEXEC CICS DISABLE TRAN K1*"
"IMFEXEC CICS DISABLE FILE STOCK+00"
"IMFEXEC CICS DISABLE FILE STOCK*"
"IMFEXEC CICS DISABLE PROG LODPGM+1"
"IMFEXEC CICS DISABLE PROG LODPGM*"
"IMFEXEC CICS DISABLE DEST C++O"
"IMFEXEC CICS DISABLE DEST EO*"

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*