IBM® CICS® Configuration Manager for z/OS®

IBM CICS Configuration Manager for z/OS

CICS Configuration Manager

CICS Configuration Manager

5697-P09

Version 2.1

V2.1

V1.2

Version 2

2

Release 1

V2R1

V2R1M0

0210

0410

CCV210

User's Guide

GC34-7048

Program Directory

CICS External Interfaces Guide

CICS Internet Guide

CICS Intercommunication Guide

CICS RACF® Security Guide

CICS Supplied Transactions

CICS System Programming Reference

CICSPlex® SM Resource Tables Reference

CICSPlex SM Application Programming Reference

CICS Resource Definition Guide

CICS Application Programming Reference

SecureWay Security Server RACF Security Administrator's Guide

SecureWay Security Server RACF Macros and Interfaces

TSO/E Customization

MVS™ Initialization and Tuning Reference

ISPF User's Guide Volume I

Information Center

CICS Transaction Server for z/OS

Version 4

topic

Topic

Begin figure description.

End figure description.

This figure is described in the surrounding text.

Yes

http://www.ibm.com/cics/support/

http://www.ibm.com/cics/library/

http://publib.boulder.ibm.com/infocenter/cicsts/v4r2/topic/com.ibm.cics.ts.doc/prod/glossary.html

http://publib.boulder.ibm.com/infocenter/cicsts/v4r2/

http://www.ibm.com/cics/cm/

http://www.ibm.com/ibm/terminology/

http://www.w3.org/TR/soap11/

CICS/CM 2.1

0 Settings

1 Administer

1.1 System Options

1.2 CICS Configurations

1.3 Migration Schemes

1.4 Approval Profiles

1.6 Exit Points

2 CICS Resources

3 Packages

4 Reports

4.1 Multiple Configs

4.2 Find

4.3 CICS changes

4.4 Orphan Groups

4.5 Matching names

4.6 Matching checksums

4.7 Shared resources

4.8 Orphan resources

4.9 Check Analysis

the Cancel key (F12)

the Backwards key (F7)

the Forwards key (F8)

the Exit key (F3)

the Help key (F1)

the PrevPage key (F10)

the Actions key (F10)

the NextPage key (F11)

the Prompt key (F4)

the Repeat Locate key (F5)

the Zoom key (F6)

//CCVJOB   JOB your job statement information
//STEPLIB  DD DISP=SHR,DSN=ccvhlq.SCCVAlang
//         DD DISP=SHR,DSN=ccvhlq.SCCVAUTH
//CCVPRINT DD SYSOUT=*
//CCVPARMS DD *
CONNECT IPADDRESS=ip_address,PORT=ip_port_number

CCV210

CCV210

CICSCM

To find out what actions you can perform on the items in the list, enter / next to an item.

R

M

×

(ALTER access authority)

(READ access authority)

(UPDATE access authority)

API command (READ access authority)

Resource definitions

CICS Resource Definition Changes Report

Criteria for this object type

Data for this object type

2009/05/15

Report options
Lists the CONNECT, REPORT, and any CRITERIASET batch commands that generated this report. This includes any default parameter values not explicitly specified in the input control cards.
Tip: To limit a list panel to items changed in the last 30 days, enter TODAY-30 in the Date filter field.

The journal contains historical versions of resource definitions only for changes made using CICS Configuration Manager. If you use another method to edit a resource definition, such as the CEDA transaction supplied with CICS, then the journal will not contain the version prior to that edit. For details, see Resource definition changes reported by CICS Configuration Manager.

List panels under option 4.1 Multiple Configs offer two additional choices:
Show different checksums
Shows resource definitions that have the same name and resource type but different checksum values.
Show missing names
Shows resource definitions whose combination of name and resource type exist in some but not all of the selected CICS configurations.
You must specify at least one COND parameter in each CRITERIASET. Each COND parameter must appear on a separate input line, except for the first, which may appear on the same line as CRITERIASET. To specify comparison operators, you can use 2-letter codes or signs:
EQ or =
Equal to
GE or >=
Greater than or equal to
GT or >
Greater than
LE or <=
Less than or equal to
LT or <
Less than
NE or ¬= or <>
Not equal to
If you use a 2-letter code, such as EQ, then you must insert one or more blanks before and after the code. If you use a sign, such as =, then do not insert blanks before or after the sign. All parameter values are case-insensitive and are converted to uppercase prior to processing.

