CHFILE view


To display general historical information about a task’s resource usage:

  • Hyperlink from the
    • File Data field on the EZCSHIST view
    • Files Used by Txn field on the CHISTDIO view
  • Issue the following command:

    CHFILE [*[regionName]]

    where * is a placeholder, and regionName is the name of an IBM CICS region.

Related topic

 

Warning

Note

When you enter the CHFILE command, the view lists all resources used by tasks that ended within the current BMC AMI Ops TIME duration.

The CHFILE view is displayed.

(BMC.AMIOPS.SPE2507)

W1 =CHFILE============BCVDS76C=*========30JUN2025==16:05:13====MVCICS===D===29=============================================
 Task    CICS   Lcl Task   Lcl Task Tran   File     File    Req    Time    Long Name
 Num    System  End Date   End Time  ID    Name     Type   Count
   237 BCVDS76C 30JUN2025  13:01:47 PDLC DFHSAM05    DBCTL     1    0.0000
   233 BCVDS76C 30JUN2025  13:01:31 MQPL >MQERR<  MQSERIES   846    0.2787 >MQERR<
   233 BCVDS76C 30JUN2025  13:01:31 MQPL CMRMQTST MQSERIES  1128    0.1986 CMRMQTST.MQTS.3.QUEUE
   233 BCVDS76C 30JUN2025  13:01:31 MQPL CMRMQTST MQSERIES  1128    1.2539 CMRMQTST.MQTS.2.QUEUE
   233 BCVDS76C 30JUN2025  13:01:31 MQPL CMRMQTST MQSERIES  1128    0.4538 CMRMQTST.MQTS.1.QUEUE
   233 BCVDS76C 30JUN2025  13:01:31 MQPL CMRMQTST MQSERIES   282    0.0810 CMRMQTST.MQTS.4.QUEUE.TEST1.TEST2.TEST3.TEST4.NM
   231 BCVDS76C 30JUN2025  12:57:41 FRN2 ADABAS01  ADABASE    13    0.0026 00021:00000
   231 BCVDS76C 30JUN2025  12:57:41 FRN2 ADABAS02  ADABASE    10    0.0087 00021:00008
   231 BCVDS76C 30JUN2025  12:57:41 FRN2 ADABAS03  ADABASE     3    0.0007 00021:00009
   231 BCVDS76C 30JUN2025  12:57:41 FRN2 ADATRUE    PSEUDO    32    0.0173
   231 BCVDS76C 30JUN2025  12:57:41 FRN2 CMRVS01  CICS FCT     3    0.0099
   231 BCVDS76C 30JUN2025  12:57:41 FRN2 CMRVS02  CICS FCT     3    0.0049
   230 BCVDS76C 30JUN2025  12:57:33 PFI2 CMRVS01  CICS FCT     3    0.0087
   230 BCVDS76C 30JUN2025  12:57:33 PFI2 CMRVS02  CICS FCT     3    0.0040
   225 BCVDS76C 30JUN2025  12:57:06 TSN1 TSMCOM1N      DB2     7    0.0873
   211 BCVDS76C 30JUN2025  12:43:25 FRN1 ADABAS01  ADABASE    18    0.0215 00021:00000
   211 BCVDS76C 30JUN2025  12:43:25 FRN1 ADABAS02  ADABASE    13    0.0324 00021:00008
   211 BCVDS76C 30JUN2025  12:43:25 FRN1 ADABAS03  ADABASE     3    0.0036 00021:00009      

Usage notes

The records are displayed from newest record to oldest record, based on the detach time of the tasks.

When hyperlinking on the File Name field, the actual view displayed depends on the record’s file type as indicated in the File Type field:

  • A value of CICS FCT displays the CHFILEDF view.
  • A value of MQSERIES displays the CHFILEDQ view.
  • A value of DB2 displays the CHFILEDD view.
  • A value of DBCTL displays the CHFILEDL view.
  • A value of ADABAS displays the CHFILEDA view

Related views

The following views are part of the CHFILE family of views.

 

View

Description

