Processing a change package
To process a change package, select primary menu option 3 Packages, enter S next to the change package that you want to process, and then choose a processing command:
- Package
- Displays a list panel of resource definitions so that you can
add them to the change package using line action P (Package), or add commands for the
resource definitions to the change package.
Line action P (Package) is also available on many other list panels, such as those under 2 CICS Resources; the advantage of using this list panel under option 3 Packages is that line action P adds the resource definition to the selected change package immediately; on other panels, you have to select the change package each time in a pop-up window.
- List
- Displays a list panel of resource definitions in the change package.
To remove a resource definition from the change package, enter line action R (Remove) next to the resource definition.
If you specify a migration scheme with this processing command, then on the resulting list panel you can press the NextPage key (F11) to toggle between two views:
- Resource definitions in the source CICSĀ® configurations of the migration scheme.
- Resource definitions in the target CICS configurations of the migration scheme.
If you do not specify a migration scheme, then on the resulting list panel you can specify a filter value for the CICS configuration. If you do not specify a filter value, the list panel shows all resource definitions in the change package, regardless of the CICS configuration.
- Commands
- Displays a list panel of commands in the change package.
To delete a command from the change package, enter line action D (Delete) next to the command.
If you do not specify a migration scheme, then on the resulting list panel you can specify a filter value for the CICS configuration. If you do not specify a filter value, the list panel shows all commands in the change package, regardless of the CICS configuration.
- Ready
- Readies or unreadies the change package for the selected migration scheme.
- Approve
- Approves or disapproves the change package for the selected migration scheme.
- Migrate
- Migrates the resource definitions in the change package using the selected migration scheme.
- Install
- Installs the resource definitions in the change package using the selected migration scheme.
- Newcopy
- Newcopies any map, partitionset, or program resource definitions in the change package using the selected migration scheme.
Discard
Discards the change package's resources from active CICS regions that are using those resources.
- Backout
- Backs out an earlier migration (no need to select a migration scheme).
- History
- Displays the processing history of the change package (no need to select a migration scheme).
- Notes
- If you selected the change package using line action S or E (Edit),
this command displays an ISPF edit panel where can write notes about
the change package. For example, special instructions for processing
the package.
If you selected the change package using line action V (View), this command displays an ISPF browse panel containing notes about the change package, if notes exist.
For a description of each process, and the order in which you should perform them, see Migration of resource definitions.
For more information about which CICS configurations are affected by an Install,
Newcopy, or Discard command, see Using change packages for actions and migrations.
The Package and List processing commands display a list panel of resource definitions similar to those shown by primary menu option 2 CICS Resources. For information on using these panels, see Working with resource definitions.
If an install or a newcopy action fails for any of the resource definitions in a change package, a pop-up window appears describing the reason for each failure. For a description of the return, reason, and error codes displayed, press the Help key (F1) and scroll down to the links for each type of code.