To remove a resource definition from a ResGroup, enter R (Remove) next to the resource definition in that ResGroup. CICS Configuration Manager protects you from creating orphan resource definitions: if you attempt to remove a version of a resource definition that belongs to only one ResGroup, CICS Configuration Manager displays an error message, and does not remove the resource definition.

<object_type> and its end tag are optional. Specifying this "wrapper" element allows you to use the supplied schema to validate the contents of the <ObjectData> element for that object type. For details, see Using the supplied schema to write API commands.

The names of the object data elements match the attribute names used by CICSPlex SM. For details, see the XML schema CCVXXRES supplied in sample library SCCVSAMP. For example, to set the PROGRAM attribute of a TRANDEF resource definition to QAAFLTC, you specify <Program>QAAFLTC</Program>. See Examples for an example using the Create API command. For a complete list of attributes for each object, see the resource table descriptions in CICS Transaction Server for z/OS: CICSPlex SM Resource Tables Reference. To set an attribute to its default value, specify an empty element, such as <attribute_name/>, or an element containing whitespace only.

You can specify the object criteria in several ways:
You can specify the object criteria in several ways:

If the source CICS configuration refers to an export file, then no security check is performed for the source resource definition.

A Rename API command for a group/ResGroup involves resource definition security checks (requiring ALTER access authority) for all of the following:

You can then migrate the lists from one CICS configuration to another. This enables you to manage changes to lists across CICS systems. Some restrictions apply to packaging lists that do not apply to other resource types: you cannot migrate a list to a CICS configuration that refers to a context. Also, note that packaging a list only adds the list object (a set of group names) to the change package, not the groups in the list.

Is it an export file or import file?

You can use the terms "export file" and "import file" to refer to the same file depending on how it is being used. At the site where the file is created, the file is typically referred to as an export file. At the site where the contents of the file are imported, the file is typically referred to as an import file. For the sake of consistency, and to make it easier to search for related information, this documentation uses the term "export file" throughout.

If you connect to the CICS Configuration Manager server via an authenticated port, then both of these libraries must be APF-authorized. For details, see Optional: Enable PassTicket processing.

Tip: Before pressing Enter on the DEFINE Confirmation pop-up window, check that the CICS configuration specified is the one that you intended. By default, this window displays the name of the CICS configuration where you previously defined a resource definition. This is not necessarily the CICS configuration whose resource definitions appear on the panel where you entered the DEF command.

The CICS Configuration Manager server does not define resource definitions for user exit programs. You must define these resources yourself, or have CICS autoinstall them for you.

You must specify the CSD file via the SIT parameter CSDDSN, not via the ddname DFHCSD in the CICS region startup JCL.The release level of CICS Transaction Server that runs the CICS Configuration Manager server must be the same as or later than the release levels of CICS Transaction Server that manage the CSD files or the CICSPlex SM data repositories you want to use with CICS Configuration Manager. If your system uses CICSPlex SM, then the release level of CICS Transaction Server that runs the CICS Configuration Manager server must be the same as the release level of CICS Transaction Server that runs the local CMAS.

Before you can start using CICS Configuration Manager to work with your resource definitions, you need to define a CICS configuration for each of your CSD files or CICSPlex SM data repository contexts. This is one of your first tasks after installing CICS Configuration Manager.

The DATATAKEUP batch command offers a timesaving alternative to the interactive ISPF dialog panels for defining CICS configurations. Rather than using the panels to define CICS configurations one at a time, you can use this command to define or update all of your CICS configurations in a single batch job.

The CICS Configuration Manager server dynamically modifies the DFHCSD data set name each time it needs to access a CSD file. Specifying the ddname in JCL prevents the server from dynamically allocating the ddname, and causes the CICS Configuration Manager server to report an error.

CICS Explorer® with the CICS Configuration Manager plug-in provides an Eclipse-based graphical user interface to many of the CICS Configuration Manager functions available in the supplied ISPF user interface. CICS Explorer also provides an integrated interface to various CICS functions and other CICS tools. For more information about CICS Explorer and the CICS Configuration Manager plug-in, see www.ibm.com/cics/explorer/.

 1 
