(ZOS) IPCS VERBEXIT subcommand to display diagnostic data

The interactive problem control system (IPCS) is a tool that provides formatting and analysis support for dumps and traces produced by WebSphere Application Server for z/OS and the applications that it hosts.

IBM service personnel might request that we use the IPCS subcommand VERBEXIT with the BBORDATA verb name to display dump information for WAS for z/OS. The BBORDATA formatters reside in the WAS_HOME/lib/ipcs/ directory, which must be copied into a dataset that is in the link list or LPA

Entering VERBEXIT BBORDATA results in a display of dump contents that can include the following WAS for z/OS structures:

• Global control blocks
• Address space control blocks
• Task control blocks (TCBs)
• ORB control block

Optional parameters control which of these structures are included in the dump display. If we enter VERBEXIT BBORDATA without any optional parameters, the dump display includes only global control block content

To enter VERBEXIT BBORDATA, we might use any of the methods for entering IPCS subcommands on z/OS, as described in z/OS VS™ IPCS User's Guide, SA22-7596. Use the following syntax: VERBEXIT BBORDATA [ 'parameter [,parameter]...' ]

Valid parameters are:

• GLOBAL(bgvt-address)

  Formats and displays cell-level global vector data for the specified address space. This display includes the following formatted control blocks:

  • BGVT address - z/OS Global Vector table
  • ASR Table and ASR Table entries - Active Server Resposity information

• ASID(asid-number)

  Formats and displays address space information for the daemon, the controller (region), or the servant (region). This display includes the following formatted control blocks:

  • BACB - z/OS address space control block
  • BTRC,TBUFSET,TBUF - z/OS Component trace control blocks
  • BOAM,BOAMX - z/OS BOA control blocks
  • ACRW queue - Application Controller Work element control blocks
  • BTCB queues - z/OS control information

  Along with ASID(asid-number), IBM service personnel might direct you to specify one of the following parameters, to include additional information in the dump display:

  • BTCB(btcb_address)

    Formats and displays the specified BTCB and ORB information for the WAS for z/OS TCB.

  • COMMDATA

    Formats and displays session information.

  • CONFIG

    Formats and displays configuration information for the address space.

  • OBJADDR(object_address) and OBJTYPE(object_type_ID)

    Formats and displays information for the specified object of the specified type. IBM service personnel will provide the values for you to supply for these parameters.

  • ORBDATA

    Formats and displays ORB information.

  • TCB(tcb_address)

    Formats and displays request summary information for the specified task.

  • TRACEBACK

    Formats and displays ORB information.

• SUMMARY

  Summarizes information from some of the other BBORDATA optional parameters. For example, for the GLOBAL parameter, specifying SUMMARY produces a list of active servers.

Example: Output from the command ip VERBEXIT BBORDATA 'ASID( xx ) TCB(yyyyyyyy )':

command ===> ip VERBX BBORDATA 'ASID(xx) TCB(xxxxxxxx)'
********************************* TOP OF DATA *******************************
COMPON=WEBSPHERE Z/OS,COMPID=5655A9801,ISSUER=BBORMCDP,ERRNO=04006006
_____________________________________________________________________________
BBOR0012I Formatting Clssname
 Clssname: 2BE6947E
+0000 D9859496 A385E685 82C39695 A3818995 |RemoteWebContain|................|
+0010 859900                              |er.             |...             |
BBOR0012I Formatting MethodNm
 MethodNm: 2BE69472
+0000 88A3A397 998598A4 85A2A300 00000000 |httprequest.....|.........?......|
BBOR0012I Formatting ComRtInf
 ComRtInf: 2BE69212
+0000 89974081 8484997E F94BF5F6 4BF4F24B |ip addr=9.56.42.|..@....~.K..K..K|
+0010 F1F6F840 979699A3 7EF1F0F8 F500     |168 port=1085.  |...@....~.....  |
BBOR0026I GMT Time Request was received into CTL region
 TODCLOCK: 00000000
    04/08/2003 12:58:02.926136
BBOR0026I GMT Time Request was Queued to WLM in CTL region
 TODCLOCK: 00000000
    04/08/2003 12:58:02.926263
BBOR0026I GMT Time Request will be Expired (approximated)
 TODCLOCK: 00000000
    04/08/2003 13:08:01.663032
BBOR0026I GMT Time Request was received into SR region
 TODCLOCK: 00000000
    04/08/2003 12:58:02.927729

Diagnose problems (using diagnosis tools)

IBM service call preparation

Trace controls for IBM Support

Dump controls for IBM service