CBAM--BTS browser

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

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

  1. All the process-types that have been defined to this region by means of installed PROCESSTYPE definitions.
  2. All the processes of a selected process-type. These are the processes of the selected type that currently exist on the repository data set pointed to by the installed PROCESSTYPE definition.

    Note that, if you are operating BTS in a sysplex and the repository is shared with one or more other regions, some of the processes may have been defined on other regions.

  3. The constituent activities of a selected process.
  4. The details (program, transid, userid) of a selected activity.
  5. One of the following:
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 overtyping them.

Running the transaction

Start the 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, as shown in Figure 39.

Process-types screen

Figure 39. 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

The displayed fields mean:

Auditlevel
The level of audit logging currently active for processes of this type:
Activity
Activity-level auditing. Audit records are written from:
  1. The process audit points
  2. The activity primary audit points.
Full
Full auditing. Audit records are written from:
  1. The process audit points
  2. 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.
Status
Whether the PROCESSTYPE is enabled or disabled--that is, whether new processes of this process-type can be defined.
Processtype
The name of a process-type.

If you place the cursor on the name of a process-type 8 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 Figure 40.

Processes screen

Figure 40. 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

The displayed fields mean:

Comp
The completion status of the process:
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 Figure 43.
Mode
The mode of the process. One of:

For an explanation of each of these modes, see Processing modes.

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.

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 Figure 41.

Activities screen

Figure 41. 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

The displayed fields mean:

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:
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.
Mode
The mode of the activity. One of:

For an explanation of each of these modes, see Processing modes.

Susp
Whether the activity is currently suspended:
No
The activity is not currently suspended.
Sus
The activity is currently suspended.

If you place the cursor on the name of an activity and press ENTER, you get details of the activity--see Figure 42.

Activity details screen

Figure 42. 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

The Activity details screen tells you the name of the program that implements the selected activity, plus the transaction identifier and userid under which the activity runs.

There are also three selectable fields:

Containers
Pressing ENTER on this field gives you a list of the containers associated with the selected activity--see Figure 44.
Events
Pressing ENTER on this field gives you a list of the events in the event pool of the selected activity--see Figure 45.
Timers
Pressing ENTER on this field gives you a list of the timers defined to the selected activity--see Figure 46.

Containers screen

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

Figure 43. 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 44. 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

Figure 45. 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

The Events screen lists the events in a specified activity’s event pool. (Note that the events listed are those that are currently in the event pool. Events that have been deleted do not appear in the list.)

The displayed fields mean:

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

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

Event
The name of an event.
Fired
The fire status of the event.

Note that 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) will be shown as 'No', because the act of retrieving the event will have reset its fire status to NOTFIRED.

No
Not fired
Yes
Fired
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

Figure 46. 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

The Timers screen lists the timers currently defined to a specified activity.

The displayed fields mean:

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 by means of 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.

Related reference
CEMT INQUIRE PROCESSTYPE
CEMT INQUIRE TASK
CEMT SET PROCESSTYPE

8.
Or anywhere on the same line.

[[ Contents Previous Page | Next Page Index ]]