<CSDInfo> contains information for CSD-based resource definitions. <CPSMInfo> contains information for context-based resource definitions.
<ConnectionCount> specifies the CSD-based CICS regions on which to perform this action:
All
Performs the action via all of the remote system connections defined in the CICS configuration. If you omit <ConnectionCount> or its parent <CSDParms>, this is the default.
element_count
Performs the action via the remote system connections identified by one or more <ConnectionElement> elements. The number of <ConnectionElement> elements must match element_count. Each <ConnectionElement> must refer to a remote system connection specified in the CICS configuration.
Local
Performs the action on the CICS region that is running the CICS Configuration Manager server. If you specify "local":
  • <LocationName> must specify a CICS configuration that refers to the CSD file used by the CICS Configuration Manager server.
  • Do not specify any connection elements (if you do, they are ignored).
This command has two formats:

CSD files and CICSPlex SM data repositories use different names for equivalent resource definition types. For example, a PROGRAM resource definition in a CSD file is known as a PROGDEF in a CICSPlex SM data repository.

System action

The CICS Configuration Manager task is abnormally terminated with a transaction dump.

System action

The CICS Configuration Manager task is abnormally terminated but without a transaction dump.

User response

This is probably an internal error. Please record any previous messages that may be related to this problem and contact IBM support.

Zoom fields (marked by >)

A greater than sign (>) next to a field indicates that the field contains more data than can be displayed on the current panel. This often occurs on description fields in a side-by-side comparison. To view the entire contents of the field, move the cursor to the field (not the > sign) and then press the Zoom key (F6).

A list panel appears with filter fields and column headings, but no list items. Instead, directly under the column headings is a "bottom of data" indicator. This empty list is normal: the panel does not display any list items until you press Enter. This allows you to adjust the filter before displaying the list, avoiding delays caused by listing more resource definitions than required.

where lang is one of the following 3-character national language codes:
ENU
U.S. English
JPN
Japanese

where lang is ENU (U.S. English) or JPN (Japanese)

The rollback option protects you from unintentionally overwriting changes that are outside of the set you have selected. Specifically, the rollback option ensures that the selected changes for a resource definition form an unbroken chain that begins at the current resource definition and ends at the before image of the oldest selected change. The chain is unbroken if the following two conditions are true: To match, two items must have the same attribute values and the same change date.

The rollback option applies to each resource definition individually: a break in the rollback chain of one resource definition has no effect on the recovery of other resource definitions in the set of selected changes.

You cannot recover changes to CICSPlex SM relationships, such as Add and Remove (that is, changes to xxxINGRP resource definition types). However, you can recover changes to the resource definition types List, ResGroup, and ResDesc.

Recovering the after image of a deletion, or the before image of a creation, deletes the current resource definition, if it exists.

When a CICS Configuration Manager user issues the command to approve or disapprove a change package, they specify the approver role that they are representing (for example, "I am approving this change package as a project manager"). If the CICS Configuration Manager system option for security checking is active, the user must be authorized to represent that approver role for the migration scheme and the approval profile selected by the change package.

