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.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
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.
or
You cannot use a combination of * and + masking characters in the same value.
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.
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.
or
or
For example, to identify all program resource definitions beginning with the characters PAY, from all groups beginning with the characters FIN, specify:
<ObjectCriteria>
<ObjName>PAY*</ObjName>
<ObjGroup>FIN*</ObjGroup>
<ObjType>PROGDEF</ObjType>
</ObjectCriteria>
If the source CICS configuration refers to an export file, then no security check is performed for the source resource definition.
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.
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/.
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.
or
or
The CICS Configuration Manager task is abnormally terminated with a transaction dump.
The CICS Configuration Manager task is abnormally terminated but without a transaction dump.
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 ENU (U.S. English) or JPN (Japanese)
If no current resource definition exists (it has been deleted), then the after image of the most recent of the selected changes must be empty (reflecting the deletion).
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.
1–8 characters (A–Z, a–z, 0–9, @, $, #, -, and _) 1–8 characters (A–Z, 0–9, @, $, #, -, and _)
The CICS Configuration Manager ISPF dialog limits the character set to A–Z, 0–9, @, $, #, -, 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 a–z, A–Z, 0–9, @, $, #, -, and _. Client applications using the API may impose their own character set restrictions.
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.
<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.
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.