Using HCI-XPERT

HCI-XPERT is a collection of two diagnostic tools and three utilities. One diagnostic tool, HCILOOK, provides analysis and changing of pertinent run-time controls while the other, HCITELL, provides analysis of journal data gathered for problem determination purposes. The IMPORT and EXPORT utilities, provide a method to package the journal data for its transmission (via FTP) to BMC, should the need arise to resolve a problem. The MESSAGES utility enables the viewing of some HCI abend codes and workstation error codes.

HCI-XPERT executes under TSO ISPF and supports its command structure, and all screens support the ISPF HELP command (usually PF1). The help tutorial screens explain all pertinent information about the screen including commands available and field definitions.

This discussion of HCI-XPERT is not all-inclusive; consult the tutorial panels provided. More detailed information is provided for getting started than for the remaining part of the facility. The panels are shown for a 24x80 terminal size. Currently all 3270 models 2, 3, 4, and 5 are supported.

Access considerations

HCI-XPERT consists of a CLIST, two REXX EXECs, several assembler routines, many ISPF screens and tutorial definitions. Several libraries must be accessible in order for HCI-XPERT to function. Access to these libraries may be provided via a system library or may need to be defined by the user as follows:

  • //SYSEXEC DD: Ensure that your TSO LOGON allocates the DDNAME SYSEXEC to a PDS that contain HCI–XPERT's REXX EXECs.
  • //ISPPLIB DD: Ensure that your TSO LOGON allocates the DDNAME ISPPLIB to a PDS that contain the HCI ISPF panels.
  • //ISPLLIB DD: Ensure that your TSO LOGON allocates the DDNAME ISPLLIB to SLHCAUTH and SLHCLOAD that contain the HCI load modules.
  • //ISPTLIB DD: Ensure that your TSO LOGON allocates the DDNAME ISPTLIB to a PDS that contain the HCI tables (HCIJCMDS module).

INVOKING HCI-XPERT

You can invoke HCI-XPERT by entering the command TSO HCIUTIL on the ISPF COMMAND line. The HCI-XPERT main menu is displayed as follows:

HCI-XPERT main menu

---------------------------------- HCI-XPERT ---------------------------------

COMMAND ===>
1 Look Inspect a running HCI User Id: HCIUSER5
2 Tell Analyze an HCI journal Time . : 12:21
3 Export Package a journal for transmission Date . : 10/11/11
4 Import Create journal from transmitted one Level. : 03.00.00
5 Messages Messages and codes

C Changes What’s new since last release
X Exit Terminate HCI-XPERT and return to ISPF

Because the HCITELL and IMPORT facilities are intended primarily for use by BMC Support for HCI debugging and diagnosis, documentation for these tools is not included in this user/reference guide.

HCILOOK facility

The HCILOOK facility lets you examine the current status of the HCI dynamically to analyze on-going events, and to perform certain update functions to change the configuration defaults that were set in the configuration assembly. Additionally, you can use HCILOOK to unregister a TP and/or dynamically (and forcibly) cancel it. HCILOOK provides information about the following:

  • Pertinent HCI tuning data
  • Active HCI regions
  • Registered TPs
  • Active sessions
  • Executed module data.

Invoking HCILOOK

Upon entering 1 (Look) on the command line of the HCI-XPERT main menu, you are asked to enter the four-character subsystem ID. To enable the update capability, enter the subsystem ID followed by a space and the word UPDATE (xxxx UPDATE).

Running HCILOOK without update activated is slightly more efficient than running it with the update capability active.

HCI subsystem display

The HCI SUBSYSTEM DISPLAY screen, lists all HCI subsystems known to z/OS. Instead of entering the four-character subsystem ID when you are prompted, enter the single character question mark (?). Doing this displays a list of all z/OS subsystems that are an HCI subsystem.

HCI SUBSYSTEM DISPLAY screen 

--------------------------- HCI SUBSYSTEM DISPLAY ----------------------Row 1 to 17 of 41
COMMAND===>SCROLL ===> PAGE

ENTER D TO DISPLAY HCI SUBSYSTEM

   ADDRESS NAMESSCTSUSESSCTSUS2STATUS

_00B79AD0HCID80C8C3C9 2F42A000  ACTIVE
_ 00B795A0MHCI80C8C3C9 2F42B000 ACTIVE
_ 00ED4AD0 Q500 80C8C3C9 2F41C000 ACTIVE
_ 00ED45A0 Q520 80C8C3C9 2F41E000 ACTIVE
_ 00ED4070 Q510 80C8C3C9 2F41B000 ACTIVE
_ 00ED0AD0 PHCI 80C8C3C9 2F60A000 ACTIVE
_ 00ED05A0 SSH1 80C8C3C9 2F41D000 ACTIVE
_ 00B79070 PPLX 80E7C3C9 2F41F000 NOT LOCAL HCI
_ 00B752A0 E510 80E7C3C9 35404000 NOT LOCAL HCI
_ 00B71540 QS50 80E7C3C9 2F439000 NOT LOCAL HCI
_ 00F89AD0X520 80C8C3C9 2ED1F000 ACTIVE
_ 00ED0070X510 80C8C3C9 2ED21000 ACTIVE
_ 00F895A0X530 80C8C3C9 2F6BB000 ACTIVE
_ 00B8EAD0S520 80E7C3C9 2F6AD000 NOT LOCAL HCI
_ 00B71010S510 80E7C3C9 2F667000 NOT LOCAL HCI
_ 00F89070CFX2 80C8C3C9 2F639000 ACTIVE
_ 00F850C0CAA2 80C8C3C9 2F60B000 ACTIVE

For each HCI subsystem, the five values are shown and described in the following table:

Value

Description

ADDRESS

Main storage address of the MVS subsystem control table (SSCT), which is represented by this entry.

NAME 

Subsystem name.

SSCTSUSE 

SSCTSUSE field in hexadecimal of the SSCT.

SSCTSUS2 

SSCTSUS2 field in hexadecimal of the SSCT.

STATUS 

