Skip to content
CA Common Services for z/OS - 14.1
Documentation powered by DocOps

CAIENF/CICS Control Options

Last update December 31, 2018

CAIENF/CICS control options are specified at CAIENF startup time. They can be dynamically altered using the CAIENF operator command. Any z/OS system console or operator command facility can be used to enter CAIENF/CICS commands.

Note: Each CAIENF/CICS control option, like all CAIENF control options, must be coded on a separate line in the CAIENF parameter file.

Control Options Summary - CAIENF/CICS

Control Option Default
CICS(START|STOP,jobname,prodcode) N/A
CICS(REFRESH,jobname) N/A
MODE(CICS,ON|NONE) ON
CICSREL(nn,nn,nn... ) N/A
CICS(SETSDUMP,jobname,prodcode) N/A
CICS(SETCDUMP,jobname,prodcode) N/A
CICS(NOSDUMP,jobname,prodcode) N/A
CICS(NOCDUMP,jobname,prodcode) N/A
CICS(NOESTAE,jobname) N/A
CICS(QUERY,jobname,prodcode) N/A
Note: CICSREL is valid only at CAIENF startup time.

CICS(START|STOP,jobname,prodcode)

This control option enables or disables the CAIENF/CICS processing for a CA Technologies product within a specific CICS region. Do not issue this command until the targeted CICS region is active. CICS is active when message DFHSI1517 is displayed.

Important!
  • The START|STOP control option cannot be specified in the CAIENF parameter file. This option must be issued as an operator command after CAIENF is active.
  • START/STOP cannot be specified in the CAIENF auto commands file.
  • You cannot use the START|STOP commands against the CICS components of CA ACF2™ for z/OS and CA Top Secret® for z/OS. CAIENF can be enabled in the region by specifying SEC=YES as a SIT option.

Options:

  • START
  • STOP
  • jobname
    Specific CICS region you want CAIENF/CICS installed in.
  • prodcode
    Specific product you want to install in a CAIENF/CICS region.
Note:  If CICS is running as a started task, jobname refers to the started task JOBNAME. If CICS is running as a batch job, jobname refers to the batch JOBNAME.

Examples

To activate the CAIENF/CICS intercepts for CA JARS (assuming the product code for CA JARS is UX62) where the CICS jobname is CICS630A, issue the following command:

CICS(START,CICS630A,UX62)

To disable the CAIENF/CICS intercepts where the CICS region started task or jobname is CICS630A, issue the following command:

CICS(STOP,CICS630A)

CICS(REFRESH,jobname)

This control option can be used if the CICS routines were loaded into each CICS Private Area. If used, this control option refreshes the CAIENF/CICS interface for a particular job. CAIENF automatically determines the correct CICS version for the specified jobname and reloads the required intercepts.

  • jobname
    Specify this option if you want CAIENF/CICS intercepts refreshed for a specific job or CICS region.

Example

The following example refreshes the CAIENF/CICS modules in region CICS630A.

ENF CICS(REFRESH,CICS630A)

MODE(CICS,ON | NONE)

Controls whether CAIENF/CICS automatically installs intercepts into each CICS region.

  • ON
    Lets CAIENF/CICS install automatically intercepts at the CICS systems start.
  • NONE
    Prevents CAIENF/CICS from automatically installing intercepts into active CICS or as the CICS regions start.
    Default: ON
Note: If MODE(CICS,NONE) is specified, manually enter a CICS(START,jobname,prodcode) for each CICS region in which CA Technologies solutions operate.

If MODE(CICS,NONE) is issued while CAIENF is active, CAIENF/CICS does not intercept only the regions activated after the issuance of this command. The CICS regions that were active before this command was issued continue to be intercepted. To deactivate a CICS region, the CICS region must be recycled.

Examples

Activate the CAIENF/CICS intercepts in all CICS regions:

MODE(CICS,ON)

Prevent the CAIENF/CICS intercepts from being installed into all active CICS regions during CAIENF startup:

MODE(CICS,NONE)

CICSREL(nn,nn,nn,...)

This option specifies the releases of CICS for which CAIENF/CICS modules are loaded into ECSA. Issuing this command without an option causes all of the CAIENF/CICS Intercept modules to be loaded into ECSA.

  • nn,nn,nn,...
    Specify one or more CICS or CICS Transaction Servers (CTS) releases by replacing nn with one of the following values.
    • For Release: Specify this for nn:

      Release nn
      CTS 3.1 64
      CTS 3.2 65
      CTS 4.1 66
      CTS 4.2 67
      CTS 5.1 68
      CTS 5.2 69
      CTS 5.3 70
      CTS 5.4 71
      CTS 5.5 72
Note: Specify this control option in the ENFPARMS file. The specified modules are then loaded into ECSA at CAIENF startup and reside there until the next IPL. More than one instance of this command can be issued for specifying the intercept modules for more than one CICS release. This command can accept up to seven release level values.