18 characters (AZ, az, 09, @, $, #, -, and _) 18 characters (AZ, 09, @, $, #, -, and _)

The CICS Configuration Manager ISPF dialog limits the character set to AZ, 09, @, $, #, -, and _. The CICS Configuration Manager server converts lowercase characters to uppercase, but does not limit the character set further. Client applications using the API may impose their own character set restrictions.

The CICS Configuration Manager ISPF dialog limits the character set to az, AZ, 09, @, $, #, -, and _. Client applications using the API may impose their own character set restrictions.

A CICS Configuration Manager transaction that can perform the following actions on active CSD-based CICS regions:

When a CICS Configuration Manager client requests one of these actions, the server uses a CICS distributed program link (DPL) to invoke the agent in that region. The agent then performs the action, such as the installation-type actions CICS CEDA INSTALL, CICS EXEC DISCARD, or CICS EXEC SET PROGRAM (specifying either NEWCOPY or PHASEIN).

This agent is required only if you want to perform actions on active CICS regions whose resource definitions are stored in a CSD file. You need to configure the agent within these CICS regions. This agent is not used for CICS regions that are managed by CICSPlex SM; for those regions, CICS Configuration Manager uses the CICSPlex SM API to perform these actions.

A set of CICS programs that performs the actions requested by a client.
A VSAM key-sequenced data set (KSDS) that stores current CICS Configuration Manager data:
  • System options
  • CICS configurations
  • Migration schemes
  • Approval profiles
  • Transformation rules
  • Change packages and related records
A VSAM key-sequenced data set (KSDS) that records historical CICS Configuration Manager data:
  • Summaries of processing events, such as updates to resource definitions
  • "Before" and "after" copies of CICS resource definitions that have been updated by CICS Configuration Manager

<ObjectCriteria> child elements:

<ObjectData> child elements returned by the List command:

Alters selected attribute values across one or more resource definitions, without affecting other attribute values.

Adds objects to a container object.

Adds to a change package the approval of a particular approver role.

Backs out a previous change package migration.

Copies resource definitions between groups or CICS configurations.

Creates a resource definition or a CICS Configuration Manager repository object.

Deletes resource definitions or CICS Configuration Manager repository objects.

Removes from a change package the approval of a particular approver role.

Discards the in-memory image of resource definitions from active CSD-based CICS regions.

Imports resource definitions from an export file received from another CICS Configuration Manager system. Optionally, if the export file contains change package details, also registers change packages in the importing CICS Configuration Manager repository.

Returns all the fields for a single resource definition, CICS Configuration Manager repository object, or CICS Configuration Manager journal object.

Dynamically makes resource definitions available to an active CICS region.

This command searches the migration scheme for a target CICS configuration that refers to a CICSPlex SM context. If found, the command installs resource definitions from the change package that are in that CICS configuration. The command performs this installation only for the first such CICS configuration in the migration scheme. If all of the target CICS configurations of the migration scheme refer to CSD files, then the command returns an error.

Returns selected fields from one or more resource definitions, CICS Configuration Manager repository objects, or CICS Configuration Manager journal objects.

Copies the resource definitions in a change package from source to target CICS configurations, and invokes commands in the change package on target CICS configurations, according to the specified migration scheme.

Reloads in-memory copies of resource definitions associated with a CICS program definition.

Indicates that the resource definitions in a change package are ready for migration.

Recovers before or after images of historical resource definitions from the journal.

Removes objects from a container object.

Renames resource definitions, and optionally moves them to another group.

Indicates that the resource definitions in a change package are no longer ready for migration.

Modifies a resource definition or a CICS Configuration Manager repository object.

These IDs match the order of the PHASE=COLLECT parameters in the DEPLOY command. For example, the ID of the data source for the first PHASE=COLLECT parameter is 01.

Add
Adds a resource definition to a resource group (RESGROUP) in a context-based target CICS configuration.
Remove
Removes a resource definition from a resource group in a context-based target CICS configuration.
Delete
Deletes a resource definition from either a CSD-based or a context-based target CICS configuration.



RUNTIME-CCM
Runtime resource definitions, collected from an active CICS region via the CICS Configuration Manager agent.
RUNTIME-CPSM
Runtime resource definitions, collected from an active CICS region via CICSPlex SM.
CANDIDATES-CSD
Candidate resource definitions, collected from a CSD file.
CANDIDATES-CPSM
Candidate resource definitions, collected from a CICSPlex SM data repository.

This is a common header section that appears in all deployment analysis reports.

This section appears in the following deployment analysis reports:

Uninstallable. This candidate resource definition has a referential integrity error. For details, see the line for this resource definition in Referential integrity verification.

If you specify the optional ddname CCVFLTEX in your report JCL, the job output includes a filter file that contains a filter statement for each item in the generated report. To suppress an item from future reports, copy and paste the corresponding filter statement from this file to your own filter file.

Cold start compare Candidates compare Runtime compare Runtime Candidates Check
      Yes Yes  
Yes Yes Yes      
Yes Yes Yes      
Yes          
Yes Yes Yes      
Yes Yes     Yes Yes
Yes Yes     Yes Yes

To import commands, you must select the option to register change packages. If you do not select this option, the import ignores commands in the export file.

If you specify "yes", migration effectively moves rather than copies resource definitions: after copying resource definitions to the target CICS configuration, CICS Configuration Manager deletes them from the source CICS configuration. The default value is "no" (do not delete at source). If the source CICS configuration refers to an export file, you must specify "no".

Whenever you use CICS Configuration Manager to change (create, update, or delete) a resource definition, CICS Configuration Manager records the change in its journal. For each change, CICS Configuration Manager records the state of the resource definition before the change (before image) and the state after the change (after image). These before/after images are known collectively as historical versions. You can view, compare, and recover historical versions.