Current status of the HCI subsystem. Valid values are:

  • NOT (LOCAL) HCI: This HCI subsystem is a HCI sysplex subsystem.
  • ACTIVE: The HCI subsystem is active.
  • INACTIVE: The HCI subsystem is not active.
  • PENDING-WTOR: The HCI subsystem has a pending write-to-operator.
  • ABENDED: The HCI subsystem is abending or has abended.

Screen functions

You can perform the following functions from the HCI SUBSYSTEM DISPLAY:

  • Cause the data on the screen to be refreshed by pressing the Enter key.
  • Exit from the HCILOOK facility entirely by pressing the END key (PF3).
  • Invoke an ISPF command by typing it on the command line and pressing the Enter key.
  • Display the INTERACTIVE HCI DISPLAY panel for a subsystem by typing D in the first position of the line containing the subsystem you want to display and pressing the Enter key.
  • Page down to see more subsystems by pressing the DOWN key (PF8).
  • Page up to see more subsystems by pressing the UP key (PF7).

INTERACTIVE HCI DISPLAY

The INTERACTIVE HCI DISPLAY, shows the main entry screen for HCILOOK. It contains overview information that is most helpful to casual users. Access this screen by entering a subsystem ID when you are prompted, or by selecting a subsystem ID from the HCI SUBSYSTEM DISPLAY.

Important

Updates to the currently running HCI can be made only on this screen. Even though other screens display the same first six lines, this screen is the only one where you can alter this information.

The INTERACTIVE HCI DISPLAY contains four major sections.

  • Header section: Comprises the first eight lines on the screen.
  • Control block status section: Comprises the next eight lines on the screen.
  • Storage allocation section: Comprises the next seven lines on the screen.
  • Current journal name: Occupies one screen line.

INTERACTIVE HCI DISPLAY screen

------------------------------- INTERACTIVE HCI DISPLAY -----------------------------------
COMMAND===>
 SYSID:X510 SMFID: CW01      JOB: XPEDH51STEP: XPEDH51 PROC:
STATUS: D118F09000004B00 DUMP UNIT: VOL:   CLASS: X
  MASK: 0000000000000000  DUMP PFX:  JOB: XP510 USER: HCIUSER
   GCA: 2ED21000   HCI STARTED: 11/04/10   00:16:33    JRNL LOSS: 0
  ASID: 013C VER: 0205 TIMER INT: 1500  ACB INT: 3000 JESC: $

CURR HIGH MAX CURR HIGH MAX CURR HIGH MAX
   AMB: 2 2 2   CCB: 1 2 32   DCB: 1 2 32
   RCB: 1 2 32   TPT: 25 25 25   UIB: 1 2 32
   RPL: 0 0 0   LUB: 0 0 1   WRE: 1 5 256
   JRE: 0 1 2048  ORE: 0 2 2048  SAA: 0 7 7
   PCB: 6 6 6   TEA: 2 4 128   TSB: 2 2 32
   SAB: 0 1 1   SYN: 0 0 0

CURRENT HIGHEST CURRENT HIGHEST
PRIVATE BELOW: 7K 13K PRIVATE ABOVE: 946K 2946K
 COMMON BELOW: 5K 5K  COMMON ABOVE: 163K 164K
 MODULE BELOW: 40K 40K  MODULE ABOVE: 622K 633K
 BUFFER BELOW: 0K 0K  BUFFER ABOVE: 224K 288K

CURRENT JOURNAL: X2.PROD.MLXW510.ALLPTFS.HCIJRNL1CMPRS: 0.00% 

Header section

The header section contains fields that show most of the HCICNGCA configuration options currently in effect. The same screen header is included on the INTERACTIVE HCI DISPLAY, the REGION DISPLAY, the USER DISPLAY, and the SESSION DISPLAY screens providing the same information on each of the screens. However, you can make dynamic updates to fields in this section only from the INTERACTIVE HCI DISPLAY. Changes made to these fields on subsequent screens are ignored. Following is a description of each of the fields in the header section:

Field

Description

COMMAND

 Input line onto which all of the usual ISPF commands, such as TSO and SDSF, can be entered. No HCILOOK commands are defined for this field on this screen.

SYSID 

Shows the current HCI subsystem ID. This input field can be changed. Each time you press the Enter key, the screen is updated from the HCI whose subsystem ID appears in this field.

SMFID 

Shows the SMF system identification of the z/OS on which the HCI is running.

JOB 

Shows the JOBNAME of the executing HCI.

STEP 

Shows the STEPNAME of the executing HCI. 

PROC

Shows the PROCNAME of the executing HCI.

STATUS 

Shows, in hexadecimal representation, the current settings of the GCSATATS field.

DUMP UNIT 

Shows the value of the DMPUNIT attribute on the HCICNGCA configuration element unless this value has been changed by a prior invocation of the HCILOOK facility, in which case it shows the current value for DUMP UNIT. You can change this input field by typing a new value in this field and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

VOL

 Shows the value of the DMPVOL attribute on the HCICNGCA configuration element, unless this value has been changed by a prior invocation of the HCILOOK facility, in which case it shows the current value for VOL. You can change this input field by typing a new value in this field and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

CLASS 

Shows the value of the DMPCLAS attribute on the HCICNGCA configuration element, unless this value has been changed by a prior invocation of the HCILOOK facility, in which case it shows the current value for CLASS. You can change this input field and by typing a new value in this field and pressing the Enter key. Note that the same rules apply for dynamic changes to these fields as applied to the original element specification. If DUMP UNIT and/or VOL are specified, CLASS must be blank. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

MASK 

Shows, in hexadecimal representation, the current setting of the journal mask bits, where 0000000000000000 indicates that no journal records are to be written, and FFFFFFFFFFFFFFFF indicates that all journal records are to be written. You can change this input field by typing a new value for these sixteen hex digits and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

DUMP PFX 

Shows the value of the DMPPFX attribute on the HCICNGCA configuration element, unless this value has been changed by a prior invocation of the HCILOOK facility, in which case it shows the current value for DUMP PFX. You can change this input field by typing a new value in this field and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