CHFILEQ

To display the Quick Menu for history file views, hyperlink from the Task Num field on the CHFILE view.

CHFILED

To display file usage detail information about the selected task, hyperlink from the Lcl Task End Date field on the CHFILE view.

CHFILEDF

To display CICS file usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEDQ

To display MQ Series queue usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEDD

To display DB2 plan usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEDA

To display Adabas file usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEDL

To display DBCTL PSB usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEZ

To display summarized information based on the File Name field, enter the SUM command from the CHFILE view.

  
Before applying BMC.AMIOPS.SPE2507. ​

The CHFILE view is displayed.

ddmmmyyyy  hh:mm:ss ------ BMC AMI Ops WINDOW INTERFACE(Vv.r.mm)--------------
COMMAND  ===>                                                 SCROLL ===> PAGE
CURR WIN ===> 1        ALT WIN ===>                                           
W1 =CHFILE============BCVDS71D=*========)ddmmmyyyy==hh:mm:ss===MVCICS===D==
Task    CICS   Lcl Task   Lcl Task Tran   File     File   Count   Time
Num    System  End Date   End Time  ID    Name     Type
19929 BCVDS71D 24JUN2016  09:21:04 MQGT QTS.4.QU MQSERIES     1    0.0000
19920 BCVDS71D 24JUN2016  09:20:25 TSN1 TSMCOM1N      DB2     7   10.2163
19913 BCVDS71D 24JUN2016  09:20:14 TSN1 TSMCOM1N      DB2     7    0.0012
19916 BCVDS71D 24JUN2016  09:20:13 ADA1 L1026248  ADABASE    21    6.2792
19916 BCVDS71D 24JUN2016  09:20:13 ADA1 R1026248  ADABASE    12    3.1338
19916 BCVDS71D 24JUN2016  09:20:13 ADA1 S1026248  ADABASE    20    1.0641
19916 BCVDS71D 24JUN2016  09:20:13 ADA1 T1026248  ADABASE    20    1.0503
19916 BCVDS71D 24JUN2016  09:20:13 ADA1 U1026248  ADABASE    20    1.0468
19916 BCVDS71D 24JUN2016  09:20:13 ADA1 V1026248  ADABASE    10    0.0001
19909 BCVDS71D 24JUN2016  09:20:13 ADA1 L1026248  ADABASE    21    6.2892
19909 BCVDS71D 24JUN2016  09:20:13 ADA1 R1026248  ADABASE    12    3.1438
19909 BCVDS71D 24JUN2016  09:20:13 ADA1 S1026248  ADABASE    20    1.0480
19909 BCVDS71D 24JUN2016  09:20:13 ADA1 T1026248  ADABASE    20    1.0503
19909 BCVDS71D 24JUN2016  09:20:13 ADA1 U1026248  ADABASE    20    1.0465
19909 BCVDS71D 24JUN2016  09:20:13 ADA1 V1026248  ADABASE    10    0.0003  

Usage notes

The records are displayed from newest record to oldest record, based on the detach time of the tasks.

When hyperlinking on the File Name field, the actual view displayed depends on the record’s file type as indicated in the File Type field:

  • A value of CICS FCT displays the CHFILEDF view.
  • A value of MQSERIES displays the CHFILEDQ view.
  • A value of DB2 displays the CHFILEDD view.
  • A value of DBCTL displays the CHFILEDL view.

Related views

The following views are part of the CHFILE family of views.

 

View

Description

CHFILEQ

To display the Quick Menu for history file views, hyperlink from the Task Num field on the CHFILE view.

CHFILED

To display file usage detail information about the selected task, hyperlink from the Lcl Task End Date field on the CHFILE view.

CHFILEDF

To display CICS file usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEDQ

To display MQ Series queue usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEDD

To display CICS file usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEDL

To display CICS file usage details, hyperlink from the File Name field on the CHFILE view.

CHFILEZ

To display summarized information based on the File Name field, enter the SUM command from the CHFILE view.

 

 

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

BMC AMI Ops Monitor for CICS 7.5