CICS Program Inventory Maintenance screen
Related Topics
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
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
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 ********************************
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:
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:
| ||||||||||||||
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. |