JOB 

Shows the current JOBNAME prefix that the HCI uses whenever it submits a TP job. This is an input field and can be changed by overtyping a new value in this field and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

USER 

Shows the current USERID that the HCI uses whenever it cannot obtain a USERID from any other source. You can change this input field typing a new value in this field and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

GCA 

Shows the main storage address of the HCI global communications area, the main control block within the HCI. This field has significance in that whenever you place the cursor under the address portion and press the Enter key, control is transferred to the HCI REGION DISPLAY screen.

HCI STARTED

Shows the date and time that the currently executing HCI was started.

JRNL LOSS 

Shows the number of journal records that could not be written due to exhaustion of the JRE control block entries. This number should be 0, indicating no lost records. If this number is greater than 0, it indicates that any journals taken during the time the HCI has been executing may be invalid due to lost records.

ASID 

Shows, in hexadecimal, the ASID number of the currently executing HCI.

VER 

Shows the version and modification number of the currently executing HCI.

TIMER INT

 Shows the current value of the main timer interval for the HCI in hundredths of a second. You can change this input field by typing a new value in this field and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

ACB INT 

Shows the current value of the OPEN ACB interval for the HCI in hundredths of a second. You can change this input field by typing a new value in this field and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

JESC 

Shows the current value of the JES2/JES3 control character that is used in CANCEL commands issued internally by the HCI. You can change this input field by typing a new value in this field and pressing the Enter key. This new value remains in effect until changed or until the HCI is brought down and back up, at which time the value specified on the HCICNGCA element is once again in effect.

Control Block status section

The control block status section lists each of the major control blocks within the HCI and shows the current number allocated, the highest number that has ever been allocated, and the maximum number that can be allocated.

The 17 control blocks displayed in the control block status section are:

Field

Description

AMB 

Access method block. Static allocation (CURR=HIGH=MAX), one block for each HCICNAMB element defined in the XML configuration document, plus an optional one automatically defined if INTERNAL=YES is specified.

CCB 

Conversation control block. Dynamic allocation, one block for each conversation currently active.

DCB 

Destination control block. Dynamic allocation, one block for each destination opened by TPs, or one block for each conversation if the TP does not open a destination (via CWOPEN).

RCB 

Region control block. Dynamic allocation, one block for each active TP region.

TPT 

TP profile table. Static allocation, one block for each HCICNTPT element defined in the configuration assembly.

UIB 

User interface block. Dynamic allocation, one block for each user registered with the HCI.

RPL 

Request parameter list. Dynamic allocation, one block for each active LU 2 or LU 6.2 VTAM event.

LUB 

Logical unit block. Dynamic allocation, one block for each active LU 2 session for which the HCI is the primary LU.

WRE 

Work request element. Dynamic allocation, one block for each active request for a unit of work to be performed by an HCI task.

JRE 

Journal request element. Dynamic allocation, one block for each active request for a journal record to be written.

ORE 

Operator request element. Dynamic allocation, one block for each active request for an operator message to be displayed on the console or returned to the initiator of the request.

SAA 

Save area above (16M line). Dynamic allocation, one block for each active save area allocated above the 16M line.

PCB 

Port control block. Static allocation, one block for each HCICNPCB element specified in the configuration assembly.

TEA

 TCP/IP event area. Dynamic allocation, one block for each active TCP/IP event.

TSB 

TCP/IP subtask block. Dynamic allocation, one block for each active TCP/IP subtask.

SAB 

Save area below (16M line). Dynamic allocation, one block for each active save area allocated below the 16M line.

SYN 

Synonym chain status. Counter only, of the current and highest number of hash table synonym chain entries in any of the HCI hash tables.

Storage allocation section

This section contains information about the main storage use within the HCI. Two numbers are given for each of eight storage types:

  • Current allocation
  • Highest allocation that this storage type has ever occupied.

All values are specified in kilobytes (K), which has a numeric value of 1024 bytes.

Storage Types

Description

PRIVATE BELOW 

Storage in the private area below the 16M line

PRIVATE ABOVE

Storage in the private area above the 16M line

COMMON BELOW 

Storage in the common area (SP 241 and SP 245) below the 16M line

COMMON ABOVE

Storage in the common area (SP 241 and SP 245) above the 16M line

MODULE BELOW 

Storage occupied by HCI modules (SP 252) below the 16M line 

MODULE ABOVE

Storage occupied by HCI modules (SP 252) above the 16M line 

BUFFER BELOW

Storage used for I/O buffers below the 16M line

BUFFER ABOVE

Storage used for I/O buffers above the 16M line

Current journal name section

This section contains only a single line that displays the name of the HCI journal currently allocated, and the percentage of data compression attained.

Screen functions

You can perform the following functions from the INTERACTIVE HCI DISPLAY:

  • Cause the data on the screen to be refreshed by pressing the Enter key.
  • Invoke an ISPF command by typing it on the command line and pressing the Enter key.
  • Change the screen to NOUPDATE mode by typing NOUPDATE on the command line and pressing the Enter key. We recommend running in NOUPDATE mode to prevent the accidental changing of attribute values.
  • Change the screen to UPDATE mode by typing UPDATE on the command line and pressing the Enter key.
  • Type new values for the SYSID, DUMP UNIT, VOL, CLASS, MASK, DUMP PFX, JOB, USER, TIMER INT, ACB INT and/or JESC fields and press the Enter key.
  • Cause the current journal to be closed and deallocated and the next journal to be allocated and opened by placing the cursor anywhere under the current journal name and pressing the Enter key. A delay of up to the value specified in TIMER INT may occur before the journals actually swap, so do not place the cursor under the journal name if a previously requested swap has not yet occurred. You may press the Enter key with the cursor anywhere else on the screen as many times as you want.
  • Cause the HCI REGION DISPLAY to be displayed by placing the cursor anywhere under the address value of the GCA field and pressing the Enter key.
  • Exit from the HCILOOK facility entirely by pressing the END key (PF3).

HCI REGION DISPLAY

