CBAM - BTS browser

Use CBAM to browse the CICS® business transaction services (BTS) objects (process-types, processes, activities, containers, events and timers) known to the region.

Function overview

CBAM is a menu-driven transaction. The menus are hierarchically organized. By navigating downwards through the menus, you can display the following information:

All the process-types that have been defined to this region with installed PROCESSTYPE definitions.
All the processes of a selected process-type. These processes are the processes of the selected type that currently exist on the repository data set pointed to by the installed PROCESSTYPE definition.
Note: If you are operating BTS in a sysplex and the repository is shared with one or more other regions, some of the processes might have been defined on other regions.
The constituent activities of a selected process.
The details (program, transaction ID, user ID) of a selected activity.
One of the following resources:
- The containers associated with a selected activity or process, or
- The events in an event pool of the selected activity, or
- The timers defined to a selected activity.

Note: This overview of the CBAM menu hierarchy is slightly simplified. Selectable fields allow you to bypass some screens.

CBAM is a read-only transaction; you cannot update any of the displayed attributes by over typing them.

Running CBAM

Start the CBAM browser transaction by typing CBAM on the command line and pressing the ENTER key. This gives you a list of all the process-types that have been defined to this region.

CBAM screens

Process-types screen: The Process-types screen lists the process-types defined to a region and shows the CICS repository file name, process-type status, and the level of audit logging.
Processes screen: The Processes screen lists the process names, the mode of a process, the completion status, whether a process is suspended, and lists process containers for the process named in the process field.
Activities screen: The Activities screen lists the activity names, the activity mode, the completion status, and whether a process is suspended.
Activity details screen: The Activity details screen lists the name of the program that implements the selected activity, the transaction identifier, and the user ID under which the activity runs.
Containers screen: The Containers screen lists each container associated with a specified process or activity and shows the length, in bytes, of the data contained in it.
Events screen: The Events screen lists the events in the specified event pool of the activity. The events listed are the events that are currently in the event pool. Events that have been deleted do not appear in the list.
Timers screen: The Timers screen lists the timers that are currently defined to a specified activity and shows their status.

Process-types screen

The Process-types screen lists the process-types defined to a region and shows the CICS repository file name, process-type status, and the level of audit logging.

If you place the cursor on the name of a process-type, or anywhere on the same line, and press ENTER, you get a list of all the processes of that type that currently exist on the repository data set pointed to by the installed PROCESSTYPE definition; see Processes screen.

Figure 1. CBAM transaction: initial screen, showing the process-types defined to this region

 CBAM
 
   Processtype File     Status   Auditlevel
 
   CBTSAUDA    DFHBARF  Enabled  Activity
   CBTSSHR     DFHBSHR  Enabled  Off
   CBTSSHRF    DFHBSHR  Disabled Activity
   CBTSSHR2    DFHBSHR2 Disabled Off
   MORTLOANS   DFHMORT  Enabled  Process
 
 
 
 
  Use cursor and Enter for Processes
 
 PF3=Return   7=Back   8=Forward

Fields in CBAM process-types screen

Auditlevel

The level of audit logging currently active for processes of this type:

Activity

Activity-level auditing. Audit records are written from the following points:

The process audit points
The activity primary audit points

Full

Full auditing. Audit records are written from the following points:

The process audit points
The activity primary and secondary audit points

Off

No audit records are written.

Process

Process-level auditing. Audit records are written from the process audit points only.

For details of the records that are written from the process, activity primary, and activity secondary audit points, see Specifying the level of audit logging.

File

The CICS repository file on which records for processes of this type are stored.

Processtype

The name of a process-type.

Status

Whether the PROCESSTYPE is enabled or disabled — that is, whether new processes of this process-type can be defined.

Processes screen

The Processes screen lists the process names, the mode of a process, the completion status, whether a process is suspended, and lists process containers for the process named in the process field.

If you place the cursor on the name of a process and press ENTER, you get a list of the process's constituent activities; see Activities screen.

Figure 2. CBAM transaction: processes screen

 CBAM                                           Processtype MORTLOANS
 
   Process                              Mode       Comp       Susp    Conts
 
   MORT000000014                        Dormant    Incomplete No       _
   MORT000000015                        Complete   Forced     No       _
   MORT000000016                        Dormant    Incomplete Sus      _
   MORT000000017                        Active     Incomplete No       _
   PERS000000114                        Initial    Incomplete No       _
 
 
 
 
  Use cursor and Enter for Activities or Containers (tab to Conts)
 
 PF3=Return   7=Back   8=Forward

Fields in CBAM processes screen

Comp

The completion status of the process. Supported values are as follows:

Abend: The program that implements the root activity abended.
Forced: The process was forced to complete. For example, it was canceled with a CANCEL ACQPROCESS command.
Incomplete: The process is incomplete.
Normal: The process completed normally.

Conts

A selectable field. If you place the cursor on this field and press ENTER, you get a list of the process-containers for the process named in the Process field. For an example of the CBAM Containers screen, see Containers screen.

Mode

The mode of the process. Supported values are listed below. For an explanation of each of these modes, see Processing modes.

Active
Canceling
Complete
Dormant
Initial

Process

The name of a process.

Susp

Whether the process is currently suspended:

No: The process is not currently suspended.
Sus: The process is currently suspended.

Activities screen

The Activities screen lists the activity names, the activity mode, the completion status, and whether a process is suspended.

If you place the cursor on the name of an activity and press ENTER, you get details of the activity; see Activity details screen.

