Querying Components

To search and display component history information, take the following steps:

From the Primary Option Menu, select Option Q Query. The Query Options (CMNQDMNU) panel is displayed.

From the Query Options panel, select Option C Component. The Query Component Parameters (CMNQCMP1) panel is displayed.

CMNQCMP1        Query Component Parameters
Command ===> __________________________________________________

Specify selection criteria:
Component name . . . . . . ___________________________________________ +
                                (Full component name or pattern)
Component type . . . . . . SRC  (Full library type or pattern)
Application . . . . . . .  _____
Package . . . . . . . . .  ____________

Enter "/" to select:
    Package status . . . .  _ Dev _ Frz _ Apr _ Rej _ Dis _ Ins
                            _ Bas _ Bak _ Del _ Opn _ Clo _ Tcc _ D/A
                            _ Aip _ Xds _ Xin _ Xbk _ Xrv
    Package type . . . . .  _ Planned Permanent   _ Planned Temporary
                            _ Unplanned Permanent _ Unplanned Temporary

Procedure name . . . . . . __________________
User . . . . . . . . . . . __________________
Checkout/staging
    From date . . . . . . .    __________________ (YYYYMMDD)
    To date . . . . . . . .    __________________ (YYYYMMDD)

Enter "/" to select option:
    _ Include deleted components
    / Mixed case

The QUERY function allows you to obtain a list of components and review the component information. You can list all of the components in the system, or you can specify "search" criteria that allows you to list only those components that meet the search criteria.

Fill in any of the following fields to specify which components you wish to review. If you want to see all the components in the system, enter asterisks in component name and library type fields, and leave blanks in the rest of the selection criteria fields.

This table describes the fields on the Query Component Parameters panel (CMNQCMP1).

Field	Description
Component name	Enter a full component name to select, or type a pattern or a wildcard * to display a selection list. Blank is not valid.
Component type	Enter a full library type to select, or type a pattern or a wildcard * to display a selection list. Blank is not valid.
Application	Enter a full 3- or 4-character application mnemonic to select, or leave blank for all applications.
Package	Enter a full 10-character package ID to select, or leave blank for all packages.
Package Status	Enter / to select the package status.
Package Type	Enter / to select the package type.
Procedure name	Enter a full build procedure name to select, or leave blank for all build procedures. Build procedure names are associated with like-source components and all build processing output types.
User	Enter a full TSO ID to select, or leave blank for all IDs. The ID in component history is the last person to check out, stage, recompile, or relink the component in the package, or the last person to submit a SCRATCH/RENAME utility request for the component in the package.
Checkout/staging From date To date	Enter inclusive selection FROM and/or TO dates YYYYMMDD, or leave blank for all dates. The date being selected is the date of the last checkout, stage, relink, recompile, or SCRATCH/RENAME utility request for the component in the package.
Include baseline/ archive packages	Select to view all historical information including baselined and archived packages. NOTE: Historical information for components that have been deleted within a package are not reported for either display mode.
Include deleted components	If this option is selected, entries on panel CMNCMPH1 for components deleted from a package display with "*DELETED" in the Setssi column.
Mixed case	Select to process COMPONENT NAME input exactly as you type it, upper and lower case. If not selected, by default, all fields are folded to upper case.

Complete the selection criteria and press Enter. If you use a wildcard or pattern in the COMPONENT NAME field or the COMPONENT TYPE field, the Component List (CMNQCMP2) panel is displayed.

CMNQCMP2        Component List          Row 22 to 24 of 24
Command ===> ______________________________ Scroll ===> CSR

    Lib Name                                                    +
__ SRS ACPSRS1B
__ SRS ACPSRS1C
__ SRC ACPSRC91
******************************* Bottom of data ********************************

To display the package history for one or more components, enter S in the line command for each component that you want to query, and press Enter. The Component History (CMNCMPH1) panel is displayed, showing component history for the first component that you selected.

CMNCMPH1        Component history               Row 1 to 1 of 1
Command ===>___________________________________ Scroll ===> CSR

Component: ACPSRC91.SRC


    Package    Sta P Promotion vv.mm Last action Size Setssi  User