The HCI REGION DISPLAY contains two major sections. The first is the header section, which is a duplicate of the first section of the INTERACTIVE HCI DISPLAY, in Header Section, except you cannot change the values shown on this screen. The second is the region display section that lists all active regions (address spaces) that contain HCI TPs. Each line of the display represents one HCI region. Access the HCI REGION DISPLAY by positioning the cursor under the address portion of the GCA field on the HCI INTERACTIVE DISPLAY and pressing the Enter key.

HCI REGION DISPLAY screen

----------------------------- HCI REGION DISPLAY -------------------- Row 1 to 1 of 1
COMMAND ===>  SCROLL ===> PAGE
SYSID: HBP1 SMFID: CW01   JOB: EFHRIP0I STEP: HCI  PROC:
STATUS: D118F09080004100 DUMP UNIT: SYSDA  VOL: TMP900 CLASS:
  MASK: 0000000000000002  DUMP PFX: SDUMP  JOB: EFHRIP  USER: EFHRIP0
   GCA: 2F681000   HCI STARTED: 11/04/10  03:00:25 JRNL LOSS: 0
  ASID: 0062 VER: 0205 TIMER INT: 1500  ACB INT: 3000  JESC: $

ENTER -D- TO DISPLAY ASSOCIATED USER(S), OR
-C- TO CANCEL THE ENTIRE TP JOB

  ADDRESS  JOBNAME  STEPNAME PROCSTEPJOBNOSTATUSASIDUSERSSYSTEM
_ 2E64CD28   EFHRIP0I   HCI INACT 0062 7 LOCAL
******************************* Bottom of data ********************************

Header section

The fields in this section are the same as those described previously for the INTERACTIVE HCI DISPLAY in Header Section, except you cannot change the displayed values.

Region Display section

For each active region, the following fields and their values are displayed as follows:

Field

Description

ADDRESS 

Main storage address of the region control block (RCB) represented by this entry.

JOBNAME

JOBNAME of this HCI region.

STEPNAME

STEPNAME of this HCI region.

PROCSTEP

PROC step name of this HCI region.

JOBNO 

JES2/JES3 job number of this HCI region.

STATUS 

Current status of this region. Valid values are:

  • ACTIVE: If the region has an active cross-memory connection with the HCI.
  • INACT: If the region has no active cross-memory connection with the HCI.

ASID 

Hexadecimal value of the ASID of this region.

USERS 

Number of active (registered) users within this region.

SYSTEM 

Indicator whether a local or remote z/OS is executing the task within this region. Valid values are:

  • LOCAL: Executing on the same z/OS as the HCI.
  • REMOTE: Executing on another sysplex z/OS.

Screen functions

You can perform the following functions from the HCI REGION DISPLAY:

  • Cause the display to be refreshed by typing a single letter on the command line and pressing the Enter key.
  • Display the HCI USER DISPLAY screen for a specified region by typing D in the first position of the line containing the region you want to display and pressing the Enter key.
  • Cause a specified region to be canceled by typing C in the first position of the line containing the region you want to cancel and pressing the Enter key. You are prompted to verify that you want to cancel the region. If you want to cancel the region, reply YES to the prompt. If you do not want to cancel the region, reply NO to the prompt. In either case, you are returned to this screen.
  • Display the HCI SYSPLEX DISPLAY screen by typing SYSPLEX on the command line and pressing the Enter key.
  • Display the HCI MODULE DISPLAY screen by typing MODULES on the command line and pressing the Enter key. A delay of up to one minute may occur before the module display appears.
  • Invoke the HCI MEMORY DISPLAY screen by placing the cursor under the address of the GCA field and pressing the Enter key.
  • Page down to see more subsystems by pressing the DOWN key (PF8).
  • Page up to see more subsystems by pressing the UP key (PF7).
  • Return to the INTERACTIVE HCI DISPLAY panel by pressing the END key (PF3).

HCI SYSPLEX DISPLAY

The HCI SYSPLEX DISPLAY contains two major sections. The first is the header section, which is a duplicate of the first section of the INTERACTIVE HCI DISPLAY, in Header Section, except that you cannot change the values shown on this screen. If the HCI has been configured for sysplex support, the second section is the sysplex display section, which lists all of the z/OS systems in the sysplex. Access this screen by entering the SYSPLEX command on the command line of the HCI REGION DISPLAY.  

HCI SYSPLEX DISPLAY screen

--------------------------- HCI SYSPLEX DISPLAY -------------- Row 1 to 2 of 2
COMMAND===>SCROLL ===> PAGE
SYSID: X510 SMFID: CW01 JOB: XPEDH51 STEP: XPEDH51  PROC:
STATUS: D118F09000004B00  DUMP UNIT:  VOL: CLASS: X
  MASK: 0000000000000000   DUMP PFX:  JOB: XP510  USER: HCIUSER
   GCA: 2ED21000 HCI STARTED: 11/04/10 00:16:33 JRNL LOSS: 0
  ASID: 013C VER: 0205   TIMER INT: 1500   ACB INT: 3000  JESC: $

HCI CONFIGURED FOR SYSPLEX

ADDRESS NAME TYPE STATUSHCIYPREP COUNT
3797F828 CW01 LOCAL ACTIVE COMPLETE 0
37975D88 CW09 REMOTE ACTIVE COMPLETE 0
******************************* Bottom of data ********************************

Header section

The fields in this section are the same as those described previously for the INTERACTIVE HCI DISPLAY in Header Section, except you cannot change the displayed values.

Sysplex Display section

Each row is a z/OS member of the sysplex and shows the following six fields and their values:

Field

Description

ADDRESS 

Main storage address of the HCI subsystem block (SSB) is represented by this entry.

NAME

Name of the sysplex member

TYPE 

Indicator of whether the member is local or remote as known to the HCI:

  • LOCAL: Executing on the same z/OS as the HCI.
  • REMOTE: Executing on another sysplex z/OS.

STATUS

Indicator of whether the member is active or inactive with the HCI:

  • ACTIVE: The HCI will submit jobs to the z/OS.
  • INACT: The HCI will not submit jobs to the z/OS.