Figure 3. CBAM transaction: activities screen

 CBAM         Process MORT000000017                 Processtype MORTLOANS
 
   Activity                                       Mode       Comp       Susp
 
   DFHROOT                                        Dormant    Incomplete No
     NEWMORT                                      Complete   Normal     No
     PAYMENT-RECEIVED                             Complete   Normal     No
     PAYMENT-OVERDUE                              Complete   Normal     No
     INTEREST-CHANGE                              Complete   Normal     No
     CAPITAL-REPAYMNT                             Dormant    Incomplete No
       Credit-Account                             Complete   Normal     No
       Adjust-Interest                            Active     Incomplete No
 
 
 
 
  Use cursor and Enter for details
 
 PF3=Return   7=Back   8=Forward

Fields in CBAM Activities screen

Activity

The name of an activity. The list of constituent activities is indented. The amount by which an activity is indented represents its level in the process's activity tree.

Comp

The completion status of the activity. Supported values are as follows:

Abend: The activity abended.
Forced: The activity was forced to complete. For example, it was canceled with a CANCEL ACTIVITY command.
Incomplete: The activity is incomplete.
Normal: The activity completed normally.

Conts

Mode

The mode of the activity. Supported values are listed below. For an explanation of each of these modes, see Processing modes.

Active
Canceling
Complete
Dormant
Initial

Susp

Whether the activity is currently suspended:

No: The activity is not currently suspended.
Sus: The activity is currently suspended.

Activity details screen

The Activity details screen lists the name of the program that implements the selected activity, the transaction identifier, and the user ID under which the activity runs.

Figure 4. CBAM transaction: activity details screen

 CBAM         Process MORT000000017                   Processtype MORTLOANS
 
   Activity DFHROOT
 
   Program    MORTGAGE
   Transid    MORT
   Userid     CBTSMOR
 
 
   Containers
   Events
   Timers
 
 
 
 
 Use cursor and Enter for Containers, Events or Timers
 
PF3=Return   7=Back   8=Forward

There are also three selectable fields:

Containers: Pressing ENTER on this field displays a list of the containers associated with the selected activity. For more information, see Figure 6.
Events: Pressing ENTER on this field displays a list of the events in the event pool of the selected activity. For more information, see Figure 7.
Timers: Pressing ENTER on this field displays a list of the timers defined to the selected activity. For more information, see Figure 8.

Containers screen

The Containers screen lists each container associated with a specified process or activity and shows the length, in bytes, of the data contained in it.

Figure 5. CBAM transaction: containers screen for a process

 CBAM         Process MORT000000017                       Processtype MORTLOANS
 
   Container        Datalength
 
   ACCOUNT-NO               36
   BORROWER-INFO          1000
 
 
 
 
   PF3=Return   7=Back   8=Forward

Figure 6. CBAM transaction: containers screen for an activity

 CBAM         Process MORT000000017                       Processtype MORTLOANS
 
   Activity DFHROOT
 
   Container        Datalength
 
   STATUS                  500
 
 
 
 
  PF3=Return   7=Back   8=Forward

Events screen

The Events screen lists the events in the specified event pool of the activity. The events listed are the events that are currently in the event pool. Events that have been deleted do not appear in the list.

Figure 7. CBAM transaction: events screen

 CBAM         Process MORT000000017                       Processtype MORTLOANS
 
   Activity DFHROOT
 
   Event            Type      Fired  Composite       Timer
 
   ALL-TIMERS       Composite Yes    OR
   ANNUAL-STATMNT   Timer     Yes    ALL-TIMERS      ANNUAL-STATEMENT
   ANNUAL-ST-DONE   Activity  No
   CAPITAL-REPAYMNT Input     No
   CAP-REPT-DONE    Activity  No
   DFHINITIAL       System    Yes
   INTEREST-CHANGE  Input     No
   PAYMENT-OVRDUE   Timer     No     ALL-TIMERS      PAYMENT-OVERDUE
   PAYMENT-RECEIVED Input     No
 
 
 
 
 
 
 
 
PF3=Return   7=Back   8=Forward

Fields in CBAM Events screen

Composite

If the event is a composite, the Boolean operator (AND or OR) applied to its predicate.

If the event is a subevent, the name of the composite event of which it forms part.

Event

The name of an event.

Fired

The fire status of the event. It is either No or Yes. This field shows the current fire status of the event, not whether the event has ever fired in the past. For example, the fire status of an atomic event that has fired and been retrieved (but not deleted) is shown as No, because the act of retrieving the event has reset its fire status to NOTFIRED.

Timer

If the event is a timer event, the name of its associated timer.

Type

The type of the event:

Activity: Activity completion
Composite: Composite
Input: Input
System: System
Timer: Event associated with a timer

Timers screen

The Timers screen lists the timers that are currently defined to a specified activity and shows their status.

Figure 8. CBAM transaction: timers screen

 CBAM         Process MORT000000017                       Processtype MORTLOANS
 
   Activity DFHROOT
 
   Timer             Status    Event            Date       Time
 
   ANNUAL-STATMNT   Expired    ANNUAL-STATEMENT 12151998   235959
   PAYMENT-OVRDUE   Unexpired  PAYMENT-OVERDUE  06301999   235959
 
 
 
 
 PF3=Return   7=Back   8=Forward

Fields in CBAM Timers screen

Date

The expiry date of the timer, in the form mmddyyyy.

Event

The name of the event associated with the timer.

Status

The state of the timer:

Expired: The timer expired normally.
Forced: Expiry of the timer was forced with a FORCE TIMER command.
Unexpired: The timer has not yet expired.

Time

The expiry time of the timer, in the form hhmmss.

Timer

The name of a timer.