Querying Change Packages
When you query change packages, complete the following tasks:
-
Specify package selection criteria on the Package Parameters (CMNQRY00) panel.
-
Select a package from the filtered Package List (CMNQRY02) panel.
-
Use the Package Information (CMNQRY03) panel to request different types of query information for the package you selected.
Specifying Selection Criteria
Access the Package Parameters (CMNQRY00) panel, to specify selection criteria that will be used in ChangeMan ZMF to create a filtered change package list for you.
-
Select Option P Package on the Query Options menu to display the Package Parameters panel.
CMNQRY00 Package Parameters Command ===> _____________________________________________ Package list (Blank, full name or mask separated by ;) ______________________________________________________________________ Enter "/" to select: Package status / Dev _ Frz _ Apr _ Rej _ Dis _ Ins _ Bas _ Bak _ Del _ Opn _ Clo _ Tcc _ Aip _ Xds _ Xin _ Xbk _ Xrv Package level / Simple _Super _ Complex _ Participating Package type / Planned Permanent _ Planned Temporary _ Unplanned Permanent _ Unplanned Temporary Work request . . . . . . ____________________________ Department . . . . . . . ___ Install date: From . . . ________ To . . ________ (YYYYMMDD) Creation date: From . . ________ To . . ________ (YYYYMMDD) Site . . . . . . . . . . ________ Approver entity . . . . ________ Creator's id list (Blank, full name or mask separated by ;) ____________________________________________________________________ Enter "/" to select option _ Other parameters -
Complete information in the selection criteria fields. This information limits the range of packages displayed in the Package List. Fill in any combination of these fields to limit your search. To limit the range of packages displayed by specific applications, leave the package list field blank (or specify a pattern).
The following table describes the fields on this panel. All field entries are optional. If you leave any field blank, all change packages in the system that satisfy the specified selection criteria are presented.
Field Description Package list Enter a list of package IDs or patterns to select, separated by semicolon (;). Package status Select status for the package(s) you want to query. Package level Select to include package level; only packages with selected level will be listed. Package type Select to include package type; only packages with selected type will be listed. Work request Enter a Work request to review change packages with that identifier (if entered at package creation time). Department Enter a Department to review change packages with that identifier (if entered at package creation time). Installation date range: Specify a date range. Only change packages with an installation date during the time period specified will be listed. Both dates are inclusive: Install date: From Enter the start date for a scheduled installation date selection period in YYYYMMDD format. Leaving the date blank is the same as typing 00000000. (install date) To Enter the end date for a scheduled installation date selection period in YYYYMMDD format. The date is inclusive. Leaving the date blank is the same as typing 99999999. Creation date range: Specify a date range. Only change packages with a creation date during this time period specified will be listed. Both dates are inclusive: Create date: From Enter the start date for a package create date selection period in YYYYMMDD format. Leaving the date blank is the same as typing 00000000. (creation date) To Enter the end date for a package create date selection period in YYYYMMDD format. The date is inclusive. Leaving the date blank is the same as typing 99999999. Site Enter an installation site name to review change packages. Approver entity Enter an approver entity to review change packages with that identifier. Note: Entities in the planned approval list are added to unplanned packages after they are baselined. Creator id list Enter a tso-id or a pattern. Wild-card characters are * for masking multiple characters and? for a place-holder for one character. Enter more parameters Select to display the EXTENDED SEARCH CRITERIA (CMNQRY01) panel.
...
Using the Extended Search Criteria Panel
The Extended Search Criteria (CMNQRY01) panel is displayed if you select Enter More Parameters field on the Query Package Parameters panel. It lets you further limit the display of change packages by the kinds of components the change package contains.
CMNQRY01 Extended Search Criteria
Command ===> ___________________________________________
Enter "/" to select:
Component records / Nonsource __Source __Load
Rename __Scratch __Form
Scheduling system / CMN __Manual __Other
Component type . . . . . _______________
Promoted Component . . . ____ (1–YES, 2–No)
Component name list (Blank, Full name or Mask separated by ;)
___________________________________________________________________
Component userid list (Blank, Full name or Mask separated by ;)
___________________________________________________________________
Release id list (Blank, Full name or Mask separated by ;)
___________________________________________________________________
The following table describes the fields on this panel. All field entries are optional. If you leave any field blank, all change packages in the system that satisfy the specified selection criteria are presented.
| Field | Description |
|---|---|
| Component records | Select package component category. |
| Scheduling system | Select installation scheduler. |
| Component type | Select component type or pattern. |
| Promoted Component | Select whether to include packages that have promoted components. |
| Component name list | Enter a list of component names or patterns to select, separated by semicolons (;). The maximum length of each component name or mask is 16 characters. |
| Component user id list | Enter TSO id or pattern separated by semicolons (;). |
| Release id list | Enter release id or patterns to select, separated by semicolons (;). |
Field values within a specific field, such as Component Records, are combined with logical OR operators; the results of using patterns in such fields as Release ID List are also combined with logical OR operators.
Press Enter. The Package List (CMNQRY02) panel is displayed.
Browsing the Query Package List
When ChangeMan ZMF finishes processing your filter criteria, it displays the Package List (CMNQRY02) panel.
CMNQRY02 Package List Row 1 to 20 of 29
Command ===> __________________________________ Scroll ===> CSR
Package Sta Install Lvl Type Work request Dept Promote Aud Creator
__ ACTP000001 BAS 20141121 SMP PLN/PRM IDD 00 USER016
__ ACTP000002 BAS 20150104 SMP PLN/PRM 123 BOO 00 00 USER016
__ ACTP000003 BAS 20150105 SMP PLN/PRM 123 BOOK 00 00 USER016
__ ACTP000004 BAS 20141121 SMP PLN/PRM 123 BOOK 00 USER016
__ ACTP000005 BAS 20150105 SMP PLN/PRM 123 BOOK 00 00 USER016
__ ACTP000006 BAS 20141121 SMP PLN/PRM 123 BOOK 00 USER016
__ ACTP000007 BAS 20141121 SMP PLN/PRM 100001000106 TEST 00 USER016
__ ACTP000008 BAS 20141121 SMP PLN/PRM 100001000106 TEST 00 20 USER017
__ ACTP000013 BAS 20150105 SMP PLN/PRM IDD 00 04 USER017
__ ACTP000016 BAS 20150104 SMP PLN/PRM 100001000106 TEST 00 00 USER016
__ ACTP000018 BAS 20150105 SMP PLN/PRM IDD 00 00 USER016
__ ACTP000020 BAS 20150104 SMP PLN/PRM 100001000106 IDD 00 04 USER016
__ ACTP000021 BAS 20150106 SMP PLN/PRM IDD 00 00 USER016
__ ACTP000023 BAS 20150105 SMP PLN/PRM 100001000106 IDD 00 04 USER016
__ ACTP000024 BAS 20141218 SMP PLN/PRM 100001000106 IDD 00 00 USER016
__ ACTP000025 BAS 20150105 PAR PLN/PRM 100001000106 IDD 00 00 USER016
__ ACTP000026 CLO CMP PLN/PRM 100001000106 IDD 00 08 USER016
__ ACTP000027 FRZ 20150228 SMP PLN/PRM 100001000106 IDD 00 00 USER016
__ ACTP000028 DIS 20150228 SMP PLN/PRM 100001000106 IDD 00 00 USER016
__ ACTP000029 OPN CMP PLN/PRM 100001000106 IDD 00 00 USER016
Note
If only one package satisfies the filtering criteria that you have specified,ChangeMan ZMF displays the Package Information panel instead of the Query Package List. See Displaying Detailed Package Information.
When the Package List panel is displayed, the panel shows a shortened list of change package information. You can:
-
Enter the S line command in the line command field of selected package IDs to display detailed information about those packages. See Displaying Detailed Package Information.
-
Switch between the short and long viewing modes in the Package List:
-
Enter LONG at the command line if you want to display the package description in addition to the other information that is displayed on the short list.
-
Enter SHORT if you want to condense the information in the long list. The package description is not displayed on the sort list.
-
-
Sort on any column heading (SHORT viewing mode only) by specifying the following command on the command line:
SORT column_heading
where column_heading is the column heading. For example, specify SORT INSTALL to display packages in ascending sequence by install date.
-
If you have sorted the entries in a column, you can use the LOCATE command to locate an entry in that column. For example, if you have previously sorted on the INSTALL column, you can specify LOCATE 20061215 to locate the first entry with an install date of December 15, 2006.
Displaying Detailed Package Information
If you enter S to the left of one or more Package IDs on the preceding Query Package List, the Package Information (CMNQRY03) panel is displayed.
CMNQRY03 Package Information
Option ===> ____________________________________________________________ More: +
Package: DEMO000001 Status: DEV Install date: 20220101
Creator: USER001 Audit RC: 00
1 General General
2 Non-Source Non-Source
3 Source Source
4 Source to Load Source to Load Relationship
5 Work List Component Userid Work List
6 Utilities Renames and Scratches
7 Approvals Approval List
8 Install Dates Site/Install Date Information
9 Site Activity Site Activities Date and Time
10 Online Forms Online Forms
11 Participating Participating Packages
12 Status Status Start Date and Time
13 Revert Reasons Revert Reasons
14 Backout Reason Backout Reasons
15 Promo History Promotion History
16 Promo Libs Promotion Libraries
17 Dev Stg Libs Development Staging libraries
18 Prod Stg Libs Production Staging libraries
CMNQRY03 Package Information
Option ===> _________________________________________________More: -
2 Non-Source Non-Source
3 Source Source
4 Source to Load Source to Load Relationship
5 Work List Component Userid Work List
6 Utilities Renames and Scratches
7 Approvals Approval List
8 Install Dates Site/Install Date Information
9 Site Activity Site Activities Date and Time
10 Online Forms Online Forms
11 Participating Participating Packages
12 Status Status Start Date and Time
13 Revert Reasons Revert Reasons
14 Backout Reason Backout Reasons
15 Promo History Promotion History
16 Promo Libs Promotion Libraries
17 Dev Stg Libs Development Staging libraries
18 Prod Stg Libs Production Staging libraries
19 Production Production Libraries
20 Baseline Baseline Libraries
21 IMS IMS Information
22 Reject Reasons Reject Reasons
This table describes the fields on the Package Information panel (CMNQRY03).
Select an option to display the desired information.
| Field | Description |
|---|---|
| Package | The current package id. |
| Status | The current package status. |
| Install date | The scheduled installation date (yyyymmdd format) of the package. Note: If the package has been installed, the ACTUAL installation date can be viewed within the Site Activities Date/Time or Status Start Date/Time categories of the Query Package Option. Package installation date will vary depending on the scheduler used. |
Options: Selecting any of the following options displays information specific to your package.
| General | Display general package information, such as description, install date and time, requestor name, phone number, and department. |
| Non-Source | Display non-source components in the package: copybook members, cataloged JCL procedures, linkage editor control statements, control cards, and documentation. |
| Source | Display source component staging information. |
| Source to Load Relationship | Display components and their related components. |
| Component Userid Work List | Display a list of userids that have worked on a component. |
| Note:** This option is available only if your administrator has enabled the ChangeMan ZMF Component Work Record facility. | |
| Renames and Scratches | Display package utility requests. |
| Approval List | Display package approval list. |
| Site/Install Date Information | Display site information. |
| Site Activities Date and Time | Display starting date and time stamp of activities that were performed at the site. |
| Online Forms | Display online forms information. |
| Note:** This option is available only if you license the ChangeMan ZMF Online Forms option. | |
| Participating Package(s**) | Display individual application packages (participating packages) that make up this complex/super package. |
| Status Start Date and Time | Display all possible statuses for the package, as well as the date and time that the package was assigned the status. |
| Revert Reasons | Display the revert history, all of the reasons the package was reverted. |
| Backout Reasons | Display the backout history, all of the reasons the package was backed out. |
| Promotion History | Display promotion/demotion history of the package, listed in reverse chronological order. |
| Promotion Libraries | Display the level and data set names of the promotion libraries for the application. |
| Development Staging Libraries | Display the data set name of the development environment staging libraries for the package. |
| Production Staging Libraries | Display the data set name of the production environment staging libraries for the package. |
| Production Libraries | Display the data set name of the production libraries affected by the package. |
| Baseline Libraries | Display the data set name of the baseline libraries affected by the package. |
| IMS Information | Display IMS Option information. Note: This category is available only if you license the ChangeMan ZMF IMS Option. |
| Reject Reasons | Display the reasons the package was rejected. |
Note
Options may not be available if they are not licensed, are disabled or there is no information to display for the package.
See Package Category Panels for an example of each Package Category panel.