HCIYPREP

Indicator of whether the HCIYPREP procedure is completed or is pending execution:

  • COMPLETED: HCIYPREP is completed.
  • PENDING: HCIYPREP is pending execution.

COUNT

Number of of jobs submitted by the HCI via the ROUTE statement in the HCI PARMLIB.

Screen functions

You can perform the following functions from the HCI SYSPLEX DISPLAY:

  • Cause the display to be refreshed by typing a single letter on the command line and pressing the Enter key.
  • Page down to see more members by pressing the DOWN key (PF8).
  • Page up to see more members by pressing the UP key (PF7).
  • Return to the HCI REGION DISPLAY screen by pressing the END key (PF3).

HCI USER DISPLAY

The HCI USER DISPLAY screen contains two major sections. The first is the header section, which is a duplicate of the first section of the INTERACTIVE HCI DISPLAY screen, except that you cannot change the values shown on this screen. The second is the user display section that lists all active users (registered TPs) for the TP job selected on the HCI REGION DISPLAY screen. Access the HCI USER DISPLAY by entering the D line command next to the desired TP job on the HCI REGION DISPLAY.

HCI USER DISPLAY Screen

------------------------------ HCI USER DISPLAY ---------------- Row 1 to 2 of 7
COMMAND ===> SCROLL ===> PAGE
 SYSID: HBP1 SMFID: CW01JOB: EFHRIP0I STEP: HCI  PROC:
STATUS: D118F09080004100  DUMP UNIT: SYSDA  VOL: TMP900 CLASS:
  MASK: 0000000000000002   DUMP PFX: SDUMP  JOB: EFHRIP  USER: EFHRIP0
   GCA: 2F681000 HCI STARTED: 11/04/10 03:00:25 JRNL LOSS: 0
  ASID: 0062  VER: 0205   TIMER INT: 1500   ACB INT: 3000  JESC: $

 ENTER -D- TO DISPLAY ASSOCIATED CONVERSATION(S), OR
-U- TO UNREGISTER THE USER

 _ LCLTP NAME: P10947
   SYSTEM: *LOCAL* MEMBER: P10947
  UIB: 2E1A5138 USERID: PFHKSF0 STATUS: WAITING
  TP NAME: P10947
 CPI-C RC: 0 HCI RC: 0 MODULE:

 _ LCLTP NAME: P16806
   SYSTEM: *LOCAL* MEMBER: P16806
  UIB: 2E1A6DA8 USERID: BFHCDM0 STATUS: WAITING
  TP NAME: P16806
 CPI-C RC: 0 HCI RC: 0 MODULE:

Header section

The fields in this section are the same as those described previously for the INTERACTIVE HCI DISPLAY in Header Section, except you cannot change the displayed values.

User Display section

Each user display entry is five display lines in length and shows the following fields and their values:

Field

Description

LCLTP NAME

1- to 64-byte TP name that this user has registered with the HCI.

SYSTEM 

z/OS system name

MEMBER 

Name of the HCI PARMLIB member read when the HCI submitted the TP job.

UIB 

Hexadecimal representation of the main storage address of the user interface block (UIB) from which the information for this entry came.

USERID 

User ID currently in effect for this TP.

STATUS 

The current status of this TP:


    • WAITING - Indicates that the TP has issued a CWWAIT or CWWMUE and is currently waiting for an event to occur that will satisfy this wait.
    • EXECUTING IN TP - Indicates that the TP is not currently executing an HCI call, but is executing within its own code.
    • XXXXXX SUSPENDED - Indicates that the TP has issued the HCI call (represented by XXXXXX) and is currently suspended within the PC_ROUTINE waiting for this call to complete.
    • XXXXXX IN TP - Indicates that the TP is executing within its own code, but the last call made to the HCI is shown (represented by XXXXXX).

TP NAME 

1- to 64-byte TP_NAME from the HCICNTPT entry

CPI-C RC

Numeric value of the last CPI-C return code passed back to the TP from an HCI call.

HCI RC

Hexadecimal representation of the last HCI return code passed back to the TP from an HCI call.

MODULE

Name of the HCI module that last set a non-zero CPI-C or HCI return code value.

Screen functions

You can perform the following functions from the HCI USER DISPLAY screen:

  • Cause the display to be refreshed by typing a single letter on the command line and pressing the Enter key.
  • Display the HCI SESSION DISPLAY screen by typing D in the first position of the line containing the TP you want to display and pressing the Enter key.
  • Cause a specified TP to be unregistered by typing U in the first position of the line containing the TP you want to unregister and pressing the Enter key. You are prompted to verify that you want to unregister this TP. If you want to unregister the TP, reply YES to the prompt. If you do not want to unregister the TP, reply NO to the prompt. In either case, you return to this screen.
  • Page down to see more members by pressing the DOWN key (PF8).
  • Page up to see more members by pressing the UP key (PF7).
  • Return to the HCI REGION DISPLAY screen by pressing the END key (PF3).

HCI SESSION DISPLAY

The HCI SESSION DISPLAY screen contains two major sections. The first is the header section, which is a duplicate of the first section of the INTERACTIVE HCI DISPLAY, except that you cannot change the values shown on this screen. The second section is the session display section, which is a list of all active sessions for the TP selected from the HCI USER DISPLAY. Access the HCI SESSION DISPLAY by typing D in the first position of the line containing the TP you want to display and pressing the Enter key on the HCI USER DISPLAY.

HCI SESSION DISPLAY screen

------------------------ HCI SESSION DISPLAY ------------------- Row 1 to 1 of 1
COMMAND ===>     SCROLL ===> PAGE
 SYSID: HBP1 SMFID: CW01 JOB: EFHRIP0I STEP: HCI  PROC:
STATUS: D118F09080004100  DUMP UNIT: SYSDA  VOL: TMP900 CLASS:
  MASK: 0000000000000002   DUMP PFX: SDUMP  JOB: EFHRIP  USER: EFHRIP0
   GCA: 2F681000 HCI STARTED: 11/04/10 03:00:25 JRNL LOSS: 0
  ASID: 0062 VER: 0205   TIMER INT: 1500 ACB INT: 3000  JESC: $