CICS(SETCDUMP,jobname,prodcode)

This control option causes CAIENF/CICS to write a standard CICS transaction dump when the specified jobname or specified product in the CICS region abends. If you do not issue this control option, and the specified jobname or product abends, CAIENF/CICS recovers without writing a transaction dump.

  • jobname
    Specify this option if you want CAIENF/CICS to write a transaction dump when a specific jobname abends.
  • prodcode
    Specify this option if you want CAIENF/CICS to write a transaction dump when a specific product abends.

Example

The following example causes the CAIENF/CICS to write a transaction dump when job CICS0 or product J161 abends.

ENF CICS(SETCDUMP,CICS0,J161)

Note: This command produces transaction dumps for all errors that occur after the command has been issued. Unlike the SETSDUMP command, do not reissue this command to produce more than one dump.

CICS(SETSDUMP,jobname,prodcode)

This control option can be used to cause CAIENF/CICS to write system dump (SVC dump) when the specified jobname or specified product in the CICS region abends. If you do not issue this control option, and the specified jobname or product abends, CAIENF/CICS recovers without writing an SVC dump.

  • jobname
    Specify this option to have CAIENF/CICS write an SVC dump when a specific jobname abends.
  • prodcode
    Specify this option to have CAIENF/CICS write an SVC dump when a specific product abends.

Example

This command causes CAIENF/CICS to write an SVC dump when job CICS0 or product J161 abends.

ENF CICS(SETSDUMP,CICS0,J161)

Note: This command produces the SDUMP only once after the command has been issued. If a second abend occurs, it is treated like the command was never issued.

If a dump is needed, a second SETSDUMP command is issued after an SDUMP has been produced, from the first SETSDUMP command issued.

CICS(NOSDUMP,jobname,prodcode)

This control option can be used to cancel the SVC dump request for a specified jobname and product that is made by issuing the CICS(SETSDUMP,jobname,prodcode) command.

  • jobname
    Cancels the request for CAIENF/CICS to write an SVC dump when a specific jobname abends.
  • prodcode
    Cancels the request for CAIENF/CICS to write an SVC dump when a specific product abends.

Example

The following example causes CAIENF/CICS to cancel the request to write an SVC dump when job CICS0 or product J161 abends.

ENF CICS(NOSDUMP,CICS0,J161)

CICS(NOCDUMP,jobname,prodcode)

This control option can be used to cancel the standard CICS transaction dump request for a specified jobname and product that is made by issuing the CICS(SETCDUMP,jobname,prodcode) command.

  • jobname
    Cancels the request for CAIENF/CICS to write a transaction dump when a specific jobname abends.
  • prodcode
    Cancels the request for CAIENF/CICS to write a transaction dump when a specific product abends.

Example

The following example causes CAIENF/CICS to cancel the request to write a transaction dump when job CICS0 or product J161 abends.

ENF CICS(NOCDUMP,CICS0,J161)

CICS(NOESTAE,jobname)

Issuing this command cancels all CICS recovery when a specified jobname or CICS region abends.

Important! Only use the CICS(NOESTAE,jobname) command under the direction of CA Technologies Support.

CICS(QUERY,jobname,prodcode)

This control option queries the status of the CAIENF/CICS environment to help diagnose a problem that is associated with installing a CA solution in a CICS region. The basic command with no options indicates:

  • Whether CAIENF/CICS is active
  • Whether the AUTOINSTALL feature has been set
  • Which DCMs have been installed in the CAIENF database
  • Whether the initialization modules associated with those DCMs have been loaded.

Alternatively, a particular region and solution can be specified.

  • jobname
    Inquires about the status of the CICS region represented by the eight-character jobname.
  • prodcode
    Inquire about the status of the product that the four-character product code represents.

Examples

Issue the CICS(QUERY) command without any options to display global information about the status of CAIENF/CICS as it appears from the CAIENF address space.

ENF CICS(QUERY)

The response shows if CAIENF/CICS is active, whether the AUTOINSTALL feature is active, depending on how the CAIENF parameter MODE(CICS,ON|NONE) was set, and also the current status of the DCMs defined to the CAIENF database for CA solutions. This information includes for each solution:

  • Product code
  • Name of the associated initialization routine
  • Address where the initialization routine is loaded
  • Status (active or inactive) of the solution
Note: If CAIENF was unable to locate the routine during initialization, the shown address is 00000000. Check the LINKLST or CAIENF STEPLIB for the routine.

To inquire about the status of a specific product with product code K050 being installed in a specific region, CICSV410, issue the following command. The response indicates whether the product is installed in the region and if so, if it has been activated.

ENF CICS(QUERY,CICSV410,K050)

Was this helpful?

Please log in to post comments.