CICS Program Inventory Maintenance screen


The CICS Program Inventory Maintenance screen allows users to perform actions on the Program Inventory file. Access to the CICS Program Inventory Maintenance screen occurs when users choose option C from the Utilities-menu.

Use of the CICS Program Inventory Maintenance function requires that Program Inventory data sets, application load libraries, and CICS source listing data sets were specified in the Code Coverage Defaults (Code Coverage Option 0) CICS CODE COVERAGE section.

CICS Program Inventory Maintenance Screen

-------- CODE COVERAGE 17.02 - CICS PROGRAM INVENTORY MAINTENA Row 1 to 3 of 3
Command ===>                                                  Scroll ===> PAGE

Line Cmds:    CO (collect), C (copy), D (delete), EX (export), U (undo)
Primary Cmds: POPulate, COPY , EXPort, IMPort, END (process), UPDate,
              CANcel, Refresh , Sort

Inventory file ===> 'ACMJET0.PGMINV.TEST'
      Edit JCL ===> NO  (Batch mode: Yes/No)                          More ->

CMD Module   CSECT    Compile Date/Time   Lang/Opt  Verbs   Collect  Status
--  -------- -------- -------------------   -----  ------     ---   ----------
__ ASMPGM   ADDOPER  2013/08/18 14:01:00   ASM/N       9     ON
__ ASMPGM   ASMPGM   2013/08/18 14:01:00   ASM/N      46     ON
__ ASMPGM   SUBOPER  2013/08/18 14:01:00   ASM/N       9     ON
******************************* Bottom of data ********************************

The Program Inventory Maintenance screen also scrolls right, allowing users to view the source listing file and member associated with each chosen CSECT.

CICS Program Inventory Maintenance Screen, scrolled right

-------- CODE COVERAGE 17.02 - CICS PROGRAM INVENTORY MAINTENA Row 1 to 3 of 3
Command ===>                                                  Scroll ===> PAGE

Line Cmds:    CO (collect), C (copy), D (delete), EX (export), U (undo)
Primary Cmds: POPulate, COPY , EXPort, IMPort, END (process), UPDate,
              CANcel, Refresh , Sort

Inventory file ===> 'ACMJET0.PGMINV.TEST'
     Edit JCL ===> NO  (Batch mode: Yes/No)                          <- More

CMD Module   CSECT    Source Listing File                          Member
--  -------- -------- -------------------------------------------- -----------
__ ASMPGM   ADDOPER  XD.TEST.R77.CX800.SHRDIR1                    ASMPGM
__ ASMPGM   ASMPGM   XD.TEST.R77.CX800.SHRDIR1                    ASMPGM
__ ASMPGM   SUBOPER  XD.TEST.R77.CX800.SHRDIR1                    ASMPGM
******************************* Bottom of data ********************************

Tip

Excluded from the actions allowed from a batch job is the GENERATE command. Equivalent functionality can be created using wildcard entries for COLLECT statements.

Line commands

The line commands are defined as follows:

Command

Description

CO

Collect. Toggles the collection status on and off. The status message displayed is “COLL PEND”.

C

Copy. Marks records selected for copy to another program inventory file from the current one. The status message displayed is “COPY PEND”.

D

Delete. Removes an entry From the inventory file and from the displayed table. The status message displayed is “DEL PEND”.

EX

Export. Marks the records selected for export to the export file from the current inventory file. The status message displayed is “EXPRT PEND”.

U

Undo. Removes a pending action.

Primary commands

The primary commands are defined as follows:

Command

Description

POPulate

Adds members to the current CICS Program Inventory file. When issued, this command displays the Program Inventory Populate Popup Window described.

COPY

Copies records from one Program Inventory file to another. When issued, this command displays the Program Inventory File Copy Popup Window.

EXPort

Extracts records from a Program Inventory file into a sequential data set. When issued, this command displays the Program Inventory File Export Popup Window.

IMPort

Moves records from a previously exported file to the current Program Inventory file. When issued, this command displays the Program Inventory File Import Popup Window.

LEFT

Shifts the detail lines of the CICS Program Inventory Maintenance screen to the left because the data on the screen exceeds 80 columns. The module and CSECT columns are stationary and the data to the right of these columns shifts left.

LOCATE

The LOCATE command is used to position CICS Program Inventory Maintenance display to the requested module. The format is LOCATE module name, where the module name may be a complete name or a partial name. The LOCATE command may be abbreviated as L. If the module name is omitted, the display is positioned at the top of data. If the module name is an exact match of a module in the display, then that module is positioned at the top of the display. If the module name contains a partial module name, such as “LOCATE CW” (or if the module name cannot be located in the display) then the display is positioned at the module preceding the first module beginning with CW.

END

Processes the pending lines and indicates if updates were successfully processed, then returns to the previous screen. All pending line commands are processed before exiting the current screen.

UPDate

Updates the CICS Program Inventory maintenance file for pending deletes and collection status changes. The UPDATE command may be abbreviated as UPD. If the “Edit JCL” parameter is set to No, then the JCL is submitted automatically.

CANcel

Discards all pending lines and exits without processing.

Refresh

Reloads the inventory file directory displayed on the screen. The Refresh command can be abbreviated R. Use this command any time the contents of the CICS Program Inventory file changes (for example, after submitting a job to delete records or change the collection status).

RIGHT

Shifts the detail lines of the CICS Program Inventory Maintenance screen to the right because the data on the screen exceeds 80 columns. The module and CSECT columns are stationary and the data to the right of these columns shifts right.

Sort

Allows sorting of the CICS Program Inventory Maintenance display using the following syntax:
Sort <column name> (A/D)
where (A/D) represents either Ascending or Descending sorting order. The default is Ascending. The following parameters can be used for the <column name>:

Parameter

Description

MODULE

load module name (default)

CSECT

CSECT name

COMPILE

compile date and time

LANG

programming language

VERBS

number of verbs in program

COLLECT

collection status

SOURCE

source listing file

MEMBER

source member name

If no parameter is given with the sort command, sorting defaults to the load module name in ascending order. The Sort command can be abbreviated S.

Output fields

The output fields are defined as follows:

Field

Description

Module

The CICS load module to be code covered.

CSECT

The control section (CSECT) within the load module to be covered.

Compile DATE/TIME

The date and time the CSECT was processed using BMC’s listing processor.

Lang/Opt

The recorded value of the language compiler and whether or not it is optimized by the compiler. Possible values are:

Option

Description

ASM/N

the CSECT is Assembler and not optimized

CBL/N

the CSECT is COBOL and not optimized

PLI/N

the CSECT is PL/I and is not optimized

UND/N

the CSECT’s language is undefined

CBL/Y

the CSECT is COBOL and is optimized

PLI/Y

the CSECT is PL/I and is optimized

Verbs

The number of verbs in the program.

Collect

Whether or not Code Coverage collection will be allowed.

Status

Whether or not a line command is pending execution.

Source listing file

The BMC source listing file containing the compiled listing for the CSECT.

Member

The member name in the BMC source listing file for this CSECT.

Input fields

The input fields are defined as follows:

Field

Description

Cmd

Specifies one of the available line commands next to the module you want to affect. See Line Commands for details of each command that can be entered in this field.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*