LCLTP NAME: P10947
  ACB NAME: H08B75C0 TYPE: TCP/IP GEN NAME: APPLID: 10.10.0.200
 PARTNER LU NAME: 10.30.0.94 MODE: :10947/ STATUS: 00000000
MAX SESS:   CONTENTION WIN:   LOSE:
   RECEIVE COUNT: 19   SEND COUNT: 22  STATE: SEND RECEIVE
******************************* Bottom of data ********************************

Header section

The fields in this section are the same as those described previously for the INTERACTIVE HCI DISPLAY in Header Section except you cannot change the displayed values.

Session Display section

The session display section displays the following fields once for each currently active session for the selected TP within the selected JOB.

Field

Description

LCLTP NAME

1- to 64-byte TP name that this user has registered with the HCI.

ACB NAME 

VTAM ACB name that is used for this session for LU 6.2 and LU 2 conversations; or contains the subtask identification used between the HCI and TCP/IP for this connection.

TYPE 

Type of conversation represented by this screen entry:

  • LU 6.2 - For LU 6.2 conversations
  • LU 2 - For LU 2 conversations
  • TCP/IP - For TCP/IP connections.

GEN NAME 

VTAM generic name used by the partner LU to establish this session with the HCI for LU 6.2 and LU 2 conversations. This field is blank for TCP/IP connections.

APPLID 

Application associated with the ACB NAME used by the HCI for this LU 6.2 or LU 2 conversation; or contains the local IP address (not the partner IP address) of this host TCP/IP.

PARTNER LU NAME

Name of the partner LU as it is known to the local VTAM for LU 6.2 or LU 2 conversations; or contains the IP address of the remote partner for TCP/IP connections.

MODE 

Logon mode name used to establish the session over which this conversation is flowing for LU 6.2 conversations. This field is blank for LU 2 conversations. For TCP/IP connections, this field contains the local port number over which the HCI is communicating with TCP/IP. This port number of prefixed with a colon (:) and suffixed with a forward slash (/) to differentiate it from other field values.

STATUS 

Hexadecimal representation of the status bytes currently set in the conversation control bLock (CCB) within the HCI for this conversation and all conversation types.

MAX SESS 

Value specified in the HCI configuration or in the VTAM application definition statement for maximum sessions. This field is blank for LU 2 and TCP/IP.

CONTENTION WIN

Current number of contention winner sessions allocated to this mode name group for LU 6.2 conversations. This field is blank for LU 2 and TCP/IP.

LOSE 

Current number of contention loser sessions allocated to this mode name group for LU 6.2 conversations. This field is blank for LU 2 and TCP/IP.

RECEIVE COUNT

Number of messages received by the HCI for this conversation for all conversation types.

SEND COUNT

Number of messages sent by the HCI for this conversation for all conversation types.

STATE 

Current state of the conversation:

  • NULL
  • RESET
  • INITIALIZED
  • SEND
  • RECEIVE
  • SEND PENDING
  • CONFIRM
  • CONFIRM SEND
  • CONFIRM DEALLOC
  • DEFER RECEIVE
  • DEFER DEALLOC
  • SYNC POINT
  • SYNC POINT SEND
  • DEAL PEND CONF
  • RECV PEND CONF
  • SEND PEND CONF
  • SEND RECEIVE (TCP/IP only)

Refer to IBM's CPI-C programming manual for a definition of the state values.

Screen functions

You can perform the following functions from the HCI SESSION DISPLAY screen:

  • Cause the display to be refreshed by typing a single letter on the command line and pressing the Enter key.
  • Page down to see more members by pressing the DOWN key (PF8).
  • Page up to see more members by pressing the UP key (PF7).
  • Return to the HCI USER DISPLAY screen by pressing the END key (PF3).

HCI MEMORY DISPLAY

The HCI MEMORY DISPLAY screen displays storage details from z/OS common areas and from the HCI private region. Storage from private regions other than the HCI cannot be displayed. Invoke this screen from the HCI REGION DISPLAY by placing the cursor under the GCA address field and pressing the Enter key.

HCI MEMORY DISPLAY screen

----------------------------- HCI MEMORY DISPLAY ---------- Row 1 to 18 of 256
COMMAND ===>   SCROLL ===> PAGE
 SYSID: HBP1 STORAGE LENGTH: 001000 NEXT ADDR: 2F682000
  GCA: 2F681000

OFFSET -------------------------------------------------------------  ADDRESS
000000 C7C3C140  00000000  C6D41A4C  3EB46D01  *  GCA ....FM...... * 2F681000
000010 00000000  00000000  C8C2D7F1  C3E6F0F1  *  ........HBP1CW01 * 2F681010
000020 C5C6C8D9  C9D7F0C9  C8C3C940  40404040  *  EFHRIP0IHCI * 2F681020
000030 40404040  40404040  D118F090  80004100  *     J.0..... * 2F681030
000040 E2E8E2C4  C1404040  E3D4D7F9  F0F0405B  *  SYSDA TMP900 .* 2F681040
000050 40404040  000005DC  C8C3C9E8  D7D9C5D7  *  ....HCIYPREP * 2F681050
000060 E2C4E4D4  D7404040  40404040  00000000  *  SDUMP    .... * 2F681060
000070 0000F200  00000000  00000000  00000002  *  ..2............. * 2F681070
000080 00000000  00000000  00000000  00000000  *  ................ * 2F681080
000090 00000000  000002D3  7F006788  C5C6C8D9  *  .......L....EFHR * 2F681090
00

Header section

The header section of the HCI MEMORY DISPLAY differs from the previous screens. The following four fields and their values are displayed:

Field

Description

SYSID 

Subsystem ID of the currently displayed HCI.

STORAGE LENGTH

Hexadecimal representation of the number of bytes that are displayed and that can be browsed.

NEXT ADDR

Hexadecimal representation of the main storage address computed by adding the current main storage address with the storage length.

