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.
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.
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:
To disable the CAIENF/CICS intercepts where the CICS region started task or jobname is CICS630A, issue the following command:
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.
The following example refreshes the CAIENF/CICS modules in region CICS630A.
Controls whether CAIENF/CICS automatically installs intercepts into each CICS region.
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.
Activate the CAIENF/CICS intercepts in all CICS regions:
Prevent the CAIENF/CICS intercepts from being installed into all active CICS regions during CAIENF startup:
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.
For Release: Specify this for nn:
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.
The following example causes the CAIENF/CICS to write a transaction dump when job CICS0 or product J161 abends.
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.
This command causes CAIENF/CICS to write an SVC dump when job CICS0 or product J161 abends.
If a dump is needed, a second SETSDUMP command is issued after an SDUMP has been produced, from the first SETSDUMP command issued.
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.
The following example causes CAIENF/CICS to cancel the request to write an SVC dump when job CICS0 or product J161 abends.
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.
The following example causes CAIENF/CICS to cancel the request to write a transaction dump when job CICS0 or product J161 abends.
Issuing this command cancels all CICS recovery when a specified jobname or CICS region abends.
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:
Alternatively, a particular region and solution can be specified.
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.
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:
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.