__ ACTP000032 DEV R                 2015/01/12 21:29 *RENAME USER016
******************************* Bottom of data ********************************

Notice that some panel fields depend on the library type. This panel displays component history for library type LOD for the same SRC component above.

CMNCMPH1        Component history          Row 1 to 5 of 5
Command ===> ____________________________  Scroll ===> CSR

Component: ACPSRC91.LOD

    Package    Sta P Promotion vv.mm Last action      Size  Setssi   User
__ ACTP000033 DEV             01.00 2015/01/09 21:04 00012 678039CE USER016
__ ACTP000028 DIS             01.01 2015/01/20 21:47 00012 678EC447 USER016
__ ACTP000020 BAS             01.00 2015/01/04 23:44 00012 6779C776 USER016
__ ACTP000013 BAS             01.00 2015/01/05 15:01 00012 677A9E06 USER016
__ ACTP000001 BAS             01.01 2014/11/19 03:10       673C0181 USER016
******************************* Bottom of data ********************************

This table describes the fields on the Component History panel (CMNCMPH1).

Field	Description
Package	All other packages that have referenced this component. 'NO PACKAGE' indicates that the component was listed by Impact Analysis of the Baseline libraries.
Sta	The current status of the change package:
	DEV: Development
	FRZ: Frozen, awaiting approval
	APR: Approved by all required approvers
	REJ: Rejected by an approver
	DIS: Distributed to site(s)
	D/A: Deleted or archived during housekeeping or maintenance
	INS: Installed at production site(s)
	TCC: Temporary change cycled (temporary package removed)
	BAS: Baselined BAK Backed out
	BAK: Backed out
	AIP: Approval In Process
	XDS: Package distribution has failed
	XIN: Package installation has failed
	XRV: Package revert has failed
	XBK: Package backout has failed
P	Processing type for the specified component in the package:
	O: Checked out
	I: Checked in
	Built: (staged) Recompiled component (like-source library types only)
	L: Relinked component (like-load library types only)
	S: Scratch request created
	R: Rename request created
Promotion	The common name for the promotion library, and the level reached, if the package has been promoted. 'STAGING' denotes the package has been subsequently demoted. After full demote, the level is 00. If a library type is not defined to promotion (for example, a like-source type), no data is displayed.
vv.mm	Version number (01 to 99 and then back to 00) and modification number (01 to 99) represent the same "VV.MM" headers of the Staging Libraries when browsing the directory entries - PDF Browse of a PDS.
Last action	Date and time the component was last acted upon (checked out, staged, frozen, etc..)
Size	Lines of code for most component types. Otherwise LOD module size.
Setssi	SETSSI for the component in the package; the 4-byte binary stamp placed on the module by ChangeMan (or taken from a prior placement).
User	Identification of the last person to check out or stage the component.

Line commands:

The Q (query) command will display the Package Information in the same manner as if the user had entered the Q.P. (query package) function.

The P(Process) command will place the user in the staging panel allowing them to enter staging commands against the selected component. This is the same as if the user had entered the staging option 3 and the component name and type will be filled in for you.

The C(Checkout) command will place the user at the checkout options panel. From there they can select the checkout option they wish to perform. The package name is passed as well as the component name and type selected. The package name is available to be changed just in case they wish to checkout to another package.

Regardless of the checkout option specified the panels following the option selection will automatically fill in the component name and type. If this is a checkout from package the source package will be the selected package of the component from the history list.

The S(select) command will display component build data for this component taken from the component history information. To display detailed information about the component in one or more packages, enter S in the line command for each package you want displayed, and press Enter. In this example, the Compile and Binder Options (CMNCMPH2) panel is displayed.

CMNCMPH2            Compile and Binder Options
Command ===> ___________________________________________

    Package: ACTP000033     Status: DEV     Install Date: 20150118

Stager's userid . . . . . USER016
Component name . . . . .  ACPSRC91 +
Component type . . . . .  LOD
Language . . . . . . . .  COBOL2
Compile proc . . . . . .  CMNCOB2
Compile parms . . . . . .
Binder parms . . . . . .
Db2 processing . . . . .  NO

Enter "/" to select option:
__Additional user options