GCA 

Main storage address of the GCA.

Memory Display section

The Memory Display Section displays in hexadecimal and character representation the contents of main storage starting at the address initially selected. Sixteen bytes of memory are displayed on each line as follows:

Field

Description

OFFSET 

Hexadecimal representation of the offset from the initial starting address that this line of the display represents.

Hex/Char Display

Hexadecimal and character representation of the data at the current offset location.

ADDRESS 

Hexadecimal representation of the main storage address of the first byte of data on the current line of the display.

Screen functions

You can perform the following functions from the HCI MEMORY DISPLAY screen:

  • Page down to see more members by pressing the DOWN key (PF8).
  • Page up to see more members by pressing the UP key (PF7).
  • Display different main storage by placing the cursor under the field that contains the address to be displayed and pressing the Enter key.
  • Return to the HCI REGION DISPLAY screen by pressing the END key (PF3).

HCI MODULE DISPLAY

The HCI MODULE DISPLAY lists all modules within the HCI region. To invoke this screen, enter MODULES on the command line of the HCI REGION DISPLAY. A delay of up to a minute can occur before the display appears so that the execution of the HCILOOK facility does not impact the HCI execution.

HCI MODULE DISPLAY screen

----------------------------- HCI MODULE DISPLAY ---------- Row 1 to 11 of 248
COMMAND ===>   SCROLL ===> PAGE
 SYSID: HBP1 SMFID: CW01 JOB: EFHRIP0ISTEP: HCI  PROC:
STATUS: D118F09080004100  DUMP UNIT: SYSDA  VOL: TMP900 CLASS:
  MASK: 0000000000000002   DUMP PFX: SDUMP JOB: EFHRIP  USER: EFHRIP0
   GCA: 2F681000 HCI STARTED: 11/04/10 03:00:25 JRNL LOSS: 0
  ASID: 0062 VER: 0205 TIMER INT: 1500  ACB INT: 3000  JESC: $

  ENTER -D- ON THE MODULE LINE TO DISPLAY THE MODULE

NAME ADDRESS LENGTH DATE TIME VERSION
--------------------------------------------------------------------
_ DYNAMAIN 02DB6950 002ED8 09/07/05 09.18 01 00 00
_ HCIAACSC 3799DC58 20030804 08.57 02 05 00
_ HCIAACSI 3799A058 20030804 08.57 02 05 00
_ HCIAALCC 3799D5E8 20030804 08.57 02 05 00
_ HCIAALCI 379A1DB8 20030804 08.57 02 05 00
_ HCIAATNM 3799C038 20030804 08.57 02 05 00
_ HCIABEND 3799B000 20030804 08.57 02 05 00
_ HCIACFMD 379A9018 20030804 08.59 02 05 00
_ HCIACNFC 3799E408 20030804 08.59 02 05 00
_ HCIACNFI 3799D118 20030804 08.59 0

Header section

The fields in this section are the same as those described previously for the INTERACTIVE HCI DISPLAY in Header Section, except you cannot change the displayed values.

Module Display section

The modules display section displays the following fields:

Field 

Description

NAME 

HCI module name

ADDRESS 

Hexadecimal representation of the main storage address of the HCI module.

LENGTH 

Hexadecimal representation of the length of the module (CSA modules only).

DATE 

Date that the module was last assembled.

TIME 

Time that the module was last assembled

VERSION 

Version, release, and modification level of this module.

Screen functions

You can perform the following functions from the HCI MODULE DISPLAY screen:

  • Display the contents of a specific module by typing D to the left of the module name on the line containing the desired module and pressing the Enter key.
  • Page down to see more members by pressing the DOWN key (PF8).
  • Page up to see more members by pressing the UP key (PF7).
  • Return to the HCI USER DISPLAY screen by pressing the END key (PF3).

Export Facility

The export process reads an HCI journal ESDS and writes a fixed length, compressed, sequential that can easily be transmitted using FTP. Ensure that you specify BIN in the FTP command stream.

HCI-XPERT - Export screen

The HCI-XPERT - Export screen lets you specify the HCI journal to be exported and the exported name. In addition, the following can also be specified:

  • Job statement
  • Optional STEPLIB libraries
  • Deletion of the exported, if already existing
  • Volume serial of the exported, if required
  • Miscellaneous job statements, such as the OUTPUT statement.

Access this screen by entering 3 (Export) on the command line of the HCI-XPERT main menu.

 HCI-XPERT - Export screen

------------------------------ HCI-XPERT - Export -----------------------------
COMMAND ===>
AFTER MAKING CHANGES, USE THE "SUBMIT" COMMAND TO END AND SUBMIT EXPORT JOB
Input Journal Data Set:
Project . . .
Group . . . .
Type . . . . .

Other Journal Data Set:
Name . . . . .

Export Data Set: VOL . . Delete . . (Yes or No)
Name . . . . .

Job Statement Information:
1 . //UNLDHCI JOB ('ACCOUNTING'),'PROGRAMMER',CLASS=A,
2 . // MSGCLASS=R,MSGLEVEL=(1,1),NOTIFY=TSOID
3 . //*
4 . //*

Steplib Designation:
DSN  . . . . .
 . . . . .

Field descriptions

The HCI-XPERT - Export screen contains the following fields:

Field

Description

Input Journal Data Set

Standard ISPF method of VSAM ESD data set specification.

Other Journal Data Set

Alternative input field for instead of the standard ISPF method above, a fully qualified data set enclosed in single quotation marks or a data set name without quotation marks to be prefixed with the user's TSO ID.

Export Data Set

Name of the export data set to be created as a fully qualified data set enclosed in single quotations marks, or an unqualified to be prefixed with the user's TSO ID.

VOL 

VOLSER of the export data set if required.

Delete 

If an export data set already exists under the same name, specify Y to delete it and create a new one.

Job Statement Information

Your TSO job card and any other required job statements.

Steplib Designation

STEPLIB data sets if required.

Screen functions

