HCI operator commands - Documentation for BMC AMI Enterprise Common Components 17.02
This topic explains all the operator commands that help you deactivate the HCI region, display information about the HCI region, and manipulate the HCI journals.
DISPLAY
Displays status information about an HCI region.
Operands | Description |
|---|---|
ALL | Displays all HCI status fields. |
JOURNAL | Displays information about the journal. |
STOR | Displays information about current storage utilization. |
CB | Displays information about control block utilization. The CURRENT utilization, HIGHEST utilization, and MAXIMUM allowed as configured in the HCICNFIG file are displayed. |
ENQ | Displays BMC AMI DevX Workbench for Eclipse tasks with an ENQ on the data set specified. For example: |
USER | Displays the list of all active user IDs associated with HCI. |
SHUTDOWN
Terminates the HCI.
Operands | Description |
|---|---|
IMMED | For an immediate shutdown. The HCI will not wait for any user tasks to end prior to termination. Consequently, the HCI will end with a SA03 abend if there are any active users at shutdown time. |
NORMAL | For normal shutdown |
ABEND | For a forced abend situation |
Additional Commands
Various commands that may be useful in controlling an HCI.
Commands | Description |
|---|---|
CLOSE | Turn journaling off. Close and deallocate the current journal data set. |
OPEN | Allocate and open the next journal data set. |
JMASK [ON/OFF] | Turn on/off full journaling. TP activity is the default journal mask. |
SWAP | Close and deallocate current journal data set, open the next for journaling. |
Operator Commands to Control the SSAS
The following commands control the start and shutdown of SSAS. There may be multiple ports, each with a TP control task and SSAS. These port numbers are specified on the PORT_CONFIG parameter in the HCIxxxx parameter member. Be sure to specify the port number whose associated SSAS you wish to start or shutdown.
Shutdown the SSAS
F hci,SSAS SHUTDOWN ppppp
where, hci is the job name of the HCI address space and ppppp is the port number associated with the TP control task that owns the SSAS.
The minimum abbreviation for the SHUTDOWN command is SHUT.
Start the SSAS
where, hci is the job name of the HCI address space and ppppp is the port number associated with the TP control task that owns the SSAS.
Operator Commands for ENQ Management
The following commands help manage ENQs within the HCI address space. If an HCI started task is indicated as holding an ENQ on a data set, the PURGE command will purge any BMC AMI DevX Workbench for Eclipse tasks with an ENQ on the specified data set. Its syntax is:
If this command fails to clear the ENQ, you can also issue the DEALLOC operator command to clear any SYSDSN ENQs on the data set. This command’s syntax is:
Notes
- If the ENQ remains after issuing these two commands, you will have to recycle your HCI started task in order to clear it.
- If managing ENQs from the HCI is a continual issue at your site, we recommend using the INACTIVITY parameter to prevent users from holding data sets that are not in use.
Operator Commands for Purge TP Connection
The following command helps to Purge TPs connection from the HCI address space. Its syntax is:
F HCIjobname,PURGE TP=TPSeqNumber
While the HCI USER command displays the list of all active user IDs associated with HCI (TPID), this command can be used to obtain a list of active HCI user ids along with TP sequence numbers.
