CICS TS plug-in
Tip: For more questions and answers, see the UrbanCode forum on IBM developerWorks.
- Using the step logs
- Resources which operate asynchronously
- Checking the status of a resource that was installed in the previous step
- Collecting data for plug-in problems
- Resolving ‘Unsupported CICS release’ message
If a step fails, is there a rollback mechanism provided?
The CICS TS plug-in does not provide a specific rollback mechanism for a failed process or step. When a step fails, the context of the failure is important. First, check the step logs for more details on how the step failed. Then you can either manually rollback the relevant steps, or preferably, you can build and run a process that will take your environment back to the state it was in prior to the process having run.
Most failures can be detected by inspecting the step output logs in IBM UrbanCode Deploy. If an error occurs within the UCD set up, the step output log typically contains an error message similar to “authentication failed,” which often indicates an incorrect user name and password.
If the problem is more CICS specific, the step output log will contain a message such as the following:
2015/03/10 10:28:35.703 GMT BUZCP0030E PROGRAM "DFHSJJI" was not found.
‘BUZCP’ is the prefix for all CICS TS plug-in messages.
‘0030’ is the message number.
‘E|W|I’ is the message level: error, warning, or informational.
An Error level message indicates the step failed with an error. A Warning level message indicates the step continued, but some properties may not be set correctly. An Information level message indicates progression of the step.
Where available, the log contains CICS RESP and RESP2 codes for more detailed troubleshooting:
2015/03/10 16:42:13.219 GMT BUZCP0006I Connected to "your.cicsplex.com:29000". 2015/03/10 16:42:13.638 GMT BUZCP0037I Perform DISCARD Operation. 2015/03/10 16:42:13.733 GMT BUZCP0026E DISCARD PROGRAM "DFHSJJI" failed. 2015/03/10 16:42:13.736 GMT BUZCP0031E EXEC CICS command (DISCARD PROGRAM) RESP(NOTAUTH) RESP2(100). 2015/03/10 16:42:13.750 GMT BUZCP0029I Summary: 0 DISCARD request(s) succeeded, 1 DISCARD request(s) failed.
In this example, the ‘Discard resources’ step fails for program ‘DFHSJJI’. The output of message BUZCP0031E lists the attempted EXEC CICS command, DISCARD PROGRAM, followed by the RESP and RESP 2 codes NOTAUTH and 100 respectively. You can find information on the command and response codes in the DISCARD PROGRAM topic of the CICS TS online production documentation.
Details for any EXEC CICS command and respective RESP and RESP2 codes are available in the System Programming reference section of the CICS TS online product documentation, sorted by command name.
Note: If the target scope of a step is more than one region, the step will fail when one or more regions fail to complete a request. Use the step log to determine the scope, then use the CICS logs to determine the specific regions in which the failures occurred, and confirm the cause.
When a CICS TS plug-in step completes, it is generally true that the action also completes in CICS TS, as the operation is synchronous. However, there are a number of CICS resources where steps run asynchronously.
For an asynchronous operation, the step log shows only whether the plug-in successfully connects to CICS TS and makes the request, not if the operation completes successfully. You should check the status of the resource in CICS TS to confirm the success of an asynchronous operation.
Here is a list of steps, with respective resources that complete asynchronously:
Disable resources – Bundle, File, DB2 Entry, Data Table.
Enable resources – Bundle, JVM Server.
Install BAS resource groups / Install CSD groups or lists / Install BAS resource descriptions – Bundle, Web Service, Pipeline, JVM Server.
Install BAS resources / Install CSD resources – Bundle, Web Service, Pipeline, JVM Server.
Close resources – Data Table, File, TCP/IP Service.
After a resource is installed in CICS, it might take a few seconds for the existence of the resource to be returned by CICSPlex SM. To help ensure that the steps which check the status of a resource return an accurate status, the default timeout value is 15 seconds. If you decrease this timeout value, the step might not return the correct status of the resource, and you might receive the following error:
BUZCP0046E Resource "MYRESO01" does not exist in the target scope
If you need to open a service request (SR) or problem management record (PMR), please collect the process logs associated with the failure and the logs for the UCD agent.
If you have recently updated CICS, you might receive the following error when you use the plug-in:
BUZCP0043E Exception detailed message: Unsupported CICS release.
To resolve this issue, upgrade to the latest version of the CICS TS plug-in.