You can perform the following functions from the HCI-XPERT - Export screen:

  • Refresh the data on the screen by pressing the Enter key.
  • View the JCL to be submitted by entering SHOW on the command line. This command does not submit the export job or exit the screen.
  • Submit the export job and exit the screen by entering SUBMIT on the command line
  • Exit from this screen without submitting the export job by pressing the END key (PF3).

Batch Job submission

As an alternative to the online Export facility, you can use the following JCL example to export the journal.

JCL to Export an HCI Journal

//HCIXPRT JOB ('accounting'),'programmer',CLASS=a,
//         MSGLEVEL=(1,1),NOTIFY=&SYSUID
//EXPORT EXEC PGM=HCIJUNLD
//STEPLIB DD DSN=HC.MLHCnnn.SLHCLOAD,DISP=SHR
//HCIINDD DD DSN=*** hci journal vsam ESDS ***
//HCIOUTDD DD DSN=EXPORTED.HCI.JOURNAL,DISP=(,CATLG),UNIT=SYSDA,
//         SPACE=(TRK,(270,150),RLSE),VOL=SER=volser,
//         DCB=(RECFM=F,LRECL=4160,BLKSIZE=4160)

You can transmit the data set named EXPORTED.HCI.JOURNAL in this job to BMC by FTP. Ensure that you specify BIN in the FTP command stream.

Messages and Codes facility

The Messages and Codes Facility lets you view a designated message and related information. Information displayed for the message includes:

  • Message text (@@ indicates data substitution)
  • Description of message
  • System action
  • User action
  • Miscellaneous information.

HCI – MESSAGES AND CODES screen

The HCI – MESSAGES AND CODES screen, consists of the following three sections:

  • HCI messages
  • Workstation codes
  • User abends from the HCI.

Each section is mutually exclusive of the other. You can view messages of only one category at a time. Access this screen by entering 5 (Messages) on the command line of the HCI-XPERT main menu.

-------------------------- HCI -- MESSAGES AND CODES --------------------------
COMMAND ===>

HCI MESSAGE. . . Enter 2 character prefix with 4 digit number
Example: HC0600.

--------------------------------------------------------------------------------

WORKSTATION CODE
CODE . . . . . Use the 2 character product prefix below followed
with a 4 digit code. Example: XP1067.
XP - Code Debug/DevEnterprise

--------------------------------------------------------------------------------

USER ABEND (Mainframe)
ABEND CODE . . Do not include the "U" prefix.
REASON CODE . Enter the decimal value or leave blank.
MODULE . . . . If module "unknown" or REASON CODE not known,
omit this entry.

HCI MESSAGE section

The HCI MESSAGE section contains one field - HCI MESSAGE. This is for entering the message number. The message is usually found on the system console as HCIHCxxxxs. Omit the prefix HCI and the suffixed one- character severity code s and enter HCxxxx.

WORKSTATION CODE section

The WORKSTATION CODE section contains one field - CODE. This is for entering the workstation code as a four-digit number. Prefix this with the two-character product code as designated on the screen.

USER ABEND (Mainframe) section

The USER ABEND (Mainframe) section contains the following three fields:

Field 

Description

ABEND CODE

Enter the user abend code, omitting the U prefix and any leading zeroes.

REASON CODE

If there is a reason code, enter it here in its decimal value.

MODULE 

If there is a module name, enter it here. If the reason code has been left blank, omit this entry.

Screen functions

You can perform the following functions from the HCI MESSAGES AND CODES screen:
Once you have displayed the desired message, you can enter the following primary commands on the command line:

  • PREVIOUS: Positions the screen backward to the previous message.
  • NEXT: Positions the display forward to the next message.

Once you have displayed the desired next abend code, you can enter the following additional primary commands on the command line:

  • UP: Moves the screen backward within abend code information.
  • DOWN: Moves the screen forward within the abend code information.

At any time, you can exit the screen by pressing the END key (PF3) or by entering the END command on the command line.

Message examples

The following screen shows HCI message HC0600 with installation notes.

HCI message example

-------------------------- HCI -- MESSAGES AND CODES --------------------------
COMMAND ===> SCROLL ===>
MORE: +

MSG ID: HCIHC0600I   SEVERITY: INFORMATION

TEXT: @@ TCP/IP @@ ERROR. RETCODE=@@ ERRNO=@@

Explanation: For the indicated Subsystem ID, TCP/IP has returned a negative
value, indicating an event failure. The name of the event, the return code and
the error number are given in this message.

System Action: Processing continues.

User Action: Refer to the TCP/IP Messages and Codes manual for an explanation
of the error message number.

Install Note for TCP/IP release 3.1.0: Insure PTF UN97857 is on.

Install Note for TCP/IP release 3.1.1: Insure PTF UN97858 or higher is on.

Install Note for TCP/IP release 3.2.0: Insure PTF UQ19522 is on.

The following screen shows HCI workstation message XP1084.

-------------------------- HCI -- MESSAGES AND CODES --------------------------
COMMAND ===> SCROLL ===> PAGE
MORE: +
CODE ID: XP1084   SEVERITY: ERROR

ABSTRACT: THE PROCESS OF STARTING TP ON A MAINFRAME HAS TIMED OUT

System Action: TP fails to connect.

User Action: Perform the following checks:
1. Make sure PARMLIB is not archived and is accessable.
2. Check member name /TP Name association in HCI Configuration (HCICNFIG)
file.
3. Make sure member name association with this TP exists in PARMLIB.
4. If using SYSPLEX, check for HC1306W message in HCI job, which usually
indicates that one of the MVS systems in a SYSPLEX rejects "ROUTE
xxxx,START..." command if it was not previously authorized for HCI through
security. 

The following screen shows HCI user abend U0101, reason code 2108, and module HCIMAIN.

-------------------------- HCI -- MESSAGES AND CODES --------------------------
COMMAND ===> SCROLL ===> PAGE
MORE: +
ABEND CODE: U0101

Reason: 2108 -----------------------------------------------------------

Module: HCIMMAIN.

Explanation: Unable to load modules required by operator communications.

User Action: Verify the install was correct.

 

 

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