ASAP 3.1 Server Manual

ManualsBrandsHP ManualsServerHP NonStop G-Series

HP NonStop ASAP Server Manual Page 1 of 360

HP NonStop ASAP Server

Manual

Abstract

HP NonStop™ Availability Statistics and Performance (ASAP) is an availability, state,

and performance statistics collection infrastructure for the HP NonStop operating

system and application resources.

Product Version

ASAP SE30V3.1

Supported Release Version Updates (RVUs)

This manual supports D42.00 and all subsequent D-series RVUs, G06.00 and all

subsequent G-series RVUs, H06.03 and all subsequent H-series RVUs, and J06.03

and all subsequent J-series RVUs until otherwise indicated by its replacement publication.

Part Number

Published

522303-009

December 2008

Summary of content (360 pages)

PAGE 1
HP NonStop ASAP Server Manual Abstract HP NonStop™ Availability Statistics and Performance (ASAP) is an availability, state, and performance statistics collection infrastructure for the HP NonStop operating system and application resources. Product Version ASAP SE30V3.1 Supported Release Version Updates (RVUs) This manual supports D42.00 and all subsequent D-series RVUs, G06.00 and all subsequent G-series RVUs, H06.03 and all subsequent H-series RVUs, and J06.
PAGE 2
Document History Part Number Product Version Published 522303-002 ASAP SE30V2 October 2003 522303-004 ASAP SE30V2 January 2004 522303-005 ASAP SE30V2.5 October 2004 522303-006 ASAP SE30V2.7 May 2006 522303-007 ASAP SE30V2.8 January 2007 522303-008 ASAP SE30V3.0 April 2008 522303-009 ASAP SE30V3.
PAGE 3
Table of Contents HP NonStop ASAP Server Manual ...................................................................................... 1 Abstract ........................................................................................................................... 1 Product Version ............................................................................................................... 1 Supported Release Version Updates (RVUs) ..................................................................
PAGE 4
File Statistics Gathering Process ................................................................................... 41 Node Statistics Gathering Process ................................................................................ 41 Process Statistics Gathering Process............................................................................ 41 RDF Statistics Gathering Process ................................................................................. 41 Spooler Statistics Gathering Process ..
PAGE 5
DOTs Overview ................................................................................................................. 87 Specifying Domains and Objectives .............................................................................. 89 The Objectives Database .............................................................................................. 90 MONITOR Usage Considerations .....................................................................................
PAGE 6
Default Process MetricRule Settings ............................................................................... 137 Modifying the Default Aggregation Settings .................................................................... 138 Section 6: ASAP Conversational Interface Commands ................................................ 139 Considerations ............................................................................................................ 141 ACTION Command ..............................
PAGE 7
PAUSE Command .......................................................................................................... 216 Example ...................................................................................................................... 217 PROCESS Command ..................................................................................................... 217 Examples.....................................................................................................................
PAGE 8
DDL Section Definitions .................................................................................................. 313 Primary Key Definitions ............................................................................................... 313 Event Definitions.......................................................................................................... 314 Query Key Definitions ..................................................................................................
PAGE 9
List of Figures and Tables Figure 1-1. ASAP Components .......................................................................................... 36 Figure 2-1. ASPSETUP Main Menu, AsapInstall ................................................................ 48 Figure 2-2. Installation Configuration for Full Install on This Node ..................................... 49 Figure 2-3. Input Help for the ASAP Install subvolume Field .............................................. 50 Figure 2-4.
PAGE 10
What’s New in This Manual New and Changed Information The ASAP 3.1 version of this manual contains these changes:  The Cluster I/O Protocol (CIP) entity has been added for use when ASAP is run on NonStop servers using Cluster I/O Module (CLIM) devices.
PAGE 11
Previous Changes The eight edition (ASAP 3.0 version) of this manual contains these changes:  The TCP/IP and Telserv entities have undergone major revisions. For more information, see the following sections:  TCP/IP Statistics Gathering Process  TCP/IP and Telserv Entities-Supported Objective Attributes  TCP Command  TCP/IP Entity Statistics A new Swap SGP is being introduced in this release. The Swap SGP collects availability and performance information about the KMSF subsystem.
PAGE 12
 A new TCP command was added. For more information, see the following sections:  TCP/IP Statistics Gathering Process  TCP/IP and Telserv Entities-Supported Objective Attributes  TCP Command  TCP/IP Entity Statistics  A new Query command was added. For more information, see the following sections:  Query Statistics Gathering Process (deleted)  Query Command (deleted)  A new SET TCP ON|OFF option has been added to enable the TCP entity.
PAGE 13
The fifth edition of this manual contains these changes:  A SET ACTION option allows you to configure ASAP to take actions when userdefined goals are not met. For more information, see the SET Command.  A SET DBMAXDAYS option allows you to configure ASAP so that it automatically retains days, weeks, months, or years of long-term database history. For more information, see the SET Command.
PAGE 14
 A process for gathering communication line statistics lets you collect availability information for SWAN communication lines. For additional information, see the SET COMM, and COMM commands.  Specify which CPU the SGPs will execute. See the SET entity command.  A Timeout option for the Status Monitor command lets you specify the elapsed time for an ASAP SGP to reply. The Status command displays entity error information in the unlikely event an SGP is in an error state or an SGP cannot start.
PAGE 15
The fourth edition of this manual contained these changes:  The only difference between 522303-002 and 522303-004 is the correct display of Section 4.
PAGE 16
RANK command.  Added EMS Event Considerations to explain the options you have in ASAP for working with EMS events.  Added the STATUS and NOEMS options to the rankspec parameter of the RANK command. Use these new options to change default behavior of system entities and to turn off event generation for status changes in ASAP system objects, respectively.
PAGE 17
 MONITOR Command  PROCESS Command Note The PROCESS command in ASAP Release 1 has become PROCESSBUSY in ASAP Release 2. The Selected Process function that PROCESS now performs is new to ASAP Release 2.
PAGE 18
 OBJECTIVESEVENTCONSOLEUP  OBJECTIVESEVENTSTATE  OBJECTIVESEVENTMAX  OBJECTIVESRANK  PARTITION  PROCESS  SPOOLER  TAPE  TMF  For File, Process, RDF, Spooler, Tape, TMF entities:  Added statistics definitions in DDL Section Definitions  Updated DDL Section Record Declarations HP NonStop ASAP Server Manual Page 18 of 360
PAGE 19
About This Manual This manual describes these Availability Statistics and Performance (ASAP) products:  The ASAP Server monitors, gathers, and analyzes system availability throughout a network of NonStop servers. System Entities are CIP, CPU, Comm, Disk, Expand, File, Hybrid1, Node, Process, Processbusy, RDF, Spooler, Swap, System, Tape, TCP/IP, Telserv2, and TMF.
PAGE 20
These service-level metrics are automatically evaluated against predefined objectives to establish alert priorities so that you can quickly identify when objectives are not being met for an application process. For more information, see the ASAP Hybrid Manual. This manual also describes these important tools for your ASAP environment:  The Entity Definition Language (EDL) lets you describe an entity and its associated data attributes required for the ASAP Client, Server, and Extension.
PAGE 21
Related Resources This manual describes the ASAP Client and ASAP Server, the ASAP base components. For details on the ASAP Client, see the ASAP Client Manual. For details on event messages generated by ASAP, see the ASAP Messages Manual. The ASAP Extension (ASAPX) is a related product that is used to collect, measure, view, and analyze application service-level metrics. This manual briefly discusses the architecture, installation, components, and functions of ASAPX.
PAGE 22
lowercase italic letters Lowercase italic letters indicate variable items that you supply. Items not enclosed in brackets are required. For example: file-name computer type Computer type letters within text indicate C and Open System Services (OSS) keywords and reserved words. Type these items exactly as shown. Items not enclosed in brackets are required. For example: myfile.
PAGE 23
{ } Braces A group of items enclosed in braces is a list from which you are required to choose one item. The items in the list can be arranged either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines. For example: LISTOPENS PROCESS { $appl-mgr-name } { $process-name } ALLOWSU { ON | OFF } | Vertical Line A vertical line separates alternatives in a horizontal list that is enclosed in brackets or braces.
PAGE 24
Item Spacing Spaces shown between items are required unless one of the items is a punctuation symbol such as a parenthesis or a comma. For example: CALL STEPMOM ( process-id ) ; If there is no space between two items, spaces are not permitted. In this example, no spaces are permitted between the period and any other items: $process-name.
PAGE 25
!o:i In procedure calls, the !o:i notation follows an output buffer parameter that has a corresponding input parameter specifying the maximum length of the output buffer in bytes. For example: error := FILE_GETINFO_ ( filenum , [ filename:maxlen ] ) ; !i !o:i Notation for Messages This list summarizes the notation conventions for the presentation of displayed messages in this manual. Bold Text Bold text in an example indicates user input typed at the terminal.
PAGE 26
horizontally, enclosed in a pair of brackets and separated by vertical lines. For example: proc-name trapped [ in SQL | in SQL file system ] { } Braces A group of items enclosed in braces is a list of all possible items that can be displayed, of which one is actually displayed. The items in the list can be arranged either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines.
PAGE 27
Notation for Management Programming Interfaces This list summarizes the notation conventions used in the boxed descriptions of programmatic commands, event messages, and error lists in this manual. UPPERCASE LETTERS Uppercase letters indicate names from definition files. Type these names exactly as shown. For example: ZCOM-TKN-SUBJ-SERV lowercase letters Words in lowercase letters are words that are part of the notation, including Data Definition Language (DDL) keywords.
PAGE 28
Section 1: Introduction to Availability Statistics and Performance (ASAP) The Availability Statistics and Performance (ASAP) software product provides an availability monitoring infrastructure for monitoring the availability and performance of:  System object information—operational status and performance of NonStop systems  Application information—user-defined application domain availability statistics The Entity Definition Language (EDL) lets you describe an entity and its associated data attribut
PAGE 29
 Browse windows for detailed entity analysis and reporting  Graph windows for multiple real-time views of host objects  Report windows for customized reporting of selected objects  Automatic host communication using the Client Server Gateway  Performance and State icons propagated upward through tree view  Hierarchical tree view of nodes, entities, objects, and applications  Context-sensitive menus on graphs and grids allow data mining  Encapsulated interface to Open Enterprise Manag
PAGE 30
ASAP Server Architecture  NonStop servers and collectors  Domain registration through the API Extension  Support for multiple node availability infrastructure  Microsoft Windows Client interface  Support for open App, CIP, Comm, CPU, Disk, Expand, File, Node, Process, ProcessBusy, RDF, Spooler, Swap, System, Tape, TCP/IP, and TMF entities ASAP Server Database  Automatically maintained  Low disk space utilization  Requires no operator intervention  Automatic archival of Object H
PAGE 31
 Full integration with the ASAP Client and Server ASAP Extension Architecture  Monitors and Statistics Gathering processes (SGPs)  Nonmessaging data collection  Shared memory segment counters  Application Programmer Interface  Multilevel domain name registration  Synchronized sampling across all ASAP Server entities ASAP Extension Discrete Object Thresholds (DOTs) Features  Objective thresholding based on domain names and levels of the domain name  Thresholds based on the DOTs o
PAGE 32
 Data normalized in the ASAP Server database on a NonStop server  Full integration with the ASAP Client and Server ASAP Hybrid Architecture  Monitors and Statistics Gathering agent  Non-messaging data collection  Shared memory segment counters  Application Programmer Interface  Multilevel domain name registration  Synchronized sampling across all entities ASAP Hybrid Discrete Object Thresholds (DOTs) Features  Objective thresholding based on domain names and levels of the domain
PAGE 33
ASAP availability information is stored in the ASAP database for historic reference, as well as for shared access by multiple users and applications. The ASAP Server collects data with a set of CPU Monitors, Statistic Gathering processes (SGPs), and Collection processes in a network of systems. ASAP monitors operational information of system and user-defined resources. The ASAP SGPs report on performance and operational information of system and user application resources.
PAGE 34
applications. Service-level metrics are automatically evaluated against userdefined objectives to establish alert priorities when application objectives are not being met for an application process.  CIP subsystem status and statistics for NonStop servers that use CLIM devices, including information for CLIM devices, Monitor and Provider processes.  Communication line availability for AM3270, ATP6100, Envoy, EnvoyACP, Multilan, Snax, and X.
PAGE 35
 RDF statistics, such as relative delay times, relative byte address of the record being processed, and sequence number of the audit or image file.  Spooler availability information, such as jobs, open, hold, and print.  Swap availability information from the KMSF subsystem such as total swap space, allocates, creates, frees, releases, resizes, used percentage, number of files and available pages..
PAGE 36
Figure 1-1.
PAGE 37
Conversational Interface The ASAP Conversational Interface (CI) provides a command interpreter so you can work directly from the collection system. The CI also provides command and control of the ASAP components. See Section 6: ASAP Conversational Interface Commands. The ASAP CI provides interactive, formatted reports for all monitored nodes or selected nodes.
PAGE 38
use in your program for accessing the ASAP database, refer to the released file ASPDDLDB. Command and Control The ASAP Conversational Interface provides commands and options that let you work interactively with the collection system:  STATUS, STARTUP, and SHUTDOWN commands control the ASAP Monitor and Collector processes. When any entity is configured for gathering entity availability information, the ASAP Monitor process also starts the selected entities.
PAGE 39
 The Rollover option renames entity database files daily so you can archive them for historic analysis at a later date. Once started, ASAP needs no operator intervention. Even when CPUs become unavailable, the ASAP database is automatically maintained. Collection The Database Collector is a process pair that collects application and system availability information from system nodes throughout the network.
PAGE 40
different sub-entities and ASAP record types to report CIP information to the ASAP Collector process. COMM Statistics Gathering Process Communication SGPs collect availability for all communication lines configured on the node or only user-specified communication lines on the node. This process uses the Measure subsystem programmatic interface for collecting raw communication performance counters.
PAGE 41
with the Expand Manager. The Expand SGP reports on objective thresholds when they do not meet the user-defined values. The Expand SGP gathers availability information, bundles it in a single message, and forwards it to the ASAP Collect process. The Collect process unpacks the information and stores it in the normalized ASAP database so the ASAP LH command or ASAP Client can retrieve it. File Statistics Gathering Process File SGPs collect file availability information.
PAGE 42
Spooler Statistics Gathering Process Spooler SGPs collect Spooler availability information. Process availability information is obtained using the Spooler API. The availability information gathered is performance utilization and operational state information. The Spooler SGP reports on objective thresholds when they do not meet the user-defined values. The Spooler SGP gathers availability information, bundles it in a single message, and forwards it to the ASAP Collector process.
PAGE 43
TMF Statistics Gathering Process TMF SGPs collect TMF availability information. TMF availability information is obtained using the Subsystem Programmatic Interface (SPI) for the TMFSERVE process. The availability information gathered is performance utilization and operational state. The TMF SGP reports on objective thresholds when they do not meet the user-defined values. The TMF SGP gathers availability information, bundles it in a single message, and forwards it to the ASAP Collect process.
PAGE 44
The ASAP Collector process is continuous. If a CPU fails, the backup Collector process automatically takes over so that database access is always available. The ASAP database is a real-time normalized database and can be queried online. The ASAP product subvolume includes Enform queries that allow batch-type queries of network performance and operational status.
PAGE 45
Section 2: Installing ASAP on the Server Topic Page Task 1: Ensure Your System Meets Requirements 45 Task 2: Install ASAP Server Product Files 46 Task 3: Set Up ASAP Server 47 Task 4: Configure ASAP Components 57 Starting and Stopping ASAP 70 Task 1: Ensure Your System Meets Requirements To install ASAP Server, your system must meet these requirements: Hardware HP NonStop server. For more information, see the ReadMe file included with your RVU or software product revision (SPR) for ASAP.
PAGE 46
 Expand Manager, T9117D30 version AAW or later  Expand line-handler, T9057D30 version ADE or later  HP NonStop SeeView, T6965C31 or later  DSM/Tape Catalog MediaSRV server, T6024D42 version AAT or later Task 2: Install ASAP Server Product Files To install ASAP product files on the system, use the IPSETUP program on the ASAP installation CD. For more information on IPSetup, see the IPSetup help on the CD. 1. Put the ASAP installation CD in your workstation.
PAGE 47
IPSetup returns you to the Destination Location dialog box. 10. Click Next. IPSetup transfers the files to the designated volume and subvolume and prepares them to be used as DSVs. IPSETUP displays status dialogs so you can monitor the progress of the host installation. When IPSetup is finished, it prompts you to indicate how you want to conclude your IPSetup session. 11.
PAGE 48
To invoke any menu options, move the cursor to the menu item and press Return. For context-sensitive help for any menu item or field in ASPSETUP, move the cursor to the item or field and press Shift-Return. 3. Choose the type of installation to perform:  To fully install and configure ASAP on a data collection node, proceed to Full Install on This Node.  To install ASAP on remote nodes so you can monitor other nodes at the central data collection node, proceed to Remote Monitor Install. Figure 2-1.
PAGE 49
To fully install and configure ASAP on a data collection node: 1. From the AsapInstall menu, select Full Install on this node; then press Return. ASPSETUP displays the ASAP Local Install Configuration fields (see the following figure). Figure 2-2. Installation Configuration for Full Install on This Node VST003.vsd For context-sensitive help on any field in the ASAP Local Install Configuration panel, put the cursor on that field and press Shift-Return.
PAGE 50
Figure 2-3. Input Help for the ASAP Install subvolume Field VST011.vsd 2. Enter the Local Install values for configuring ASAP on the local node. To start a full installation: a. Enter the ASAP installation location in the ASAP Install subvolume field. b. Enter a process ID. c. Enter the location you want for the ASAP database $volume.subvolume. d. Enter the Statistics Collection Rate. e. Enter a network user ID name. f. Enter the password for SUPER.SUPER. g. Press Return to start the installation.
PAGE 51
Figure 2-4. First Page of Output From the START FULL INSTALL Function VST004.vsd ASPSETUP displays an Asap Tacl window so you can monitor the progress of the installation on the collection node. During the installation, ASPSETUP:  Performs security checks.  Checks for a previous version of ASAP. If a previous version is found, the older version is renamed to $volume.ZASAPOLD.*.  Checks for the existence of an ASAP database.  Creates Configuration files, including an installation OBEY file.
PAGE 52
Figure 2-5. Completion Display From the START FULL INSTALL Function VST005.vsd 3. To confirm that the installation did not encounter any errors, scroll through the output in the Asap Tacl window. The Asap Tacl window is a SeeView window that scrolls automatically. To turn off the automatic scroll feature, press Delete-Line from a terminal or Ctrl-Delete from a workstation.
PAGE 53
To install ASAP on remote nodes so you can monitor other nodes at the central data collection node: 1. From the AsapInstall menu, select Remote Monitor Install; then press Return. ASPSETUP displays the Asap Remote Install Configuration fields (see the following figure). Figure 2-6. ASAP Help Text for Remote Monitor Install VST006.
PAGE 54
The following figure shows a sample Remote Monitor Install page. Uppercase characters represent default values. Mixed case character entries are supplied by the user and have no default values. Figure 2-7. Remote Monitor Install Display With User Entries VST007.vsd You do not have to install both ASAP and the ASAP Extension (ASAPX) on remote nodes. To install one but not the other, leave the ASAP Install subvolume or ASAPX Install subvolume field blank for the product that you do not want to install. 2.
PAGE 55
To deselect a node, move the cursor to the node in the Selected Nodes window and then press Return. The node name is removed from the Selected Nodes window. The following figure shows the results of installing ASAP and the ASAP Extension on the node \WINE. Figure 2-8. Selecting Remote Install Nodes for Remote Installation VST008.vsd 8. After you select all of the nodes to install remotely, move the cursor back to the START REMOTE INSTALL field and press Return.
PAGE 56
Figure 2-9. Output From Remote Install VST009.vsd ASPSETUP displays an Asap Tacl window so you can monitor the progress of the installation on each node that you selected. The installation terminates if you exit SeeView while ASAP is being installed. To terminate the installation without exiting SeeView, from the AsapInstall menu, select Abort Install, and press Return. When the install completes, ASPSETUP displays output similar to the following figure.
PAGE 57
Figure 2-10. Sample Remote Install Completion Screen VST010.vsd 9. To confirm that the installation did not encounter any errors, scroll through the output in the Asap Tacl window. The Asap Tacl window is a SeeView window that scrolls automatically. To turn off the automatic scroll feature, press Delete-Line from a terminal or Ctrl-Delete from a workstation.
PAGE 58
Any system with an active ASAP database should have a properly configured ASAPCONF file in the $SYSTEM.SYSTEM location, in addition to any user configuration files located on other subvolumes. When the CI cannot locate the ASAPCONF file, ASAP uses the default values you define with the SET command (see the SET Command). ASAP searches the current default subvolume, then $SYSTEM.SYSTEM for the configuration file.
PAGE 59
Example ASAPWIZ session: 1> RUN ASAPWIZ ASAP Configuration Wizard - T0403V02.05 - (15OCT2004) - System \CENTDIV Copyright (C) 1999, 2001-2004 Hewlett-Packard Company This wizard will assist you in creating an ASAP configuration file (ASAPCONF). It should be run after installing ASAP. Is this node, \CENTDIV, the central ASAP collection node(Y):y ASAP 2.05 is installed in $SYSTEM.
PAGE 60
If you do not allow ASAP to automatically retain data for a certain number of days, it is up to the user to manage the accumulated data so it doesn't fill up the disk drive.
PAGE 61
Creating $ASAP.TESTDB2.ASAPCONF Would you like the Wizard to restart ASAP using the new configuration(Y)?n You may now run ASAP CI and enter MONITOR FILE and MONITOR PROCESS commands to configure the files and processes that ASAP will monitor. The ASAP Wizard has successfully completed. 2> ASAP Object Files The ASAP system consists of these files on $SYSTEM.
PAGE 62
ASAPRDF RDF Statistics Gathering Process (SGP) Gathers availability information for either the RDF Extractor or RDF Updater on the node. ASAPSPL Spooler Statistics Gathering Process (SGP) Gathers availability information for every monitored spooler subsystem on the node. ASAPSWP Swap Statistics Gathering Process (SGP) Gathers availability information for every monitored KMSF swapfiles on the node.
PAGE 63
ASAPCMM Object File The Monitor starts the COMM SGP on its node if Comm is enabled. The ASAP Statistics Gathering (ASAPCMM) Process collects availability information for all monitored SWAN communication line types. ASAPCMM uses the Measure programmatic interface to obtain raw communication line counters from the communication processes. For a complete list of COMM availability counters, see the COMM Command.
PAGE 64
ASAPCONF File The ASAPCONF file contains configuration information for the ASAP and ASAP Extension subsystems. Before trying to start the ASAP and ASAPX subsystems, make sure that they are properly installed. ASAPDSK Object File The ASAP Monitor starts the Disk SGP on its node if Disk is enabled. The ASAP Statistics Gathering (ASAPDSK) Process collects availability information for the ASAP for all nonphantom disk devices.
PAGE 65
When the ASAP Conversational Interface (CI) starts a remote ASAP Monitor process, the Monitor starts various monitoring functions specified in the ASAPCONF file or from interactive user commands. The ASAP Monitor is responsible for starting and maintaining the proper monitoring software in its node. If any Monitor or Statistics Gathering process (SGP) goes down for any reason, the ASAP Monitor in that node coordinates an automatic restart of processes as needed.
PAGE 66
Audit trail index, and Audit volume. For a complete list of RDF availability counters, see the RDF Command. ASAPSPL Object File The ASAP Monitor starts the Spooler SGP on its node if Spooler is enabled. The ASAP Statistics Gathering (ASAPSPL) Process collects availability information about spooler subsystems on the node. ASAPSPL uses the spooler procedure call interface to communicate with the spooler supervisors to get information about the spooler, collectors, devices, and print processes.
PAGE 67
percentage of audit trail used, transaction rate of the TMF subsystem, and number of pending transactions. For a complete list of TMF availability counters, see the TMF Command. ASAPTMF communicates directly with the TMFServe server process for obtaining TMF availability information. ASAPXMON Object File The optional ASAPX Monitor process (ASAPXMON) allocates and manages shared memory in each processor and performs sampling and metric computation.
PAGE 68
For more information about the ASAPXSGP, ASAPXMON, and ASAPX Library, see the ASAP Extension Manual. ASAPGATE The optional ASAP Hybrid for NonStop Server Gateway (ASAPGATE) process provides gateway functions between Linux systems running ASAP Hybrid for Linux and the NonStop server. ASAPPXY The optional ASAP Hybrid for NonStop Server Proxy (ASAPPXY) process acts as a proxy Statistics Gathering Process for ASAP Hybrid. The ASAP Monitor starts the optional Proxy SGP on its node if Proxy is enabled.
PAGE 69
+ + + + + + + + + + Swapfiles * Cpus Tapes TCP TCPPort TCPRoute TCPSubnet Telserv TelservService TelservWindow TMFs * 4 * * * * * * * * * * 1548 162 1142 246 140 176 182 158 370 202 * * * * * * * * * * (1440/Rate) (1440/Rate) (1440/Rate) (1440/Rate) (1440/Rate) (1440/Rate) (1440/Rate) (1440/Rate) (1440/Rate) (1440/Rate) Where: Cpus Nodes Apps CIP Comm Disks Expand Files Ncpnodes option.
PAGE 70
 30 Expand line-handlers  50 files  50 processes  3 ProcessBusyEntries per CPU The daily storage requirement for a five-minute sample interval requires approximately 32 megabytes of disk space: Bytes = = 80 10 100 30 50 50 3 * * * * * * * 128 128 222 400 212 312 80 * * * * * * * (1440/5) (1440/5) (1440/5) (1440/5) (1440/5) (1440/5) (1440/5) -------- CPU Node Disk Expand File Process ProcessBusy 2,949,120 + 368,640 + 6,393,600 + 3,456,000 + 3,052,800 + 4,492,800 + 12,026,880 31,587,840
PAGE 71
Starting ASAP 1. Start ASAP by entering ASAP at a TACL prompt: TACL 1 > ASAP ASAP - Availability Stats and Performance - T0402V02.5 (15OCT2004) Copyright (C) 1999, 2001-2004 Hewlett-Packard Company Obey $SYSTEM.SYSTEM.ASAPCONF + 2. Verify the ASAP configuration by entering the SET command to display the current configuration values. For example: +SET ASAP Configuration Control settings: Version................. T0402V02.05 (15SEP2004) Action.................. ON ActObject............... $SYSTEM.SYSTEM.
PAGE 72
ProcessBusy............. Rate.................... RemoteSecurity.......... Retain.................. Sleeptime............... Sync.................... SyncSlow................ Extended Entity Information: APP..............ON Object................ Parameters............ CPU................... CIP..............ON Object................ Parameters............ CPU................... COMM.............ON Object................ Parameters............ CPU................... DISK.............ON Object...............
PAGE 73
Object................ Parameters............ CPU................... TMF..............ON Object................ Parameters............ CPU................... $SYSTEM.SYSTEM.ASAPTCP "RATE 5,SCPNAME $ZNES,PORT,WINDOW,SERVICE" 2 $SYSTEM.SYSTEM.ASAPTMF 2 3. If the settings are not correct, do one of:  Exit the ASAP Command Interpreter and change the ASAPCONF file with the correct settings; then restart ASAP as shown in Step .  Override the defaults by entering the appropriate SET commands.
PAGE 74
For example, if a node is currently collecting Expand statistics and you no longer require this type of statistic, but you still require CPU and ProcessBusy statistics, enter SET EXPAND OFF. 3. Shut down the Monitor process on the node. 4. Once successfully stopped, use the ASAP STARTUP command to restart the node. The CPU and ProcessBusy statistics are collected, but the Expand Line-handler statistics are no longer reported to the Collection node.
PAGE 75
Section 3: Running ASAP ASAP is started from a single START command, and is self-configuring in terms of what objects it automatically monitors when the configuration file is set up correctly and executed. It also includes options to modify their default configurations. For more information, see Section 6: ASAP Conversational Interface Commands. To start the ASAP Conversational Interface (CI): 1. Type ASAP at a TACL prompt.
PAGE 76
 SET BUFFERED  SET CLEANTIME  SET DB  SET DBMAXDAYS  SET DBMAXDAYSTOPURGE  SET DBROLLOVERSUBVOLPREFIX  SET DBROLLOVERFILEPREFIX  SET ID  SET OBJCOLLECT  SET PARTITION  SET PRIMARY  SET PRIORITY  SET RATE  SET RETAIN  SET SLEEPTIME After you define the ASAP Collector options, you can start the Collector process. This example sets up the collector on $Data.asapdb, purging all records daily at 12:15 a.m. and not collecting availability records between 11:00 p.m.
PAGE 77
+set sleeptime 2200, 0230 +set clean 0215 +STARTUP \NY COLLECT Starting the ASAP Monitors and SGPs Before you start the ASAP Monitors and SGPs, define the ASAP Monitor and SGP options using the ASAP SET command. Options are set through OBEY files, TACL macros, or interactively from the ASAP CI.
PAGE 78
 SET OBJECTIVESEVENTSTATE  SET OBJECTIVESEVENTSUBJECT  SET OBJECTIVESEVENTMAX  SET OBJECTIVESRANK  SET OBJMONITOR  SET PRIMARY  SET PRIORITY  SET PROCESS  SET PROXY  SET PROXYOBJECT  SET PROXYPARAM  SET RATE  SET RDF  SET SPOOLER  SET SWAP  SET SYNC  SET SYNCSLOW  SET TAPE  SET TCP  SET TMF For more information about these commands, see the SET Command.
PAGE 79
Starting the Monitor Processes After you define the ASAP Monitor and SGP options, you can start the Monitor processes. This example sets up the ASAP subsystem to monitor two nodes. Disk and Expand objects are being monitored on both nodes, and application (APP) objects are being monitored on one of the nodes, with an availability rate of five minutes: +SET OBJECTIVESEVENTS ON +SET DISK ON, PARAMETERS “CPU 2 VOLUME $DATA” +SET APP ON, PARAMETERS “CONFIG $DATA2.APP.
PAGE 80
The display returned from the STATUS command is defined in the following table. Table 3-1.
PAGE 81
The STATUS command returns the node name, the process ID and version, and all of the SGPs that are running on the node. In this example, the SGPs are $ZOO1 and $ZOOJ. The options in parentheses for the Monitor process are also displayed. You can also use the ASAP LOG command to get more node status information. For example: LOG \CHICAGO Starting ASAP With the Default Configuration When the Monitor starts, it starts the SGPs that were set to ON.
PAGE 82
+DISK +DISK \REMOTE +PB +SPOOLER There are many command options for each entity command. For more information, see Section 6: ASAP Conversational Interface Commands. Shutting Down the ASAP Collector and ASAP Monitors The SHUTDOWN command stops the Collector or Monitor processes.
PAGE 83
Nodes should have the same GMT so that availability data can be correlated. ASAP maintains all times internally in GMT and then converts them to the local civil time of the Collect server. This lets you view system performance in the system’s own local time and ignore time zone differences when correlating statistics.
PAGE 84
Example A Example A defines a set of ASAP processes that report statistics for all nodes in the network to the Chicago node: SET SET SET SET SET COLLECT \CHICAGO DB $DATA.ASAPDB.
PAGE 85
08/02/28 0613:27 08/02/28 0100:29 08/02/28 0100:29 1720 ZOOJ INFO ASAPDSK ZASPZOO started. 1008 ZOOM INFO Sync, not required: 1008 ZOOM INFO Sync, not required: 0 0 The PID column in the INFO display shows the name of the ASAP process. When an ASAP process name ends with an M, it indicates the ASAP Monitor. When it ends with an S, it indicates the ASAP Collector. When it ends with a number or letters A through F, it is a standard SGP.
PAGE 86
New Features Enter HELP NEW FEATURES for a new features history. New User Enter HELP NEW USER for getting started & product overview. NODE Reports on Expand end-to-end stats. OBEY Causes commands in OBEY file to be executed. PAUSE Suspends program until stop/abend/brk msg. PB Alias command for Reporting on busiest Process stats. PROCESS Reports on selected Processes. PROCESSBUSY Reports on busiest Process stats. RANK Controls the objectives ASAP uses to produce alerts.
PAGE 87
Section 4: Using Discrete Object Thresholds (DOTs) DOTs let users set discrete objectives and recovery actions against specific attributes for any domain within an ASAP entity. DOTs also let users selectively monitor specific objects (domains), and provide an event generation service.
PAGE 88
Other ASAP components autoconfigure a small set of domains. For example, the Process SGP automatically monitors only the ASAP Monitor process. When you add a domain to monitor to any subsystem, ASAP turns off autoconfiguration for that subsystem and only monitors the domains you specified. Adding a single domain, and turning it OFF in the objectives database, makes ASAP monitor no domains for the subsystem.
PAGE 89
<#D4> 4th part of a multilevel domain name <#D5> 5th part of a multilevel domain name <#ATTR> The attribute name <#OP> The objective operator <#STATE> The current state of the attribute <#LASTSTATE> The last state of the attribute <#VALUE> The value of the attribute <#GOAL> The objective value Action strings can also be stored as predefined rules by using the ASAP CI ACTION command.
PAGE 90
States can also indicate utilization such as low, medium, and high. ASAP displays ranked alert states in the ASAP Client, the EMS subsystem, or both. To enable ranked property alerts in the ASAP Client, set State Determination to UseStateGraphState for each ranked property in the ASAP Client Attribute Property sheet. For more information, see the ASAP Client Manual. To enable ranked property events in EMS, SET OBJECTIVESEVENT ON from the ASAP command interpreter before starting ASAP Server components.
PAGE 91
 EXPAND  FILE  HYBRID (Optional)  PROCESS  PROCESS BUSY domains 0-15  RDF  SPOOLER  SWAP  SYSTEM  TAPE  TCPARP  TCPICMP  TCPICMP6  TCPIGMP  TCPIP  TCPIP6  TCPLOOP  TCPMONGQ  TCPPort  TCPProcess  TCPQIO HP NonStop ASAP Server Manual Page 91 of 360
PAGE 92
 TCPRoute  TCPRTE  TCPSOCK  TCPSubnet  TCPUDP  TelservProcess  TelservService  TelservWindow  TMF Once the monitored entities are loaded in the database, you can set individual userdefined objectives against entity domains by using the GOAL or RANK commands. For a complete list of configurable system entity objective properties, see System Entity Specifics. You configure objective thresholds for an entire entity or for a specific domain within an entity.
PAGE 93
COMM $ZOOU DBCOM All configured communication line types 7, 11, 13, 53, 5158, 60, and 61 CPU $ZOOn (n=0 through 15) DBCPU All SYSGENed processors DISK $ZOOJ DBDSK All physical disk drives EXPAND * $ZOOK DBEXP All configured Expand line handlers FILE $ZOOL DBFIL $SYSTEM.SYSTEM.
PAGE 94
RDF $ZOON DBRDF All RDF environments with RDF configuration files on $SYSTEM SPOOLER $ZOOO DBSPL $SPLS SWAP $ZOOA DBSWP All configured KMSF swap files SYSTEM $ZOOn (n=0 through 15) DBSYS Average utilization for all Up CPU’s TAPE $ZOOQ DBTAP All SYSGENed tape drives TCP/IP ** $ZOOV DBTCP TMF $ZOOR DBTMF All TCP/IP Processes, Routes and Subnets, and Telserv Processes All TMF components * The Expand SGP is a multi-entity (Expand and ExpandIP) SGP.
PAGE 95
EMS Event Considerations ASAP generates two classes of events:  Normal status and problem events describing ASAP operation These are events such as component startup messages or error messages when a component cannot obtain a system resource. They are written to EMS and the ASAPLOG log file, and are subject to event suppression if turned on within ASAP.
PAGE 96
To turn on down and up events for warnings and higher alerts, allowing two events per domain per interval, put these event commands in your ASAPCONF file: SET ObjectivesEvent ON SET ObjectivesEventUp ON SET ObjectivesEventMax 2 SET ObjectivesEventState Warning To create an informative EMS event when process $Abc is not executing in CPU 1: RANK PROCESS $ABC, CPU = 1 INFO Status Change Events ASAP DOTs automatically generates EMS events for Status changes in ASAP system entities when events are turned on.
PAGE 97
 To change the event generated for failures of $Abc to an informative event: RANK PROCESS $ABC, STATUS INFO  To turn off event generation for status changes to process $Def: RANK PROCESS $DEF, STATUS NOEMS By default, ASAP user-defined entities do not generate EMS events for Status changes. Because a single process can register hundreds of user domains with ASAP, failure of that process could generate hundreds of EMS messages.
PAGE 98
$SYSTEM.SYSTEM.ASAP3SYS. Any modifications to this file might cause incorrect entity objectives records to be written to the ASAP objectives database. To get help about which entity attributes can be ranked, use the SHOW command.
PAGE 99
These tables show all the attributes for each system entity that you can set objectives on: CIPCLIM Entity-Supported Objective Attributes Attribute Description Value Error Collection Error Integer64 Present Indicates whether an operational CLIM is present Char 8 XStatus Indicates whether the CLIM is connected to the ServerNet fabric Char 8 YStatus Indicates whether the CLIM is connected to the ServerNet fabric Char 8 CIPSrvrs Total number of socket servers Integer16 Mode Shows the operat
PAGE 100
AgtConnCpusCurr Current number of NSK processors connected Integer32 AgtConnCpusHigh Highest number of NSK processors connected Integer32 AgtQueuedCmds Number of SPI commands queued for processing Integer32 AgtFailedCmds Number of SPI commands that could not be completed Integer32 AgtLastApiErr Status code of the last IT-API error or zero if there has been no error Integer32 AgtLastLnxErr Errno value of the last CIP/Linux error or zero if there has been no error Integer32 SvrEvents Number
PAGE 101
MemUsed Percent heap space used by the CIPMON process Integer Cpu CIPMON CPU Integer Pin CIPMON pin Integer Pri CIPMON priority Integer QioPoolCur Size if the QIO pool Integer64 QioPoolLmt Max size of OIO pool CIPMON can allocate or 0 for no limit Integer64 RcvScktReqs Number of receive socket requests across all CLIMs Integer64 RcvScktReqErr Number of receive socket requests that returned an error Integer64 SndScktReqs Number of send socket requests across all CLIMs Integer64 Snd
PAGE 102
Size57344 Number of socket send requests greater than 32768 bytes across all CLIMs Integer32 ConnClimCurr Number of CLIMs connected Integer32 ConnClimHigh Highest number of CLIMs connected Integer32 RejectedConns Number of attempts to connect to a CLIM that were rejected Integer32 DeferredSends Number of times a send request could not be performed immediately Integer32 MsgsSent Number of messages sent to all CLIMs Integer64 MsgsRecv Number of messages received from all CLIMs Integer64 C
PAGE 103
CPU Entity-Supported Objective Attributes Attribute Description Value BUSY Percent busy Integer QUEUE Queue length Integer DISP Dispatch rate Integer DISK Disk I/O rate per second Integer CHIT Disk cache hit rate per second Integer SWAP Memory manager page faults per second Integer MEMQ Average memory manager queue length Integer PGS Percent of total physical memory pages locked Integer PCB Percent usage low process control blocks (pins 0 through 254) Integer PCBX Percent usag
PAGE 104
READ Percent time disk busy reading Integer CHIT Total cache hits per second for all block sizes Integer SWAP Number of disk page swaps per second Integer QLEN Disk process receive queue length Integer64 (implied decimal) INKB Input kilobytes per second Integer32 OUTKB Output kilobytes per second Integer32 RATE Total of DP2 reads, writes, and seeks per second Integer READS Number of DP2 read operations per second Integer WRITES Number of DP2 write operations per second Integer BSP
PAGE 105
EXPANDIP Entity-Supported Objective Attributes Attribute Description Value DFramSnt Number of IP/ATM data frames sent Integer32 DFramRvd Number of IP/ATM data frames received Integer32 DFByteSnt Data kilobytes sent per second Integer32 DFByteRvd Data kilobytes received per second Integer32 CnctCmdSnt Number of IP/ATM connect commands sent Integer32 CnctCmdRvd Number of IP/ATM connect commands received Integer32 CnctRspSnt Number of IP/ATM connect responses sent Integer32 CnctRspRvd
PAGE 106
HYBRID Entity-Supported Objective Attributes Attribute Description Value Error Collection Error Integer64 Nak Negative Acknowledgement Count Integer64 DataGrams Datagram arrival rate Real64 Samples Sample datagram arrival rate Real64 RegCnt Count of ASAP_REGISTER_ calls in this interval Real64 UpdCnt Rate (per second) of ASAP_UPDATELIST_ calls for this interval Real64 RmvCnt Count of ASAP_REMOVE_ calls in this interval Real64 ErrCnt Count of API errors in this interval Real64 NetT
PAGE 107
MSent * Messages sent per second Integer64 (implied decimal) MRecvd * Messages received per second Integer64 (implied decimal) Qlen * Receive queue length Integer32 MQlen * Maximum receive queue length Integer32 PFaults * Page faults per second Integer64 (implied decimal) Count Count of members in aggregate ACount Number of domains/attributes alerting Integer32 Integer32 * Requires Measure PROCESSBUSY Entity-Supported Objective Attributes Attribute Description Value Busy IPU busy fo
PAGE 108
RDF Entity-Supported Objective Attributes Attribute Description Value Error Error number indicating status of data Integer RTDSecs Relative time delay in seconds Integer32 RTDTime Relative time delay in hh:mm:ss Integer32 PCpu Primary CPU Integer BCpu Backup CPU Integer Priority Execution priority Integer SPOOLER Entity-Supported Objective Attributes Attribute Description Value Error Last error encountered Integer32 PCPU CPU of primary process Integer BCPU CPU of backup proces
PAGE 109
Avail Percentage available for all swap files Integer Creates Reservations made for process creates during the sample interval Integer32 CreateFails Failed reservations for process creates during the sample interval Integer32 Releases Reservations released during the sample interval Integer32 ReleaseFails Failed reservations released during the sample interval Integer32 Resizes Successful reservation resizes during the sample interval Integer32 ResizeFails Failed reservation resizes durin
PAGE 110
MemSwap Swappable physical memory Integer32 MemFree Free physical memory Integer32 MemLock Locked physical memory Integer32 MemLockMax Maximum memory that can be locked in physical memory Integer32 MemLockHigh Highest amount of locked memory since CPU was loaded Integer32 TAPE Entity-Supported Objective Attributes Attribute Description Value PCPU CPU of the backup tape device process Integer BCPU CPU of the backup tape device process Integer MountReq Number mount requests outstandin
PAGE 111
RcvNaks Number of ARP NAKs received Integer32 SntProbes Number of ARP probes sent Integer32 RcvProbes Number of ARP probes received Integer32 ENTITY TcpIcmp Internet Control Message Protocol Error Collection Error Integer64 Err Number of ICMP error packets that were generated Integer32 OldShort Number of short IP/ICMP packets Integer32 Oldcmp Number of bad ICMP Packets Integer32 OutEchoRply Number of Echo message output replies Integer32 OutDstUnrch Number of Destination Unreachab
PAGE 112
InEcho Number of Echo messages input Integer32 InTimeExcd Number of Time Exceeded messages input Integer32 InParamPrb Number of Parameter Problem messages input Integer32 InTimeStmp Number of Timestamp messages input Integer32 InTimeSRpl Number of Timestamp Reply messages input Integer32 InInfoReq Number of Information Request messages input Integer32 InInfoRpl Number of Information Reply messages input Integer32 RteAdvert Number of router advertisement messages Integer32 BadRapSubco
PAGE 113
InPackTooBig Packet too big messages received Integer32 InTimeExceed Time exceeded messages received Integer32 InParamProb Parameter problem messages received Integer32 InEchoReq Echo request messages received Integer32 InEchoReply Echo reply messages received Integer32 InMldQuery Multicast listener discovery queries received Integer32 InMldReport Multicast listener discovery reports received that match our listeners Integer32 InNdRtrAdvrt Router advertisement packets received Integer
PAGE 114
RcvTooshort Number of packets received that were too short Integer32 RcvBadsum Number of packets received that had an incorrect checksum Integer32 RcvQueries Number of IGMP Query packets received Integer32 RcvBadQueries Query packets received with IP destination address not equal to the all hosts group Integer32 RcvReport Number of IGMP membership reports received Integer32 RcvBadReports Number of bad membership reports received Integer32 RcvOurReports Number of IGMP membership reports re
PAGE 115
NoRoute Packets discarded due to no route Interger32 BadVers Bad ip version Interger32 RawOut Total raw ip packets generated Interger32 BadSrcIntf Incorrect source interface or no route Interger32 FragOverflow Fragments that exceeded limit Interger32 ENTITY TcpIp6 Internet Protocol v6 Error Collection Error Integer64 RxTotal Total packets received Interger32 RxIdleDiscards Packets received over a subnet not configured for IPv6 Interger32 RxTooSmall Packet length less then the size
PAGE 116
TrlTrFailure Trl transmit failure Interger32 EncAllocFailed Enc allocation failure Interger32 RipNoProto No matching application for packet Interger32 RipNoSpace No space in socket for packet Interger32 RipDelivered Raw input packets delivered Interger32 RipAllocFailed Raw input allocation failures Interger32 RipTooShort Raw input packets too short Interger32 RipBadcksum Raw input packets with bad checksum Interger32 FragPackets Packets fragmented Interger32 FragFragments Number
PAGE 117
FwdEother Address unreachable ENTITY TcpLoop Loopback Error Collection Error Integer64 WhoTcpSent Loopback TCP sent Interger32 WhoTcpRcvd Loopback TCP received Interger32 WhoUdpSent Loopback UDP sent Interger32 WhoUdpRcvd Loopback UDP received Interger32 HaveTcpSent TCP found sent Interger32 HaveTcpRcvd TCP found received Interger32 HaveUdpSent UDP found sent Interger32 HaveUdpRcvd UDP found received Interger32 PacketSent Packets sent Interger32 PacketRcvd Packets received
PAGE 118
PAID Opener process access ID USERID PFName Program File Name Character 34 wide Cpu Opener CPU Integer16 Pin Opener PIN Integer16 Fnum Primary File Number Integer16 BCpu Opener backup CPU if any Integer16 BPin Opener backup PIN if any Integer16 BFnum Backup File Number if any Integer16 Proto Protocol Character 6 wide LPort Local port Integer16 LAddr Local TCP/IP address IPADDR FPort Foreign port Integer16 FAddr Foreign TCP/IP address IPADDR SendQ Bytes in send queue o
PAGE 119
trip time Rttupdated Number times TCP succeeded getting round trip time Integer32 Delack Number of delayed ACKs sent Integer32 TimeoutDrop Number of connections dropped in retransmit timeout Integer32 RexmtTimeo Number of retransmit timeouts Integer32 PersistTimeo Number of persist timeouts Integer32 KeepTimeo Number of keepalive timeouts Integer32 KeepProbe Number of keepalive probes sent Integer32 KeepDrops Number of connections dropped in keepalive Integer32 SndTotal Total packet
PAGE 120
RcvPartDupPack Packets with some duplicate data Integer32 RcvPartDupByte Duplicate bytes in part-duplicate packets Integer32 RcvOutPack Out-of-order packets received Integer32 RcvOutByte Out-of-order bytes received Integer32 RcvAfterWinPack Packets with data after window Integer32 RcvAfterWinByte Bytes received after window Integer32 RcvAfterClose Packets received after close Integer32 RcvWinProbe Window probe packets received Integer32 RcvDupAck Duplicate ACKs received Integer32
PAGE 121
ENTITY TcpQio QIO Error Collection Error Integer64 DataMds Number of data message descriptors (MDs) in use by the process Integer32 MaxDataMds Maximum number of data message descriptors (MDs) that have been in use Integer32 DupMds Number of duplicate message descriptors (MDs) in use by the process not assigned to inbound driver MDs Integer32 MaxDupMds Maximum number of duplicate message descriptors (MDs) that have been in use not assigned to inbound driver MDs Integer32 NoDataMds Number of
PAGE 122
Size256 Count of socket sends between 129 and 256 bytes Integer32 Size512 Count of socket sends between 257 and 512 bytes Integer32 Size1024 Count of socket sends between 513 and 1024 bytes Integer32 Size2048 Count of socket sends between 1025 and 2048 bytes Integer32 Size4096 Count of socket sends between 2049 and 4096 bytes Integer32 Size8192 Count of socket sends between 4097 and 8192 bytes Integer32 Size12288 Count of socket sends between 8193 and 12288 bytes Integer32 Size16384 Co
PAGE 123
Error Collection Error Integer64 BadRedir Number of bad route redirect requests Integer32 Dyn Number dynamic redirects from smart gateways Integer32 NewGw Number redirects from new/unknown gateways Integer32 NotReach Number of unreachable destinations Integer32 WildCard Number of wild card matches found Integer32 ENTITY TcpSock Socket Migration Error Collection Error Integer64 BcastAllcpusSnt Broadcasts sent to all CPUs Integer32 BcastOnecpuSent Broadcasts sent to one CPU Integer
PAGE 124
InErrs Number of errors detected while inputting packets on the subnet interface Integer32 MmacErrs MMAC Errors Integer32 MmacTmOts MMAC Timeouts Integer32 TcpFlts TCP filters Integer32 TcpFltErr TCP filter errors Integer32 TcpFltDreg TCP filters dereg Integer32 UdpFlts UDP filters Integer32 UdpFltErr UDP filter errors Integer32 UdpFltDreg UDP filters dereg Integer32 PrtFltDrp Port filters drop Integer32 DataDrop Data drops Integer32 SnetAbort Subnet abort Integer32 SnetR
PAGE 125
OutPktsDropped The number of packets not sent because of interface problems – Tandem specific Integer32 Error Collection Error Integer64 Inconn The number of incoming Telnet connect requests Integer32 Open The number of open requests processed Integer32 Netdata The number of bytes received from the network Integer32 Avgactvterm The average number of terminals in the system in the last five minutes Integer32 Spireq The number of SPI requests processed Integer32 Userdata The number of by
PAGE 126
Writes The number of write requests posted by the user Integer32 WriteReads The number of writeread requests posted by the user Integer32 Ctls The number of control requests posted by the user Integer32 Setmodes The number of setmode requests posted by the user Integer32 Cancels The number of cancel requests posted by the user Integer32 LAddr Local IP Address IpAddr FAddr Foreign IP Address IpAddr LPort Local Port Integer FPort Foreign Port Integer Servname First eight characters
PAGE 127
For more information about ASAPX, see the ASAP Extension Manual.
PAGE 128
Section 5: File and Process Monitoring ASAP provides various ways to monitor files and processes and to control the amount of data produced for those objects. The most common method of monitoring a file or process is to specify the Guardian file or process name using the ASAP MONITOR command. For example, the commands MONITOR FILE $DATA.SUBVOL.FILE and MONITOR PROCESS $ABC will configure ASAP to monitor file $DATA.SUBVOL.FILE and process $ABC.
PAGE 129
find the file or process. ASAP does provide counts of objects when viewing the wildcard domains at aggregate levels. Wild-card names can resolve into many thousands of objects. That number of records can put pressure on disk resources when storing historical data, so ASAP automatically adds an aggregate-only domain to limit the output from wild-card name specifiers after you issue a MONITOR command that contains a wild-card name.
PAGE 130
issue a MONITOR command that contains an object filename. A user must manually delete the aggregate-only domain for individual records on each object to be written to the historical database. For example if you enter MONITOR PROCESS $DATA.OBJECT.FILE, then ASAP issues a MONITOR PROCESS $DATA.OBJECT.FILE\## command to add an aggregate-only domain. For more information on aggregate and aggregate-only domains, see the sections on aggregation later in this section.
PAGE 131
Bin\Sh\$Name for a process named $Name or might be Bin\Sh\$.2.59.6181274 for the unnamed process running in CPU 2, PIN 59. The OSS pathname can be the complete domain name, as shown in the /bin/sh example, or it can be preceded by a logical name as described in the next section. For example, MONITOR PROCESS OSS\SHELL/bin/sh creates an ASAP domain name of OSS\SHELL\BIN\SH. The name OSS\SHELL/bin/sh is equivalent to OSS\SHELL\/bin/sh.
PAGE 132
Note In this case, each file or process instance is monitored separately by ASAP and could produce slightly different results depending on timing and other factors. Domain Aggregation ASAP lets you aggregate File and Process domains at any level of the hierarchical group name. ASAP can automatically construct aggregate domains for all objects at all levels using a global parameter setting, or you can define only the necessary aggregate domains for individual groups (recommended).
PAGE 133
Creating Specific Aggregate-Only Domains (Recommended) To cause ASAP to write only the aggregate record for a set of domains, use the MONITOR command to add an aggregate domain using ## as the last level specifier. For example, the command MONITOR PROCESS SALES\## causes ASAP to write only the Sales\## record to disk. ASAP still computes data for each individual process and then combines the data into the aggregate record, but it writes only the aggregate record to disk.
PAGE 134
specific objectives are set on the attribute at the aggregate level. The state associated with the value in an aggregate record might or might not reflect the actual state of the value shown. Consider the Process Busy attribute. In the aggregate record, ASAP combines all the process busy attribute values in the group to show the total processor consumption of the group.
PAGE 135
Attribute Propagation If no aggregation rule is defined for an attribute, the value associated with the attribute with the worst state is also propagated. For example, if you remove the SUM rule from the Process Busy attribute in the previous example, the Busy value for process Sales\$A13 is propagated to the aggregate record instead of the sum of all processes. By default, all File attribute values are propagated to the aggregate record.
PAGE 136
Attributes without States Many attributes, such as the Process PFName attribute, have no associated state. You cannot define an objective value on those attributes, and ASAP does not rank them. For these attributes, ASAP propagates the values from the domain with the highest alert level.
PAGE 137
Stopping XIOInit As an example, when RUL is specified, a process in the Stopping process state is considered to be worse than a process in the Runnable process state, so the Stopping value is propagated to the aggregate record based on the priority rule. Like other attributes, the worst associated state value is always propagated to the aggregate level. Default Process MetricRule Settings This table shows the MetricRule aggregate controls that are set for Process monitoring when you first install ASAP.
PAGE 138
Modifying the Default Aggregation Settings To change the default Process aggregation controls provided in ASAP, edit the ASAP2SYS EDL file, and copy the File or Process EDL definition into a separate file. Make changes to the new file and then add an INCLUDE statement to the ASAPUSER file to include the new File or Process EDL file. Change only the MetricRule formulas for attributes. Any other EDL changes can produce unpredictable results.
PAGE 139
Section 6: ASAP Conversational Interface Commands The ASAP Conversational Interface (CI) provides the commands and options to start, stop, configure, and get the status of the ASAP system, as well as the commands to display object status and performance data.
PAGE 140
 A description of all available command options  Examples illustrating the use of each command Table 6-1.
PAGE 141
OBEY Execute the commands contained in the specified OBEY file 216 PAUSE Suspends the program until a stop, abend, or break message is received 216 PROCESS Displays statistics for the selected processes.
PAGE 142
alone cannot be distinguished from the STARTUP command.  To continue a command on a subsequent line, end the current line with the ampersand (&) character and enter the remaining portion of the command on the following line. The ASAP CI prompt changes to +& to indicate that it is operating in continuation mode. For example: +SET DISK OBJECT & +&$SYSTEM.SYSTEM.
PAGE 143
RULE The RULE option is used to list, define, and delete stored action strings that can be referenced in RANK commands. rule A stored action string name. The name is optional when listing rules but is required to define or delete a rule. string An action string not enclosed in quotes, where the first word in the string represents the command interpreter the command should be sent to and the remainder of the string is the command to be sent to the CI.
PAGE 144
ACTION \REMOTE shows all actions on \REMOTE. ACTION RULE lists all actions stored as rules. ACTION RULE RESECURE lists the stored action named RESECURE. To define a stored action to resecure files: ACTION RULE SECURE = FUP SECURE <#OBJECT>, "<#GOAL>" ACTION RULE RESECURE, DELETE deletes the RESECURE action. ACTION CPU 0 BUSY GT gets action/wait for CPU 0 BUSY GT. Default Rules ASAP automatically loads several rules into its database of Action Rules when it creates it for the first time.
PAGE 145
APP [/OUT file/] [ \* ] [ [.] * [\node] ][, [, [, [, [, [, [, [, [, [, [, [, [, [, [ [.
PAGE 146
node specifies the individual system for which statistical information is to be displayed. If you want information for all the systems, specify APP \*. If you do not specify a node or the wild-card character (*), the default is used. The default is the system where the ASAP program was started, or the system specified in the ASAP SYSTEM command. domain specifies the individual domain name for which customer application performance and state information is displayed.
PAGE 147
STATES displays the associated OEM state for each attribute where StatePair is true. These OEM states are reported, depending on the type of ranking used (see the SET OBJECTIVESRANK option of the SET Command): Existence 1 Object exists. Up or OK 2 Object is up or meets objectives. Low 3 Object utilization is low. Medium 4 Object utilization is medium. High 5 Object utilization is high. Warning 6 Object is at Warning level. Critical 7 Object is at Critical level.
PAGE 148
MINSTATE [AUTO|state] specifies that only records which have at least one attribute with a state greater than or equal to state are to be output. state must be a valid OEM state from 1 through 8. AUTO or no state specifies to output all records with at least one attribute with a state greater than 2. MINSTATE is useful in EDL DETAIL commands to control output to the ASAP Client. COUNT n specifies that a maximum of n records will be output.
PAGE 149
These examples show some available options along with the display output: +APP \CENTDIV ATM !DEFAULT OUTPUT Domain = ATM \CENTDIV Domain\Name\Hierarchy Date Time Ver CpuPin Ct Error Nak UnAvail ---------------------------------------------------------------------------Accounts\Payable\$Tt29 2/25 12:43 A1 1,121 4 0 0 0.00 Accounts\Payable\$Tt30 2/25 12:43 A1 0,130 4 0 0 0.00 Accounts\Receive\$Tt31 2/25 12:43 A1 1,122 4 0 0 0.00 Accounts\Receive\$Tt32 2/25 12:43 A1 0,131 4 0 0 0.
PAGE 150
RESERVED NO SGPManage YES, SGPFile "$System.System.
PAGE 151
STATEPAIR YES STATERULE UseStateGraphState TypeData REAL64 MetricRule "#5" Format "I1"; AT S3 GRID NO GRAPH NO GRAPHMAX 9 HELP "State of HEADING "S"; +APP \CENTDIV ACCOUNTS,DETAIL \CENTDIV Domain\Name\Hierarchy Status Date -------------------------------- --------------- ----Payable\$Jx48 Up 5/10 Payable\$Jx49 Up 5/10 Receive\$Jx50 Up 5/10 Receive\$Jx51 Up 5/10 State" Time ----17:41 17:41 17:41 17:41 Ct Error -- ----4 0 4 0 4 0 4 0 continued...
PAGE 152
This example limits the response to an in-memory record request only to domains where at least one attribute state is at the medium alert level (state 4.) APP ATM, DE, ST, MEM, MINSTATE 4 This example shows information from the ASAP database but limits the output to only aggregate domains. It uses the AO abbreviation for AGGREGATEONLY. APP ATM, DE, ST,AO This examples extracts all ATM records for the last 1000 samples into a separate file named $DATA.STORE.ATMFILE while suppressing terminal output.
PAGE 153
[,STATES ] [,TIME hh[:mm [m/d/y]] [, MINSTATE [AUTO] ] [ [state] ] [, COUNT count ] [,EXTRACT filename ] [,NOPRINT ] [,NOLINEBREAK ] [,AGE minutes ] The CIP command displays CIP entity statistics for the specified nodes, entities, and domain names. entity Any CIP sub-entity name.
PAGE 154
states are 1 through 8 AUTO show records with at lease one attribute state greater than state 2 (OK) COUNT defines the max number of records to display EXTRACT extract CIP records from the ASAP database to a separate database file or to a process. If the specified file does not exist, it will be created NOPRINT suppress terminal output for EXTRACT commands NOLINEBREAK do not break output lines at 132 characters.
PAGE 155
 To show the latest detailed CIP Provider statistics for the last four samples: CIP PROVIDER, DE, S4  To extract the latest CLIM statistics for all CLIMs for 1000 samples to a file: CIP CLIM, EXTRACT $DATA.DATA.CLIM, NOPRINT, SAMPLES 1000  To extract the last 1000 samples of CLIM statistics into a CSV file: CIP/OUT CLIMCSV/CLIM, RAW, DE, ST, TAB ",", NOLINEBREAK, SAMPLES 1000 CLEANUP Command The CLEANUP command invokes the database cleanup function.
PAGE 156
COMM Command The COMM command displays COMM entity availability statistics for the specified nodes and communication lines. For an explanation of COMM performance statistics, type HELP COMMSTATS. For an alphabetical list, see the COMM Statistics table. COMM [/OUT file/] [\* ] [, SAMPLES count [\node ] [ [.] commline [, TIME hh [:mm [m/d/y ] ] [, CPU number [, INFO [, PERCENT [, RATE [, STATE ] ] ] ] ] ] ] OUT file specifies the spooler or line printer where the ASAP output is to be sent.
PAGE 157
SAMPLES count specifies the number of sample periods to be displayed. A sample period is defined by the RATE option in the SET command. You can specify 0 through 255 sample periods. The default sample period number is 1. TIME hh:mm m/d/y defines the ending time of the display information in hours, minutes, month, day, and year. For example, specifying "TIME 10:15" when RATE is 5 indicates that statistics collected from 10:10 to 10:15 are displayed.
PAGE 158
TIME displays the time of the sample converted to the database local civil time. STATE displays the operational state of the device. A device could be in these states: Up Communication line is operational Down Communication line is down and no longer operational. LnkDn X25 link level is down Aborting G-series Communication line is going to the down state, and is not operational. Testing G-series Communication line is being tested and is not operational.
PAGE 159
TYPE displays the device type and the subtype of the communication line. D.xx NonStop OS displays the following: CTRL displays the controller address (in Octal) that the device was using. UNIT displays the unit number of the communication line. CH displays the channel that the communication line was using. PROGRAM displays the communication lines object file name. G.xx NonStop OS displays the following: GRP displays the group number that the device was using.
PAGE 160
RATE displays communication line utilization in I/Os per second, including rate per second, reads per seconds, writes per second, input KB per second, output KB per second, input data KB per second, output data KB per second. For a description of the performance statistics, see the COMM Statistics table. STATE shows all attributes that have an associated state and their state values. The option STATE can be used with the options RATE and PERCENT (default).
PAGE 161
Examples These examples show what you can display with the COMM command: +COMM \CENTDIV Date ---------- ----$X25A 6/22 $EL70 6/22 Time ----19:45 19:45 Status Requests Busy Read Write Retry Txactn RspTim -------- -------- ---% ---% ----% ----- ------ -----Up 0.35 29.9 23.7 2.2 0.0 0.0 0 Up 0.43 54.3 19.3 35.0 0.0 0.0 0 +COMM, RATE \CENTDIV Date ---------- ----$X25A 6/22 $EL70 6/22 Time ----19:54 19:54 Rate Reads Writes InKb OutKb InData OutDat -------- ------ ------ ------- ------- ------- -----0.30 0.
PAGE 162
OUT file specifies the spooler or line printer where the ASAP output is to be sent. When no output file is specified, the output is displayed on your terminal or workstation. \* specifies that the performance and state information for all systems is to be displayed. node specifies the individual system for which statistical information is to be displayed. If you want information for all the systems, specify CPU \*. If you do not specify a node or the wild-card character (*), the default is used.
PAGE 163
USE displays usage statistics for Memory pages, Control blocks (PCB, PCBX, LCB, and TLE), System, and MapPool. CONFIGURED displays the configured values for Memory pages, Control blocks (PCB, PCBX, LCB, and TLE), System, and MapPool. HISTO displays a histogram of CPU Busy, CPU Queue Length, and Memory Queue length. This is the default for the CPU command. The output for the histogram field is labeled M,Q.Busy.
PAGE 164
hh is the hour. mm is the minute. m/d/y is the month, day, and year. Valid m/d/y entries are mm/dd/yy, yyyy/mm/dd, or mm/dd/yyyy. MEMORY Displays additional memory statistics: Page size, Total memory size, Swappable pages, Locked pages, Free pages, and Max locked pages. MB Displays the enhanced memory values in megabytes. RAW displays USE statistics in a dense tabular format rather than the standard ASAP sparse format.
PAGE 165
MAXLOCKED Max amount of Virtual pages ever locked MEMQ The average memory manager queue length MEMSIZE Total physical memory size MemSwap Swappable memory MemLock Memory locked MemFree Free memory available MemLockMax Max amount of memory MemLockHigh Highest amount of locked memory since CPU loaded PAGESZ Number of bytes per page PCB The number of low process control blocks PCBX The number of high process control blocks PERCENT The control block usage expressed as a percentage PGLK |
PAGE 166
Examples These examples show some of the available options and their output: +CPU \DOME,S4, TIME 7:45 02/26/1999 !Show last 4 samples for system \Chicago \DOME Time M,Q.Busy_ Busy Qlen Disp Disc Chit Swap MemQ PgLk Ibsy Sbsy -------- ----- 00 2/26 01 2/26 02 2/26 03 2/26 7:45 7:44 7:43 7:42 7:45 7:44 7:43 7:42 7:45? 7:44? 7:43? 7:42? 7:45? 7:44? 7:43? 7:42? ---------- . . . . . . . .
PAGE 167
Note In this example of the DEFAULT output, the state for CPUs 2 and 3 appear because these CPUs were down.
PAGE 168
DETAIL specifies that the report will also include first and last database record timestamp information. INFO specifies that the report will show database disk file information including filename, open flag, last modification date and time, owner, and security vector. entity-name specifies that the report is limited to that entity.
PAGE 169
DISK Command The DISK command displays DISK entity availability statistics for the specified nodes and Disk volumes. For an explanation of DISK performance statistics, type HELP DSKSTATS. For an alphabetical list, see the DISK Statistics table. DISK [/OUT file/] [ \* ] [ [.] * [node ] [ [.
PAGE 170
SAMPLES count specifies the number of sample periods to be displayed. A sample period is defined by the RATE option in the SET command. You can specify 0 through 255 sample periods. The default sample period number is 1. TIME hh:mm m/d/y defines the ending time of the display information in hours, minutes, month, day, and year. For example, specifying ―TIME 10:15‖ when RATE is 5 indicates that statistics collected from 10:10 to 10:15 are displayed.
PAGE 171
INFO lists the operational information for primary disk devices and the mirror devices if they exist. DATE displays the date of the sample converted to the database local civil time. TIME displays the time of the sample converted to the database local civil time. LDEV displays the logical device number of the disk volume. CPCTYMB displays the total formatted disk space in megabytes. GBUSED displays the total space used at the time of the sample in gigabytes.
PAGE 172
SLT displays the slot number. G-series. STATE displays the operational state of the device. A device could be in these STATEs: Up device is operational. Down entire device is down. HDown entire device is in a Hard down state. -P HD primary path is Hard down. -P Dn primary path is Down. -B H backup path is Hard down. -B Dn backup path is Down. -M H mirror path is Hard down. -M Dn mirror path is Down. -MB H mirror backup path is Hard down. -MB D mirror backup path is Down.
PAGE 173
Reviv device is being revived. Frmtg device is being formatted. Specl device is in the Special state. ERROR displays the Error reason when the disk statistics are invalid. CpuDn IOP switched to another CPU. The sample for the devices is invalid for one sample interval. Cpusw IOP for the disk volume switched to another CPU. The sample for the devices is invalid for one sample. DctCh new disk volume discovered. The sample is invalid for all disk devices for one sample interval.
PAGE 174
SteCh device state change. The sample for the device is invalid for one sample interval. UnAvl device configured but the disk process for the device has not started. PERCENT is the default for the DISK command. This option displays disk utilization in percentage busy, percentage reading, percentage used, and percentage writing. Chit, Queue length, and Swaps are displayed as per second. For a description of the performance statistics, see the DISK Statistics table.
PAGE 175
DATE Date of the sample converted to the database local civil time. INPUTKB The number of kilobytes read per second from the disk. GBUSED Total gigabytes of disk space allocated. Max ExtMB The largest free extent available for the volume. MBUSE% Percentage of disk space allocated. MB AVAIL Total megabytes of disk space allocated. OUTPTKB The number of kilobytes written per second to the disk. QLEN The disk queue length of read/write operations waiting to execute.
PAGE 176
$SYSTEM-P 4/28 14:50 $SYSTEM-M 14:50 3 3 3 3 1.20 1.20 0 0 0 0 +DISK,RATE \CHITOWN Date Time State GBUsed Requests Rate Writes Reads Swap Qlen -----------------------------------------------------------------------$DSV-P 4/29 13:25 Up 1.57 0.00 $NSX-P 4/29 13:25 Up 0.58 23.00 23.5 11.3 12.2 .93 $ROJO-P 4/29 13:25 Up 0.54 0.00 $ROJO-M 13:25 Up 0.54 0.00 $SYSTEM-P 4/29 13:25 Up 1.22 0.80 $SYSTEM-M 13:25 Up 1.22 0.80 EDL Command The EDL command performs a syntax-only check of the specified EDL file.
PAGE 177
EXIT Command The EXIT command stops the Conversational Interface. +EXIT FC Command The FC command retrieves and displays the last ASAP command you entered so you can modify and re-execute it. The FC command uses the subcommands R, I, and D to replace, insert, or delete characters. For more information about this command, see the Guardian User’ s Guide. +FC FILE Command The FILE command displays FILE entity statistics and operational state information for the specified nodes and file domains.
PAGE 178
node specifies the individual system for which statistical information is displayed. If you want information for all the systems, specify FILE \*. If you do not specify a node or the wild-card character (*), the default is used. The default is the system where the ASAP program was started or the system specified in the ASAP SYSTEM command. domain specifies the individual file domains for which performance and state information is displayed.
PAGE 179
m/d/y is the month, day, and year. Valid m/d/y entries are mm/dd/yy, yyyy/mm/dd, or mm/dd/yyyy. STATES shows all attributes that have an associated state. DETAIL shows all available statistics attributes, without states. MINSTATE displays files from memory in a subvolume or aggregate domain, depending on the selected option: state shows files with an OEM-state greater than or equal to state. AUTO shows files with an OEM-state higher than 2, or else shows all files.
PAGE 180
MINDB filters display records from a historical database based on the supplied value state. Considerations  You cannot use TIME, SAMPLES, or \* with MINSTATE.  You can only use EXACT and COUNT with MINSTATE. Examples For descriptions of the fields displayed in FILE command output, enter help filestats.  To display a list of file domains being monitored and a few attributes: +file \CENTDIV File Domains --------------------------$Mm.filework $Mm.xx.disk $System.system.
PAGE 181
 To display all available attributes without the states: +file, detail \CENTDIV File Domains ------------------------$Mm.filework $Mm.xx.disk $System.system.asap Status Date ------------- ----Corrupt 9/19 Up 9/19 Up 9/19 Time Error Full Eof ----- ----- ---- ---------10:00 0 100 978944 10:00 0 0 0 10:00 0 49 1569704 continued...
PAGE 182
+file $mm.filework, states, minstate auto \CENTDIV File Domains Status S Date ------------------------- ------------- - ----$Mm.filework.filecorr Corrupt 7 9/19 $Mm.filework.filefull Up 2 9/19 continued...
PAGE 183
Use GOAL command to set or view preferred-property-threshold settings (objectives). When a goaled property threshold is exceeded, the state of the goaled property is assigned an alert state. States in ASAP describe the status of a property: up, down, warning, or critical. ASAP displays goaled alert states in the ASAP Client, the Event Management Service (EMS) subsystem, or both.
PAGE 184
goal attribute operator [value] [event] [action] STATUS [event] [action] STATUS NOEMS [action] event INFO|CRITICAL [REPEAT] [NODISPLAY] [down] [-up] action ACTION "string" | rule [WAIT wait] [NOREPEAT] attribute is the name of an attribute name as defined in ASAP EDL for the entity. The attribute must be defined with StatePair Yes, and it cannot be the StateIsOp (STATUS) attribute. operator is one of the following objective operators: > < = <> The calculated value must be greater than the objective value.
PAGE 185
REPEAT causes ASAP to repeat the event for each interval where the objective is not met. NODISPLAY overrides any global settings to suppress display of the event on the operator console. down is the event number to use for the down event, when the objective comparison fails. Events must be numbered in the range 6000 through 9999. Event number 4000 is used when this is not specified. The ASAP EMS event template for the down event is not applied when custom down events are defined.
PAGE 186
string represents the command to be executed by that command interpreter. The string must be enclosed in double quotation marks, and ASAP converts any single quotes found within a string to double quotes. For example, ACTION "FUP SECURE <#OBJECT>, '<#GOAL>'" becomes FUP SECURE <#OBJECT>, "<#GOAL>" when processed by the ASAP Action server.
PAGE 187
NOREPEAT indicates that ASAP should not continue to repeat the action until the condition is corrected. LIKE sets attributes in the new or modified domain that are currently active in the LIKE domain. Any goal specified in the command then overrides corresponding LIKE domain values. ACTIVATE turns ranking on for the specified domain(s) in the specified entity. entity must be specified when domain is specified; otherwise both are optional.
PAGE 188
LIST retrieves a list from the active set of objectives for all entities or for a specific entity. The LIST command communicates directly with running ASAP components to retrieve objective information. entity must be specified when domain is specified; otherwise both are optional. Domain names can use the asterisk wild-card character as the last character in the name.
PAGE 189
CIPMONITOR MONITOR CIPPROVIDER PROVIDER Examples  To add or modify the record for the disk $DATA: GOAL DISK $DATA, BUSY < 65  To specify that a file must be less than 90 percent full: GOAL FILE $SYSTEM.FILE.
PAGE 190
 To save the disk objectives configuration: GOAL /OUT FILE/ DISK, INFO, OBEYFORM  To list a domain for ATM: GOAL ATM\CHICAGO\$ABC, LIST  To display all records from the local database: GOAL  To deactivate a broken spooler device while it is repaired: GOAL SPOOLER $SPLG\DEV\$LP, DEACTIVATE  To turn on all domains for all entities: GOAL, ACTIVATE  To commit all objectives changes: GOAL, COMMIT  To define an action to reload a CPU after it fails: GOAL CPU, STATUS ACTION "TACL RELOAD
PAGE 191
GOAL CPU 0, BUSY < 90 CRITICAL -5555  To define a goal for busy for an OSS shell process aggregate-only domain: GOAL PROCESS /bin/sh\##, BUSY < 10  To define a global goal and action to resecure any monitored file using the ASAP default RESECURE rule: GOAL FILE, RWEP = "AOAO" ACTION RESECURE  To define a goal that all foreign TCP/IP Port connections must originate from net 16: GOAL TCPPORT, FADDR = 16.0.0.
PAGE 192
SET option provides a description of a specific SET option. Example ASAP - Availability Stats and Performance - T0402V02.00 (29JUN2001) HELP [ | ALL | ERROR | SET
PAGE 193
node specifies the individual system for which availability information is to be displayed. If you want information for all the systems, specify LH \*. If you do not specify a node or the wild-card character (*), the default is used. The default is the system where the ASAP program was started, if not superseded by a system specified with the ASAP SYSTEM command. line specifies the individual Expand line of a system for which availability information is displayed.
PAGE 194
 IFrm(S/R) displays number of Data Frames sent and received.  SFrm(S/R) displays number of Connect Commands sent and rcvd.  UFrm(S/R) displays number of Connect Responses sent and rcvd. For Expand over SERVERNET Level 2 i/s frames have these meanings:  IFrm(S/R) displays number of Data Frames sent and received.  SFrm(S/R) displays number of Active Connect Cmnds sent & rcvd.  UFrm(S/R) displays number of Passive Connects sent & rcvd.
PAGE 195
OPERATIONS displays the number of Level 4 operations sent and received. Level 4, the transport layer, handles and buffers messages between processes. Level 4 also maintains control blocks during sessions and formats packets into frames for transmission.
PAGE 196
 Number of times the out-of-sequence timeout has elapsed RATES displays counts normalized to number per second. SAMPLES count specifies the number of sample periods to display. A sample period is defined by the RATE option in the SET command. You can specify 0 through 255 sample periods. STATE shows all attributes that have an associated state. Associated states are displayed for the Expand command without any options, and the disk command with these options: IP, PATH, LINE, RATE, PERCENT(Default).
PAGE 197
RAW displays RATES data in a dense tabular format rather than the standard ASAP sparse format. LH Statistics The following table lists the LH statistics and options shown by the HELP NETSTATS command. Table 6-6. LH Statistics and Options Statistics Options BCC Total number of block-check character errors in this sample. FRAME Number of Level 2 I/S frames sent and received, and I/S ratios. HISTO Message size histogram <64 <128 <256 <512 <1024 <2048 <4096.
PAGE 198
Table 6-7. Statistic Counters Counter Description ACK Number of Acknowledgments sent or received. BCC Total number of BCC errors in this sample. CAN Number of Cancel requests sent or received. CnCmd Number of IP/ATM Connect commands sent or received. CnRsp Number of IP/ATM Connect responses sent or received. CONN Number of Connect requests sent or received. Cur% Percentage of combine Pool pages used Msg + Oos. DFr Number of IP/ATM rates of frames dropped.
PAGE 199
QyCmd Number of IP or ATM Query commands sent or received. QyRsp Number of IP or ATM Query responses sent or received. State Expand line handler state. Up, Down, Cntg (Connecting). Tos Number of Out of Sequence timeouts. TRCE Number of Trace or Probe requests sent or received.
PAGE 200
LOG Command The LOG command displays the most recent ASAP disc log event records for ASAP in the specified node. LOG [\node] [ blocks ] blocks optionally specifies the display of additional history. It indicates the number of log event record blocks to display. Example LOG \NEWYORK 3 !display 3 blocks of ASAP event records in \NEWYORK MONITOR Command The MONITOR command controls monitored objects (domains) within ASAP.
PAGE 201
Note When the PATH option is used the user is responsible for creating a unique ASAP domain name following the standard rules for ASAP domain names, 1-64 bytes in length, no more than 5 levels separated with a backslash, and no spaces, quotes, commas, colons, or semicolons. To commit changes from the ASAP DB to a running copy of ASAP: MONITOR [ entity ] [ \node ] ,COMMIT To list or remove user-defined (ASAPX) objects: MONITOR APP [ \node ] ,LIST [ \node.
PAGE 202
The type of domain name specified in the MONITOR command varies by entity: APP - application CIPCLIM – CLIM CIPMONITOR – Monitor CIPPROVIDER – Provider COMM - $line CPU - cpu DISK - $volume entity - application EXPAND - $line EXPANDIP - $line FILE - [logical\]$file | /pathname, ADD PROCESS - [logical\]$process | /pathname, ADD PROCESSBUSY - cpu RDF - primary->backup SPOOLER - $supervisor SWAP - cpu SYSTEM - \node TAPE - $tape TCPPROCESS - $tcpprocess TCPPORT - port number TCPROUTE - $tcpprocess.
PAGE 203
Provider is the name of a CIP Provider process, for example ZTC01 or $ZZCIP. ZTC01. cpu is a processor number from 0 to 15; for example 1. $volume is a disk volume name; for example $DATA. entity is a symbolic application entity name; for example SALES. Applications can be represented as separate ASAP entities when they are defined using the ASAP Entity Definition Language (EDL). Only LIST and REMOVE are applicable for user-defined entities.
PAGE 204
$process is a process name, object filename or process name pattern containing wildcard characters. For example, $ABC, $DATA.OBJECT.FILE and $AB*. Note Resolving the processes running from an object filename can result in excessive lowlevel messaging in the NonStop OS operating system. This method should be used judiciously in extremely high-performance application environments. primary->backup is the primary node name followed by "->" and the backup node name.
PAGE 205
$tcpprocess.#route is the TCP/IP v4 process or TCP/IP v6 Monitor process name and route name of a TCP/IP route. If you monitor specific TCP/IP processes and then let ASAP auto-configure Routes then ASAP will only configure the routes underneath the processes you have specifically monitored. $tcpprocess.#subnet is the TCP/IP v4 process or TCP/IP v6 Monitor process name and subnet name of a TCP/IP subnet.
PAGE 206
When monitored files and processes are specified using wild-card names, the wildcard specifier is contained within the domain name as a separate hierarchical level, and the actual object name is appended to the end as another hierarchical level or levels. When processes are monitored by specifying the object filename, the object filename is contained within the domain name as a separate hierarchical level, and an actual process name is appended to the end as another hierarchical level.
PAGE 207
INFO returns information from the database about the set of monitored objects. When domain is specified, entity must be specified, otherwise both are optional. Domain names can use the asterisk wildcard character as the last character in the name. If domain contains a wildcard character or is not specified, INFO is the default. DETAIL returns detailed time information from the database for the set of monitored objects. When domain is specified, entity must be specified, otherwise both are optional.
PAGE 208
REMOVE, FORCE removes a user-defined ASAPX domain from the monitored set of domains. FORCE removes the domain regardless of its state. Once removed, a domain enters a Pending Removal state until the end of the current statistics interval. It is removed once the last record is written for the domain. entity must be specified. domain can use the asterisk wildcard character as the last character in the name.
PAGE 209
CIPMONITOR MONITOR CIPPROVIDER PROVIDER Examples  To add and turn on the disk $DATA: MONITOR DISK $DATA  To commit all disk database changes: MONITOR DISK, COMMIT  To turn on all file domains already in the database: MONITOR FILE, ON  To turn on all domains on the local node already in the database: MONITOR, ON  To display all domains from the database: MONITOR  To turn off all disk domains: MONITOR DISK, OFF  To turn on all domains on \REMOTE already in the database: MONITOR
PAGE 210
 To save the disk domain configuration: MONITOR /OUT FILE/ DISK, INFO, OBEYFORM  To list the current ASAPX ATM domains: MONITOR ATM, LIST  To list the details for ASAPX FUNDS TRANSFER: MONITOR FUNDS\TRANSFER, LIST, DETAIL  To monitor a spooler on the system: MONITOR SPOOLER $SPLG  To remove an ASAPX user domain: MONITOR FUNDS TRANSFER\WEST\RECEIVE, REMOVE  To commit all change on the local node: MONITOR, COMMIT  To monitor a process directly enter the process name: MONITOR PROCESS
PAGE 211
 To monitor all files in subvolume $DATA.SUB that start with FIL: MONITOR FILE $DATA.SUB.FIL*, ADD  To monitor an OSS file: MONITOR FILE /home/dir/filename  To monitor a file as part of a logical group named SALES: MONITOR FILE SALES\DATA\$DATA.SUB.SALES  To dynamically monitor all processes running from an object file: MONITOR PROCESS $DATA.OBJECT.FILE  To monitor processes dynamically from an object file as part of a logical process group: MONITOR PROCESS SALES\SERVER\$DATA.OBJECT.
PAGE 212
 To create an aggregate-only domain for all files on a volume named $DATA3: MONITOR FILE $DATA3\##  To create an aggregate process domain and suppress writing of detail records to the ASAP database, specify the name to the level where you want the aggregation to occur using the ## symbol. Detail records are not written to the ASAP database, but they are available for display from ASAP memory using the PROCESS command MEMORY option.
PAGE 213
EXPAND MONITOR EXPAND $linename EXPANDIP MONITOR EXPAND $linename FILE MONITOR FILE [logical\]$filename | /pathname, ADD NODE not applicable PROCESS MONITOR PROCESS [logical\]$process | /pathname, ADD PROCESSBUSY MONITOR PROCESSBUSY cpu-number RDF MONITOR RDF primary-node->backup-node * SPOOLER MONITOR SPOOLER spooler-supervisorname SWAP MONITOR SWAP cpu-number SYSTEM MONITOR SYSTEM \nodename TCPPROCESS MONITOR TCPPROCESS $tcpprocess TCPPORT MONITOR TCPPORT port TCPROUTE MONITOR TCP
PAGE 214
OUT file specifies a spooler or line printer for the ASAP output sent. If you do not specify an output file, the output is displayed on your terminal. snode specifies the node of the sending Expand system. To send availability information from all the systems, specify NODE \*. If you do not specify a node or the wild-card character (*), the default is used. The default is the system where the ASAP program was started, if not superseded by a system specified with the ASAP SYSTEM command.
PAGE 215
m/d/y is the month, day, and year. Valid m/d/y entries are mm/dd/yy, yyyy/mm/dd, or mm/dd/yyyy. NONULLOUT displays only nodes with nonzero end-to-end statistics. NODE Statistics The following table lists the NODE statistics and description/options displayed with the HELP NCPSTATS command. Table 6-8.
PAGE 216
\CENTDIV \051 Time Sysno PHops PLdev NSys LSent LRecv PSent PRecv --------------- ----- ----- ----- ----- ---- ----- ----- ----- ----\CHITOWN 3/01 9:54 153 1 45 153 6 9 11 \CHITOWN 9:53 153 1 45 153 2 7 6 \CHITOWN 9:52 153 1 45 153 6 10 11 \CHITOWN 9:51 153 1 45 153 5 8 10 OBEY Command The OBEY command instructs ASAP to read commands from the specified file. After reaching the end of the primary OBEY file, ASAP reads commands from the original input device (or file).
PAGE 217
Example This example shows the PAUSE command: + PAUSE PROCESS Command The PROCESS command displays availability statistics about the processes specified in the command. PROCESS [\* ] [ [.] * ] [, [\node] [ [.] $process ] [, [, [, [, [, [, [, [ [, [, [, [, SAMPLES count ] DETAIL ] STATES ] CPU n ] TIME hh[:mm[m/d/y]]] AGGREGATE ] AGGONLY | AO ] MINSTATE [AUTO] ] [state] ] COUNT [count] ] MEMORY ] EXACT ] NOAGG ] Note The PROCESS command in ASAP Release 1 has become PROCESSBUSY in ASAP Release 2.
PAGE 218
DETAIL specifies to return more detailed information about the specified monitored processes. STATES specifies to return associated OEM states for each attribute defined with STATEPAIR true in the EDL. CPU n specifies to return information for all processes on only the specified CPU. TIME hh:mm m/d/y specifies the ending time of the display information in hours, minutes, month, day, and year.
PAGE 219
AUTO shows records with at lease one attribute state greater than state 2 (OK). COUNT defines the maximum number of records to display. MEMORY retrieves data directly from ASAP memory instead of the database. ASAP uses the MEMORY option for the EDL DETAIL property of the Process Entity definition. This lets a user enter ―Show Object Details‖ from ASAP Client, when aggregate only domains are used, to retrieve detail records that make up the aggregate set. EXACT shows statistics for only the specified domain.
PAGE 220
To show detail statistics for process $PROC1: + P $PROC1, DETAIL To show detail statistics and their associated ASAP states for process $SGPM: + P $SGPM, DETAIL, STATE To show aggregate process statistics along with detail statistics: + P, AGGREGATE To show only aggregate process statistics: + P, AGGREGATEONLY To retrieve all records for all processes that are issuing alerts: + P, AGG, MINSTATE To retrieve detail information about aggregate only Process domains (those ending in ##), enter this EDL DETA
PAGE 221
Note The only abbreviation for PROCESSBUSY is PB. P, PR, PRO, and so on are interpreted as PROCESS, not PROCESSBUSY. OUT file specifies the spooler or line printer where the ASAP output is sent. If you do not specify an output file, the output is displayed on your terminal. \* specifies that all process information for all systems is displayed. node specifies the individual system for which availability information is displayed. If you want information for all the systems, specify PROCESSBUSY \*.
PAGE 222
STATS displays these detailed processbusy availability attributes:  Time of the statistics information in database local civil time  Percentage of CPU process time during a sample interval  Process identification number (PIN)  Program file name of this process  Queue length of this process during a sample interval  Number of messages received per second  Number of messages sent per second  Number of physical memory pages currently in use  Average number of link control blocks in
PAGE 223
 Home terminal name of the process TIME hh:mm m/d/y specifies the ending time of the display information in hours, minutes, month, day, and year. For example, specifying ―TIME 10:15‖ when RATE is 5 indicates that statistics collected from 10:10 to 10:15 are displayed. hh is the hour. mm is the minute. m/d/y is the month, day, and year. Valid m/d/y entries are mm/dd/yy, yyyy/mm/dd, or mm/dd/yyyy.
PAGE 224
Pin The process identification number Pri The current execution priority of this process Program File The program file name of this process RcvQ The average queue length of this process during a sample interval Rmsg The number of messages received per second Smsg The number of messages sent per second Time The time of the statistics information in database local civil time Userid The group ID and user ID of the person accessing the process %WT The wait state.
PAGE 225
 These examples show the report output you can display with the PROCESSBUSY command: +PB !Default \ASAP TIME Busy Pin Program Object Filename Name Pri Userid -------------------%-------------------------------------------------00 3/01 10:51 1.6 312 $MM.ASAPXTST.DRV7 $JX17 80 255,34 1.6 313 $MM.ASAPXTST.DRV5 $JX15 80 255,34 1.6 314 $MM.ASAPXTST.DRV4 $JX13 80 255,34 .4 283 $SYSTEM.SYS03.OMLAM 200 255,255 .3 6 $NCP 201 255,255 01 3/01 10:51 1.6 312 $MM.ASAPXTST.DRV7 $JX16 80 255,34 1.6 313 $MM.ASAPXTST.
PAGE 226
event action INFO|CRITICAL [REPEAT] [NODISPLAY] [down] [-up] ACTION "string" | rule [WAIT wait] [NOREPEAT] Use the RANK command to set or view preferred-property-threshold settings (objectives). When a ranked property threshold is exceeded, the state of the ranked property is assigned an alert state. States in ASAP describe the status of a property such as up, down, warning, or critical. ASAP displays ranked alert states in the ASAP Client, the EMS subsystem, or both.
PAGE 227
event action INFO|CRITICAL [REPEAT] [NODISPLAY] [down] [-up] ACTION "string" | rule [WAIT wait] [NOREPEAT] attribute is the name of an attribute name as defined in ASAP EDL for the entity. The attribute must be defined with StatePair Yes, and it cannot be the StateIsOp (STATUS) attribute. operator is one of the following objective operators: > The calculated value must be greater than the objective value. < The calculated value must be less than the objective value.
PAGE 228
CRITICAL configures ASAP to generate a critical event when the objective is not met. REPEAT causes ASAP to repeat the event for each interval where the objective is not met. NODISPLAY overrides any global settings to suppress display of the event on the operator console. down is the event number to use for the down event, when the objective comparison fails. Events must be numbered in the range 6000 through 9999. Event number 4000 is used when this is not specified.
PAGE 229
action ACTION string | rule [WAIT wait] [NOREPEAT] string is an action string where the first word in the string is a command interpreter name such as TACL, SCF, or FUP, and the remainder of the string represents the command to be executed by that command interpreter. The string must be enclosed in double quotation marks, and ASAP converts any single quotes found within a string to double quotes.
PAGE 230
WAIT wait indicates the number of minutes ASAP should wait before retrying an action string against a particular entity and domain. The wait time also depends on the ASAP rate setting because ASAP validates objectives only once per cycle. NOREPEAT indicates that ASAP should not continue to repeat the action until the condition is corrected. LIKE sets attributes in the new or modified domain that are currently active in the LIKE domain.
PAGE 231
OBEYFORM returns objective information in OBEY file format suitable for playback to ASAP CI. entity must be specified when domain is specified; otherwise both are optional. Domain names can use the asterisk wild-card character as the last character in the name. LIST retrieves a list from the active set of objectives for all entities or for a specific entity. The LIST command communicates directly with running ASAP components to retrieve objective information.
PAGE 232
TELSERVWINDOW WINDOW Since CIP entity names are long and difficult to type ASAP supports the following abbreviations for the entity names: CIPCLIM CLIM CIPMONITOR MONITOR CIPPROVIDER PROVIDER Examples  To add or modify the record for the disk $DATA: RANK DISK $DATA, BUSY < 65  To specify that a file must be less than 90 percent full: RANK FILE $SYSTEM.FILE.
PAGE 233
 To deactivate a broken spooler device while it is repaired: RANK SPOOLER $SPLG\DEV\$LP, DEACTIVATE  To turn on all domains for all entities: RANK, ACTIVATE  To commit all objectives changes: RANK, COMMIT  To define an action to reload a CPU after it fails: RANK CPU, STATUS ACTION "TACL RELOAD <#DOMAIN>, PRIME" WAIT 15  To define a goal and action to secure the NonStop OS userid file to "OOOO": RANK FILE $SYSTEM.SYSTEM.
PAGE 234
 To define a goal that all foreign TCP/IP Port connections must originate from net 16: RANK TCPPORT, FADDR = 16.0.0.0  To define a goal that all foreign TCP/IP Port connections on Port 23 must originate from subnet 16.150: RANK TCPPORT 23, FADDR = 16.150.0.
PAGE 235
STATES displays RDF metric values and their objective states. TIME hh:mm m/d/y defines the ending time of the display information in hours, minutes, month, day, and year. For example, specifying TIME 10:15 when RATE is 5 indicates to display statistics collected from 10:10 to 10:15. hh is the hour. mm is the minute. m/d/y is the month, day, and year. Valid entries are mm/dd/yy, yyyy/mm/dd, or mm/dd/yyyy. VOLUMES displays the associated disk volumes.
PAGE 236
 To show detailed RDF metrics: RDF \*, DETAIL \TANDA Domain\Name\Hierarchy -------------------------------Dome->Tanda\Imagetrail\$Data4 Dome->Tanda\Purger\$Purg Dome->Tanda\Receiver\$Rec1 Dome->Tanda\Updater\$Up01 Dome->Tanda\Updater\$Up02 Dome->Tanda\Updater\$Up03 Status Date Time ---------------- ----- ----Running 5/11 9:39 Running 5/11 9:39 Running 5/11 9:39 Running 5/11 9:39 Running 5/11 9:39 Running 5/11 9:39 Error ----0 0 0 0 0 0 \DOME Domain\Name\Hierarchy -------------------------------Dome->T
PAGE 237
V2.10102 -------\TANDA \TANDA \TANDA \TANDA \TANDA \TANDA \DOME \DOME Num Domain\Name\Hierarchy --- --------------------------------------------------------------230 230 230 230 230 230 245 245 Dome->Tanda\Imagetrail\$Data4 Dome->Tanda\Purger\$Purg Dome->Tanda\Receiver\$Rec1 Dome->Tanda\Updater\$Up01 Dome->Tanda\Updater\$Up02 Dome->Tanda\Updater\$Up03 Dome->Tanda\Extractor\$Ext1 Dome->Tanda\Monitor\$Mntr continued...
PAGE 238
SET Command The SET command displays and sets these data collection and monitoring options: SET [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ACTION ON | OFF ACTOBJECT filename ACTSHELL filename APP entity-option ASAPLOG filename BACKUPCPU cpu | * BUFFERED ON | OFF CIP entity-option CLEANTIME time COLLECT \collect-node COMM entity-option [, entity-option], CPU BUSY % | QUEUE q | IO io | SWAP swaps DB db-file-prefix DBMAXDAYS [ [ entity ] days ] DBMAXDA
PAGE 239
[ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ PROXY PROXYCONFIG PROXYCPU PROXYOBJECT PROXYPARAM RATE RDF REMOTESECURITY RETAIN SLEEPTIME SPOOLER SWAP SYNC TAPE TERM TCP TMF TRACE ON | OFF filename number object-filename proxy-parameter minutes entity-option ON | OFF option time,time entity-option entity-option minutes,frequency entity-option logterm ON | OFF entity-option entity-option ON | OFF ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ACTION ON | OFF defines whether the ASAP action processing components are enabled.
PAGE 240
ACTOBJECT action-server-program-filename defines the action server program object filename. The default is SEEVIEW. ACTSHELL action-script-filename defines the action server script filename. The default is ASAPACT. APP entity-option [, entity-option]... determines settings and parameters for the APP entity. CPU cpu-num defines the CPU that the APP SGP process will reside in. ON | OFF enables or disables network-wide App availability statistics reporting. The default is OFF.
PAGE 241
BACKUPCPU cpu | * defines the preferred backup CPU number for the Collect or Monitor process started by the STARTUP command. If this CPU is unavailable, the next available CPU is used. * indicates that if a CPU is available, the Monitor or Collect process assigns the next available CPU as the backup CPU. BUFFERED ON | OFF specifies whether the information written to the database is buffered. ON specifies buffered writes. The default is OFF.
PAGE 242
MAXCLIM n defines the maximum of number of CLIM domain records that can be processed by the SGP. Domains are either autoconfigured or entered using the MONITOR command. The default is 128 domains. The maximum is 32767. MAXMON n defines the maximum of number of MONITOR domain records that can be processed by the SGP. Domains are either autoconfigured or entered using the MONITOR command. The default is 64 domains. The maximum is 32767.
PAGE 243
COLLECT collect-node defines the network node where the Collect process resides. The Monitor process reports statistics to the Collect process on the specified node. The default is the system where you issued the START COLLECT command. COMM entity-option [, entity-option ], determines settings, parameters, alarm threshold settings for the COMM entity. CPU cpu-num defines the CPU that the COMM SGP process will reside in. ON | OFF ON enables network-wide comm statistics reporting.
PAGE 244
VOLUME [$volume][.][subvolume] specifies the location of the Measure Data file. The default is $SYSTEM.SYSTEM. SUBVOL subvolume specifies the subvolume location of the Measure Data file. The default subvolume is SYSTEM. SWAPVOL [$volume] specifies the location for the Measfh swap volume. The default is $SYSTEM. Example +SET COMM ON, CPU 3, PARAMETERS "SUBVOL ASAPMEAS, RATE 15" DB db-file-prefix defines the database volume, subvolume, and file prefix of the collector server statistics files.
PAGE 245
The SET DBMaxDays option is only meaningful if SET RETAIN ROLLOVER is enabled. Note that setting DBMaxDays to a nonzero value also sets the RETAIN option to ROLLOVER. See HELP SET RETAIN for details. SET DBMAXDAYS days without an entity name asserts the maximum number of default days retained for entities, and enables the option when the days value is nonzero. For example, SET DBMAXDAYS 7 retains 1 week of data for all entities, unless further qualified.
PAGE 246
days specifies the number of daily purge file attempts for each entity. A value other than 1 causes the rollover algorithm to reattempt file purges on subsequent days. A days value other than 1 allows a rolled-over file that was open for analysis to have purge attempts for that file to occur on subsequent days. Thus if days were 3, there would be 3 daily attempts to purge the file for each entity. The value of days should typically not exceed 7. The maximum value for days is 60.
PAGE 247
yyyy indicates year rollover occurred. For example, 2004. mm indicates the month rollover occurred. For example, 12. dd indicates day rollover occurred. For example, 31. EEE indicates three letter entity acronym. For example, CPU, DSK, or EXP. SET DBRolloverSubvolPrefix ASAP results in the following filename for a file containing CPU statistics from 2004, December 31: $DATA.ASAP2004.Z1231CPU SET DBROLLOVERFILEPREFIX prefix Reserved for development use only.
PAGE 248
CPU cpu-number defines the CPU where the MEASFH process resides. If an unavailable CPU is selected, the ASPDSK process selects the next available CPU. The default is the same as the CPU that the ASAP CI is executing in. NOMEAS prevents disk performance statistics from being collected. Disk state information, and the disk information GBUsed, Capacity, MB Available, and %MBUsed are collected during each sample period. On D-series nodes, disk controller and unit information is displayed.
PAGE 249
CPU cpu-num defines the CPU that the EXPAND SGP process will reside in. ON | OFF ON enables or disables network-wide Expand line-handler availability reporting. The default is OFF. OBJECT ASAPEXP-program-file-name defines the ASAPEXP program object file name. If ON is specified, this program automatically starts on each node by the ASAP Monitor. The default is $SYSTEM.SYSTEM.ASAPEXP. PARAMETERS " expand-param [ expand-param]...
PAGE 250
PARAMETERS "FILE-param [ FILE-param]... " | null specifies the FILE specific parameter string to be passed to the ASAPFIL process at startup time. The default is the null string. The Parameter list must be enclosed in double quotes. The FILE-param option is: AGG when present, ASAP creates aggregate and/or state propagated group records for files defined as a part of logical file groups.
PAGE 251
RATE #mins sets a specific rate for the File SGP. See SET RATE. MAXAGGS defines the maximum number of aggregate domains. The File SGP will allocate memory to support that number of aggregate domains. Valid values are 2 through 32767. ASAP will always allocate 1 less domain than you specify. The default setting can vary by ASAP version. MAXDOMAINS defines the maximum number of monitored domains. The File SGP will allocate memory to support that number of monitored domains. Valid values are 2 through 32767.
PAGE 252
ID $asap-pid defines the ASAP process ID name set. This name set identifies a collection of ASAP processes that are operating together to gather ASAP performance statistics and operational state information. The default is $ZOO. Using the ID lets you operate several ASAP programs in the same node or resolve a name conflict.
PAGE 253
LOGFILE filename defines the name of the file used for ASAP CI I/O capture. LOGGING ON/OFF controls access to the file. The default is the current $volume.subvolume.logfile. LOGGING ON | OFF determines settings for the capture of ASAP CI I/O. ON enables the capture of ASAP CI I/O to a file defined by LOGFILE filename. OFF disables the capture of ASAP CI I/O. The default is OFF. LOGINTERVAL minutes defines the interval, in minutes that duplicate ASAP error events are suppressed.
PAGE 254
Examples SET LOGINTERVAL 60 minutes SET LOGINTERVAL 1440 Suppress duplicate error events for 60 Log each error type only once per day LOGSUPPRESS ON | OFF controls the suppression of duplicate ASAPLOG file error events and EMS tokenized error events. The default is OFF. OFF disables duplicate ASAP error event suppression. ON enables duplicate ASAP error suppression. The LOGINTERVAL setting determines the time duration for duplicate event suppression.
PAGE 255
This command adds $DATA as a disk to be monitored regardless of the SET MONITORADD setting: MONITOR DISK $DATA, ADD NODE entity-option [, entity-option]... determines settings and parameters for the NODE entity. CPU cpu-num defines the CPU that the NODE SGP process will reside in. ON|OFF enables or disables network-wide node availability reporting. The default is OFF. OBJECT ASAP/NCP-program-file-name defines the ASAP/NCP program object file name.
PAGE 256
ON | OFF indicates whether the alert is on or off. For example: 04-03-19 13:33:41 \CENTDIV.$ZOOS *TANDEM.ASAP.V02 004000 ASAP ALERT ZOOS Node \ZERO Status Down Notes  Only nodes that have an ASAP monitor reporting to the ASAP collector will have node down alerts generated for them.  The collector does not generate a node down alert for all nodes in an Expand network, but rather only for nodes that have an ASAP monitor on them.
PAGE 257
The default is $asap-database-subvolume.DBOBJ. Due to I/O activity in the ASAP database volume, HP recommends that you locate the objectives database file on another disk volume. OBJECTIVESEVENT ON | OFF enables ASAP for event generation when objectives are not met for attributes where event generation is specified. The default is OFF. OBJECTIVESEVENTUP ON | OFF enables ASAP for generation of up events when alerts for which down events were generated recover to an acceptable state. The default is OFF.
PAGE 258
CRITICAL DOWN Critical problem alert Down object alert The default is CRITICAL. OBJECTIVESEVENTMAX max-events-per-domain-per-interval defines the maximum number of events that ASAP should generate per domain per statistics interval. The default is 1. OBJECTIVESRANK STANDARD | PERCENT | HISTORICAL sets the type of analysis and ranking by ASAP when applying objectives against attribute values. The default is STANDARD. STANDARD ASAP reports on attributes as nonranked, up, down and critical.
PAGE 259
2. Delete or rename the existing ASAP database. 3. Restart the Collector. This re-creates the ASAP database using the new partition settings. partition-desc. used to set partitioning attributes. It has the format: {entity|DEFAULT} {file-opt} {part-num|BASE|ALL} part-opt [, part-opt...] entity the name of the specific entity (for example CPU, DISK) to which the partitioning options apply. To set default properties for all entities, use DEFAULT.
PAGE 260
part-opt is one of these partition options: { KEY key-value { SYSNO system-number { PRIEXT ext-value { SECEXT ext-value { MAXEXTENTS maxext-value { VOLUME volume-name } } } } } } key-value a partial key value, defining the lowest key value that can reside in the partition. Its format can be: * A string of characters enclosed in quotation marks (for example, ―abc‖). Use this to represent partial key values that contain only printable alpha-numeric data.
PAGE 261
volume-name the name of the NonStop OS volume on which the partition will reside. reset-desc. RESET resets all partitioning attributes for all entities, including the default settings. { entity | DEFAULT } RESET resets all partitioning attributes for the specified entity, or the default settings if you specify DEFAULT. { entity | DEFAULT } { part-num | ALL } RESET resets the partitioning attributes of the specified partition of the specified entity, or default settings.
PAGE 262
 You must define partitioning keys (made up of a combination of the SYSNO and KEY values) in ascending order for each partition. That is, the partitioning key for partition 2 must be greater than the partitioning key for partition 1, the key for partition 3 must be greater than the key for partition 2, and so on.  If Format 2 is on, you cannot specify MAXEXTENTS for a secondary partition.
PAGE 263
creating the CPU database. Partition description 4 is ignored, even though it is valid, because description 3 is invalid.  If partitioning is enabled for an entity, the Valid column of the SET PARTITION output indicates the status of each configured partition with one of these values: Value Indicates That the Partition Definition Is... Used by Collector to Create Database? Yes Valid. Yes No-Vol Invalid because no volume was specified.
PAGE 264
partition is created, but the MAXEXTENTS of the base partition is used.
PAGE 265
SET PARTITION FORMAT2 ON PRIMARY cpu | * defines the primary CPU number for the Collect or Monitor process started by the STARTUP command. If this CPU is unavailable, no other CPU is used. The default is asterisk (*), which is all CPUs for the specified system. PRIORITY server-priority defines the execution priority of the Monitor or Collect process started by the STARTUP command. The default is 160. PROCESS entity-option defines startup options for Process monitoring within ASAP.
PAGE 266
MINONLY when a MINONLY state is specified, the Process SGP operates in exception mode, writing only alerting detail domain records to the database. MINONLY is used to determine the state at which a domain is considered to be alerting and ASAP writes only those domain records to the database, removing them after they return to normal. A domain is considered to be alerting if ANY attribute state is greater than or equal to MINONLY. MINONLY is not applied to aggregate domains.
PAGE 267
The MONITOR PROCESS, LIST, DETAIL command will return information about the maximum value parameters and the memory pool utilization. Examples To turn process monitoring on and to set the state at which ASAP considers a process to be alerting enter: SET PROCESS ON, PARAM "MINSTATE 6" To turn on aggregation for all levels of all hierarchically named processes: SET PROCESS PARAM "AGG" PROCESSBUSY ENTRIES count | SUBSAMPLES count controls the collection of process statistics.
PAGE 268
PROXY ON|OFF ON|OFF The SET PROXY ON command enables ASAP Hybrid within ASAP Server. Hybrid settings are not visible within ASAP until this command is executed. ASAP Hybrid is an optional ASAP product. For information about configuring the ASAP Hybrid product, see the ASAP Hybrid Manual. Examples SET PROXY ON PROXYCONFIG filename filename The fully qualified, local ASAP Hybrid Proxy server configuration filename. The default is $SYSTEM.SYSTEM.ASAPPCNF. ASAP Hybrid is an optional ASAP product.
PAGE 269
PROXYPARAM proxy-parameter proxy-parameter A startup parameter for the ASAP Hybrid Proxy server. This item is for future use. ASAP Hybrid is an optional ASAP product. RATE minutes defines the interval, in minutes, that ASAP entity availability information are reported back to the process defined by the Collect and ID options.
PAGE 270
REMOTESECURITY ON | OFF defines whether remote passwords are checked when shutting down a remote ASAP monitored node or when obtaining status information about a remote ASAP monitored node. SET REMOTESECURITY OFF bypasses RemotePassword security checks. SET REMOTESECURITY ON forces RemotePassword checking of any remote node. The default is ON. RETAIN option defines the action to be performed against the database at cleantime. ALL retains all records indefinitely.
PAGE 271
down Collect and restarting it with a different sleep time reactivates collection to the database. time, time defines the beginning and ending times of the time range. The default is 0000,0000; it disables sleeping. Examples This example sets the sleeptime: +SET SLEEPTIME 0000, 0300 !No database collection between Midnight and 3:00 AM daily occurrence. +STARTUP COLLECT SPOOLER entity-option [, entity-option] determines settings and parameters for the Spooler entity. The default is OFF, $SYSTEM.SYSTEM.
PAGE 272
TRACE instructs the Spooler SGP to log trace records to the ASAP log file. Examples +SET SPOOLER ON, OBJECT $SYSTEM.SYSTEM.ASAPSPL, PARAMETERS “RATE 5” +SET SPOOLER ON, PARAMETERS “DETAIL” SWAP entity-option [, entity-option] determines settings and parameters for the Swap entity. The default is OFF, $SYSTEM.SYSTEM.ASAPSWP. CPU cpu-num defines the CPU that the SWAP SGP process will reside in. ON|OFF enables or disables network-wide swap availability reporting.
PAGE 273
If Monitor and Collect are in the same node, this option has no meaning. For this SYNC option to function, the Monitor must be accessed by someone with a supergroup user ID. For more information, see SYNCSLOW ON | OFF. minutes specifies the number of minutes past midnight. The default number of minutes is 0. frequency specifies the number of times the Monitor’s system clock is automatically synchronized to the node’s system clock. The default frequency is 0. The default is 0,0.
PAGE 274
TAPE entity-option [, entity-option] determines the settings and parameters for the Tape entity. The default is OFF, $SYSTEM.SYSTEM.ASAPTAP. CPU cpu-num defines the CPU that the TAPE SGP process will reside in. ON|OFF enables or disables network-wide tape availability reporting. OBJECT ASAP-tape-program-filename specifies the name of the Tape SGP file. The default is $SYSTEM.SYSTEM.ASAPTAP. PARAMETERS specifies tape-specific parameter string to pass to each Tape SGP at startup.
PAGE 275
ON enables terminal (or $0) logging. TCP entity-option defines startup options for TCP/IP and Telserv monitoring within ASAP. ON | OFF turns TCP/IP and Telserv monitoring on and off. The default is OFF. OBJECT filename specifies the name of the TCP SGP program file. The default is $SYSTEM.SYSTEM.ASAPTCP. PARAMETERS "TCP-param [ TCP-param ]... " | null specifies the TCP specific parameter string to be passed to the ASAPTCP process at startup time. The default is the string.
PAGE 276
ROUTE n defines the minimum number of minutes the SGP will wait before reconfiguring TCP Routes when they are being automatically configured by the SGP. The default is 60 minutes. SUBNET n defines the minimum number of minutes the SGP will wait before reconfiguring TCP subnets when they are being automatically configured by the SGP. The default is 60 minutes.
PAGE 277
MAXRTE n defines the maximum of number of TCPROUTE domain records that can be processed by the SGP. Domains are either autoconfigured or entered using the MONITOR command. The default is 1000 domains. The maximum is 32767. MAXSNT n defines the maximum of number of TCPSUBNET domain records that can be processed by the SGP. Domains are either autoconfigured or entered using the MONITOR command. The default is 1000 domains. The maximum is 32767.
PAGE 278
CPU cpu-num defines the CPU that the TCP SGP process will reside in. Examples SET TCP OBJECT $SYSTEM.ASAP.ASAPTCP, PARAMETERS "SCPNAME ZNET", CPU 2 SET TCP PARAM "SCPNAME $ZNET, PORT, SERVICE, WINDOW" TMF entity-option defines the settings and parameters for the TMF entity. entity-option is one of: CPU cpu-num defines the CPU that the TMF SGP process will reside in. ON | OFF enables or disables network-wide TMF availability reporting. The default value is OFF.
PAGE 279
+SET TMF ON, OBJECT $SYSTEM.ASAP.ASAPTMF, PARAMETERS "RATE 10" To set PARAMETERS to null, enter either of: SET TMF PARAMETERS SET TMF PARAMETERS, entity-option TRACE ON | OFF turns an internal trace on and off for debugging purposes only. Use this option only when assisting the HP Global Customer Support Center in problem diagnosis. The default is OFF. SHOW Command The SHOW command displays information about the Entities defined to ASAP using the ASAP Entity Definition Language (EDL).
PAGE 280
Examples SHOW SHOW SHOW SHOW SHOW SHOW DISK DISK, DETAIL DISK, ATTRIBUTES FILE FULL FILE, DETAIL, ATTRIBUTES SHUTDOWN Command The SHUTDOWN command stops ASAP Monitor, SGPs, and Collect processes on the nodes that you specify. Only someone with a super-group user ID can use this command. SHUTDOWN [ \* [ \node-name ] ] [ COLLECT | MONITOR ] [ [.] ppd-name ] \* shuts down the ASAP Monitor or Collect process on all nodes of the network. COLLECT specifies a Collect process.
PAGE 281
+ SHUTDOWN \* !shutdown all Monitors and SGPs if running. + SHUTDOWN \CHICAGO COLLECT !shutdown Chicago Collector Considerations  SHUTDOWN shuts down Monitor (default) or Collect processes.  After shutdown is complete, data collection stops. SPOOLER Command The SPOOLER command displays Spooler availability information for the specified nodes and Spooler domains. For an explanation of Spooler statistics, enter HELP SPOOLERSTATS at an ASAP prompt. SPOOLER [/OUT file/] [\*] [ [.
PAGE 282
* specifies to display the performance and state information for all spoolers on the specified system. If you do not specify a spooler or the wild-card character (*), statistics for all spoolers on the current system are displayed. SAMPLES count specifies the number of sample periods to be displayed. A sample period is defined by the RATE option in the SET command. You can specify 0 through 255 sample periods. The default sample period number is 1.
PAGE 283
Use this display only if your spooler configuration is not too large, or if you specify only certain spooler components using the EXACT option. SHORT when used with DETAIL or MINSTATE, displays information in short form. MINSTATE shows detailed information on subdomains with states greater than or equal to what is specified. states indicates the minimum state to report. AUTO indicates to use state 2 as the minimum. This is the default setting.
PAGE 284
+ SPOOLER, RAW It displays: VersionStr Sys Domain Name Status ---------- --- --------------- ---------\ASAP 1 $SPLS\COLL Active \ASAP 1 $SPLS\DEV Waiting \ASAP 1 $SPLS\PRINT Dormant \ASAP 1 $SPLS\SUPER Active Date Time ---------- ----2000/03/23 8:07 2000/03/23 8:07 2000/03/23 8:07 2000/03/23 8:07 V Error NumObjs - ----- ------1 0 2/---2 1 0 3/---3 1 0 2/---2 1 0 1/---1 continued...
PAGE 285
\ASAP Spooler Supervisor Status Date Time Error Cpu BCpu Prty ------------------------------ ---------- ----- ----- ----- --- ---- ---$SPLS\SUPER\$SPLS Active 03/23 8:07 0 1 2 149 continued... Jobs Batch Open Print Hold Fonts DevQs Locs Colls Devs PProcs Full% ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ------ ----392 0 0 0 100 6 200 53 2 6 3 50 continued...
PAGE 286
 To retrieve detailed information about the spooler print process $SPLS\PRINT\$FASTP: + SPOOLER $SPLS\PRINT\$FASTP, DETAIL It displays: \ASAP Spooler PrintProcess Status Date Time Error Cpu BCpu Prty Flags --------------------------- ---------- ----- ----- ----- --- ---- ---- ----$SPLS\PRINT\$FASTP Dormant 03/23 8:07 0 3 2 130 continued... Program File Name Jobs Batch Print Hold Locs Devs DevQs ------------------------ ----- ----- ----- ---- ---- ---- ----$SYSTEM.FASTP.
PAGE 287
+SET DISK ON, PARAMETERS +START \NODEB !Parameters nulled node-name specifies the individual system for which information is to be monitored or collected. This starts the ASAP Monitor or Collect process on this node only. The default is Monitor. Example This example shows how to use the STARTUP command: + + + + + + SET DB $DATA1.
PAGE 288
node specifies the individual system for which information is displayed. * specifies status information on all systems. MONITOR requests status information on the Monitor process. This is the default. If SGPs are active on the reporting system, status for the SGP is returned as well. COLLECT requests status information on the Collect process. TIMEOUT specifies how many seconds the status command should wait for a response.
PAGE 289
STATUS ACTIONS MSGS shows the most recent actions. STATUS ACTIONS MSGS shows actions for STATUS ACTIONS LOG ON | DETAIL turns on action logging. This option is not recommended except for debugging due to overhead. STATUS ACTIONS TRACE ... is for development purposes only. Table 6-10.
PAGE 290
APP ASAP Extension CIP CIP SGP CMM Comm SGP DSK Disk SGP EXP Expand SGP FIL File SGP NCP Node SGP PRO Process SGP RDF RDF SGP SPL Spooler SGP SWP Swap SGP TAP Tape SGP TCP TCP/IP SGP TMF TMF SGP HP NonStop ASAP Server Manual Page 290 of 360
PAGE 291
Example - Status Monitor +STATUS \ISLAND ! Show \ISLAND’s Status \ISLAND Primry Backup ---------- ------ -----$BOOM V05 1,196 0,177 $BOOM0 V05 0,145 $BOOM1 V05 1,203 $BOOM2 V05 2,216 $BOOM3 V05 3,003 $BOON V04 0,142 RDF $BOOG V05 1,245 NCP $BOOJ V05 1,180 DSK $BOOK V05 0,120 EXP $BOOL V05 1,021 FIL $BOOO V05 1,119 SPL $BOOQ V05 1,117 TAP $BOOR V05 1,246 TMF $BOOT V05 1,103 PRO $BOOU V05 1,208 COM $BOOV V05 2,069 TCP $BOOA V05 1,204 SWP $BOOC V05 1,204 CIP (collect \CENTDIV.
PAGE 292
Example - Status Actions STATUS \CHICAGO ACTIONS ! Status chicago action server STATUS \CHICAGO ACTIONS RUN ! Status chicago of actions run STATUS \CHICAGO ACTIONS ASAP ! Analysis of last action request STATUS ACTIONS MSGS 10 ! Show 10 most recent action msgs STATUS ACTIONS MSGS 100 10 ! Show 100th thru 91st most recent msgs STATUS ACTIONS ** ! Show taskids for all action tasks STATUS ACTIONS LOG ON ! Enable detail log, will show logname STATUS ACTIONS LOG OFF ! Disables detail logging HP No
PAGE 293
SWAP Command The SWAP command displays SWAP availability statistics for the specified nodes and swap file domains. Type HELP SWAPSTATS at the ASAP prompt for an explanation of SWAP performance statistics. For an alphabetical list, see the CPU Statistics table. SWAP [/OUT /] [\* ] [\] [ [.
PAGE 294
SAMPLES count specifies the number of sample periods to be displayed. A sample period is defined by the RATE option in the SET command. You can specify 0 through 255 sample periods. The default sample period number is 1. TIME hh:mm m/d/y defines the ending time of the display information in hours, minutes, month, day, and year. For example, specifying ―TIME 10:15‖ when RATE is 5 indicates that statistics collected from 10:10 to 10:15 are to be displayed.
PAGE 295
CPU number lists the statistics for swap files that are currently operating in the specified CPU number, cpu-number. DETAIL displays the processors swap files statistics as a whole for the specified CPU or system. Displays both the good and failed statistics for the following: OK/FAILED for each CPU  ALLOCATES The number of allocations made.  CREATES The number of reservations made for process creations.  FREES The number of allocations freed.  RELEASES The number of reservations released.
PAGE 296
Table 6-11. SWAP Statistics and Descriptions Statistics Description/Option ALLOCATES Number of good and failed allocations made for each CPU. AVAILABLE The default display is the number of memory pages available for each CPU. With the file option it displays number of memory pages available for each file. AVAIL% Percent of swap space available for each CPU. CREATES Number of good and the number of failed reservations made for process creations for each CPU.
PAGE 297
Examples These examples show some of the available options and their output: +swap, sample 4 \CENTDIV -------00 3/18 00 3/18 00 3/18 00 3/18 01 3/18 01 3/18 01 3/18 01 3/18 02 3/18 02 3/18 02 3/18 02 3/18 03 3/18 03 3/18 03 3/18 03 3/18 Time ----- Status Files SWAPTOTAL Avail FUll Reserved Reservations Available -------- ----- ---------- ----% ---% -------- ------------ -------- 12:59 12:58 12:57 12:56 12:59 12:58 12:57 12:56 12:59 12:58 12:57 12:56 12:59 12:58 12:57 12:56 Up Up Up Up Up Up Up Up Up Up
PAGE 298
SYNC Command The SYNC command requests the Monitor on the specified node to set the NonStop OS time of day clock to the NonStop OS time of day clock on the node where the Collect server resides. SYNC [ \* ] [ \node-name] [ MONITOR ] [ [.] ppd-name ] \* synchronizes information on all nodes. MONITOR synchronizes information on the Monitor process. node-name specifies the individual system for which information is to be displayed. ppd-name specifies a process pair directory name.
PAGE 299
node-name specifies a node name. node-number specifies a node number. Example + SYSTEM \MEMPHIS TAPE Command The TAPE command displays Tape availability information for the specified nodes and Tape domains. For an explanation of Tape statistics, enter HELP TAPSTATS at an ASAP prompt. TAPE [/OUT file/] [\* ] [ [.] * ] [, SAMPLES count ] [\node] [ [.] tapespec] [, TIME hh[:mm [m/d/y]]] [, STATES ] [, DETAIL ] [, EXACT ] OUT file specifies the spooler or line printer where the ASAP output is to be sent.
PAGE 300
STATES indicates to display states associated with tape attributes. DETAIL indicates to display detailed tapemount information for the specified tape domain. EXACT indicates to retrieve only information that exactly matches tapespec. Consideration  You cannot use TIME, SAMPLES, or \* with DETAIL.
PAGE 301
Checks Mnts Mtime TapeName ------ ---- ----- -------NL,BLP 0 0 BLP 0 0 BK001 + TpStatus -------SCRATCH TpLabel ------BACKUP ProcName -------------\ASAP.
PAGE 302
TapeName TpStatus TpLabel ProcName ProgName UserId Prot IO -------- -------- ------- -------------- -------- ------- ---- --ANSI \ASAP.$PROC FUP 33,23 No OUT continued... Action ---------------------------------MOUNT ANY APPROPRIATE SCRATCH TAPE + TCP Command TCP [/OUT /] [\* ] [ [.] * ] [,SAMPLES count ] [\node] [ [.] domain][,STATES ] [,TIME hh[:mm [m/d/y]] [, MINSTATE [AUTO] ] [ [state] ] [, COUNT count ] [,EXTRACT filename ] [,NOPRINT ] [,NOLINEBREAK ] [,AGE minutes ] entity [\* ] [ [.
PAGE 303
TCPPROCESS TCPQIO TCPROUTE TCPRTE TCPSOCK TCPSUBNET TCPUDP TELSERVPROCESS TELSERVSERVICE TELSERVWINDOW (or (or (or (or (or (or (or (or (or (or TCP) QIO) ROUTE) RTE) SOCK) SUBNET) UDP) TELSERV, or TP) SERVICE, or TS) WINDOW, or TW) domain Any TCP or Telserv domain (object) name SAMPLES the number of samples to display per domain STATES the objective states of TCP metric values TIME defines ending time and date of sample(s) to display DETAIL displays custom detailed TCP metric values for specific sub-entit
PAGE 304
EXTRACT extract TCP records from the ASAP database to a separate database file or to a process. If the specified file does not exist, it will be created NOPRINT suppress terminal output for EXTRACT commands NOLINEBREAK do not break output lines at 132 characters.
PAGE 305
TCP/OUT IPCSV/IP, RAW, DE, ST, TAB ",", NOLINEBREAK, SAMPLES 1000 TMF Command The TMF command displays TMF availability information for the specified nodes and TMF domains. For an explanation of TMF statistics, enter HELP TMFSTATS at an ASAP prompt. TMF [/OUT file/] [\* ] [ [.] * ][, [\node] [ [.] domain][, [, [, [, SAMPLES count TIME hh[:mm [m/d/y]] STATES DETAIL MINSTATE [state ] [AUTO ] [AUTOSHORT] ] ] ] ] ] ] ] * indicates to retrieve all tape records from all nodes.
PAGE 306
m/d/y is the month, day, and year. Valid m/d/y entries are mm/dd/yy, yyyy/mm/dd, or mm/dd/yyyy. STATES indicates to display all states associated with attributes. DETAIL indicates to display detailed information for the specified domain, without states. EXACT indicates to retrieve only information that exactly matches tapespec. MINSTATE displays TMF subdomains depending on the selected option: state shows subdomains with an OEM-state greater than or equal to state.
PAGE 307
Audittrail Tmf Transactions + Up Enabled Up 3/14 13:18 Master 3/14 13:18 3/14 13:18 - - 62 - 0.00 - - - 0 No  To display only the attributes associated with a state: + tmf, states \ASAP TMF Used -------------Auditdump Audittrail Tmf Transactions Status S Date Time Error S Active -------Enabled Up Started Up - ----- ----2 3/14 13:18 2 3/14 13:18 2 3/14 13:18 2 3/14 13:18 ----0 0 0 0 1 1 1 1 ------Yes - S Ovflw S Hold S 7 1 1 1 ----No - 1 1 1 1 ---No - - ---1 1 62 1 1 - continued...
PAGE 308
continued... Hold ---No + S Used S Tps S BeginTr - ---- - -------- - -------1 - 1 - 1 1 62 7 - 1 1 - 1 0.00 1 Enabled 1 - 1 - 1 - S 1 1 1 1 Catalog Trans S Hung -------- ----- - ---- 1 - 1 Active - 1 0 1 No S Duration S - -------- 1 - 1 1 - 1 1 - 1 1 0 1  To display details about all TMF transactions subdomains: + tmf transactions, minstate \ASAP Transactions ---------------------------\Asap.0.
PAGE 309
 To display details about all TMF audittrail subdomains where at least one attribute has a state value greater than 2 (if no audittrail subdomains meet this condition, all audittrail subdomains are displayed): + tmf audittrail, minstate auto \ASAP AuditTrail Date Time Ovflw S Hold S Used% S Thresh% ---------------- ----- ------ ----- - ---- - ----- - ------Master 3/14 13:18 No 1 No 1 62 7 80 continued... FirstPinnedFile Reason Dump TransDsbl% -------------------------- --------------- ---- ---------$DSV.
PAGE 310
Appendix A: Querying the ASAP Database The ASAP database is a set of key-sequenced files that you can query using Enform or user-written programs. This section shows a sample standard Enform query and a sample ASAPCOL as an Enform server. The ENFALL file contains a complete set of sample queries. Standard Enform Query This example shows a standard Enform query: ?section cpu !----------! ! Display cpu statistics by \node and cpu for each hour of the day.
PAGE 311
"Cpu Date Time Busy Q Disp Disc Chit Swap MQ Pcbx Lcbx"skip 1 "-------- --- ----- ----- ---- -- ---- ---- ---- ---- -- ---- ----" after change on ihour print space 9 cpuno as i3 space timestamp-date ( x ) as date "mb2/d2" space timestamp-time ( x ) as time "h2:m2" space cpubusy as i4 space cpuq as "[bz] i2" space cpudisp as "[bz] i4" space discrate as "[bz] i4" space chitrate as "[bz] i4" space swaprate as "[bz] i4" space memq as "[bz] i2" space pcbmax as "[bz] i4" space lcbm
PAGE 312
cpubusy := avg (busy over ihour) noprint cpuq := avg (qlen over ihour) noprint cpudisp := avg (disps over ihour) noprint discrate := avg (discs over ihour) noprint chitrate := avg (chits over ihour) noprint swaprate := avg (swaps over ihour) noprint memq := avg (mqlen over ihour) noprint pcbmax := max (pcb-use over ihour) noprint lcbmax := max (lcb-use over ihour) noprint after change on ihour print sysname cpuno space as i3 space timestamp-date ( x ) as date "mb2/d2"
PAGE 313
Appendix B: ASAP Data Definitions This appendix contains the ASAP database data definitions and record layouts that are stored in a file named ASPDDLDB. These formats can change from one product version to the next. DDL Section Definitions Primary Key Definitions The primary key is (sysno entity its), where its is a character-based inverted timestamp of the event. Entries are displayed from the most recent event to the oldest event, allowing efficient online access through the ASAP CI.
PAGE 314
Event Definitions DEF 02 02 02 02 02 END. Event. Ts Tsword Word Et Etword type type type type type binary binary binary binary binary 64. !GMT usec start timestamp 16 redefines Ts. 16 redefines Ts. 64. !elapsed time of event usecs 16 redefines Et. Query Key Definitions DEF 02 02 03 03 02 03 03 02 02 02 02 02 02 02 02 END. Q-key. ikey cpu-entity csysno ccpuno lh-entity lhsysno lhlinename Entity iyear imonth iday ihour imin isec irank !For Enform pic x(18). redefines ikey.
PAGE 315
04 END. nssvnn type binary 16. ! Extended Query Key The ASAP extended queue q-key with the domain name required for APP processing is: DEF Q-key-x. !For Enform 02 02 03 03 02 02 02 02 02 02 02 02 END. ikey pic x(74). app-entity redefines ikey. sysno type binary 16 display “m<\999.>”. domain type character 64. entity type character 66 redefines ikey. iyear pic x(67) redefines ikey. imonth pic x(68) redefines ikey. iday pic x(69) redefines ikey. ihour pic x(70) redefines ikey.
PAGE 316
02 clim-present 02 word present.
PAGE 317
DEF ZClimState. 02 clim-present 02 word present.
PAGE 318
DEFINITION CLIM-Stats. !Description.............Sect 02 system type binary 16 occurs 4 times. ! 02 word type binary 16 redefines system.! 02 sysname type character 8 redefines system. 02 P-key-x type *. ! 8.3 02 Q-key-x type * redefines P-key-x. ! 02 event type *. ! 02 Type type binary 16. ! PROV 02 AggRec type binary 16. ! 02 Spare type binary 16 occurs 6 times. ! 02 OpText type binary 16 occurs 5 times. ! 02 Status type character 1 redefines OpText. 02 OpState type binary 16. ! 02 Error type binary 64.
PAGE 319
02 02 02 02 02 02 02 END. size-32769-and-larger connected-clim-curr connected-clim-high rejected-connections deferred-sends total-messages-sent total-messages-recv type type type type type type type binary binary binary binary binary binary binary 32. 32. 32. 32. 32. 64. 64. DEF ZMonState.
PAGE 320
02 Q-key-x 02 event 02 Type PROV 02 AggRec 02 Spare 02 OpText 02 Status 02 OpState 02 Error 02 ErrorState remove) 02 Data 02 State END. type * redefines P-key-x. type *. type binary 16. type type type type type type type ! enform q-key extended ! ts, interval & info ! Record type CLIM, MON, binary 16. ! binary 16 occurs 6 times. ! binary 16 occurs 5 times. ! character 1 redefines OpText. binary 16. ! binary 64. ! binary 16. ! type ZMONData. type ZMONState. * CIP\CLIM\ DEF ZPROVData.
PAGE 321
Comm Statistics Definitions DEFINITION COM-STATS. 02 system 02 word 02 sysname 02 P-key 02 Q-key 02 event 02 Invalid 02 PCpu 02 PCpu-State 02 PPin 02 BCpu 02 BCpu-State 02 BPin 02 LDev 02 Type 02 SubType type type type type type type type type type type type type type type type type !Description binary 16 occurs 4 times. !system name binary 16 redefines system.!word alignment character 8 redefines system. *. !sysno, domain & its * redefines P-key. !enform q-key *. !ts, interval & info binary 16.
PAGE 322
02 02 02 02 02 02 02 02 02 02 END. NumRetries NumRetries-State NumTrans NumTrans-State AvgRespTime AvgRespTime-State type type type type type type binary binary binary binary binary binary 32. 16. 32. 16. 64. 16. Spare1 Spare2 Spare3 Spare4 type type type type binary binary binary binary 16. 16. 16. 16. ! ! ! ! ! ! Number retries perfor NumRetries State. Number transasctions. NumTrans State. Avg Response time/xac AvgRespTime State. CPU Statistics Definitions DEFINITION Cpu-stats.
PAGE 323
02 02 02 02 02 02 02 02 02 03 03 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 END. Disps-State type binary 16. !cpu dispatch state Chits-State type binary 16. !cache hit rate state Discs-State type binary 16. !disc i/o rate state pcb-use-State type binary 16. !pcbs in use state mem-use-State type binary 16. !pages locked state sys-use-State type binary 16. !syspool in use state pcbx-use-State type binary 16. !High Pin pcbs in use state tle-use-State type binary 16.
PAGE 324
02 Cmiss type binary 16. !Cache miss tot 512-4096 02 Qlen type binary 16. !Request Queue 02 Qmax type binary 16. !Request Qlen 02 Requests type binary 32. !Total write, read, seek 02 Reqs-blckd type binary 16. !Request blckd file locks 02 Swaps type binary 16. !Swap rate 02 Volsm-Qlen type binary 16. !Volume Semaphore queue 02 Volsm-Qmax type binary 16. !Volume semaphore qlen 02 Extra type binary 16 occurs 4 times. 02 Disk-devices occurs 2 times. 03 Invalid type binary 16.
PAGE 325
Expand Entity Statistics Definitions DEFINITION NET-stats.
PAGE 326
02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 frame-cnt error-cnt type binary 32. !base + 33 type binary 32. !base + 34 !-- LEVEL 4 Buff/Msg use -net-cur-io-buf type binary 32.!base + 35 net-max-io-buf type binary 32.!base + 36 net-lt64 type binary 32.!base + 37 net-lt128 type binary 32.!base + 38 net-lt256 type binary 32.!base + 39 net-lt512 type binary 32.
PAGE 327
02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 END. quer-rsps-sent-state type binary 16. quer-rsps-rcvd-state type binary 16. Mem-low-state type binary 16. Invalid-Frames-state type binary 16. frame-dropped-state type binary 16. Invalid-address-state type binary 16. Client-OpState type binary 16. Cpu-B type binary 16. Pin-B type binary 16 Cpu-State type binary 16. spare1 type binary 16. !Spare spare2 type binary 32. !Spare spare3 type binary 32. !Spare spare4 type binary 32. !Spare spare5 type binary 32.
PAGE 328
02 Files-State type binary 16. 02 02 02 02 02 02 02 FCode FFormat FType SQLType Partitions LastOpen Last Modif type type type type type type type binary binary binary binary binary binary binary 16. 16. 16. 16. 16. 64. 64. Spare1 Spare2 Spare3 Spare4 type type type type binary binary binary binary 16. 16. 16. 16. 02 02 02 02 END. !Number of files state !File code !1=Format1, 2=Format2 !Unstruct, relative, etc. !Protection view, table, etc.
PAGE 329
02 02 02 02 02 02 02 02 02 02 02 02 02 02 Spare OpText Status OpState Error ErrorState Cpu Cpustate BCpu BCpustate BPin Pri PriState Busy 02 BusyState 02 CBusy decimal 02 CBusyState 02 Affinity-w 02 Affinity Affinity 02 AffState 02 IPU 02 IPUState 02 BIPU 02 BIPUState 02 P-State 02 PState 02 PStateState 02 W-State 02 WState 02 WStateState 02 MPages 02 MPagesState 02 MSent 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 type type type type type type type type type type type type type type binary 16 oc
PAGE 330
02 SMode 02 SReq 02 PFS END. type binary 16. type binary 16. type binary 32. ! Stop mode ! Stop request mode ! Current PFS ProcessBusy Statistics Definitions DEFINITION Pcb-stats. 02 System 02 Word 02 Sysname 02 P-key 02 Q-key 02 Event 02 Cputype 02 Invalid 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 type type type type type type type type binary 16 occurs 4 times.!system name binary 16 redefines system. character 8 redefines system. *.
PAGE 331
02 02 02 02 Spare2 Spare3 Spare4 Spare5 type type type type Binary Binary Binary Binary 16 16 16 16 unsigned. unsigned. unsigned. unsigned.END. RDF Statistics Definitions DEFINITION RDF-STATS. !Description 02 system type binary 16 occurs 4 times. !system name 02 word type binary 16 redefines system.!word alignment 02 sysname type character 8 redefines system. 02 P-key-x type *. !sysno, domain & its 02 Q-key-x type * redefines P-key-x. !enform q-key extended 02 event type *.
PAGE 332
02 02 02 02 02 BCpu BCpu-State Priority Op-Text OpText type type type type type 02 02 02 02 OpState Error Error-State SplType type type type type 02 02 NumObjects NumTotObjects type binary 16. type binary 16. 02 02 02 02 02 02 02 02 02 02 NumJobs NumJobs-State BatchJobs BatchJobs-State OpenJobs OpenJobs-State PrintJobs PrintJobs-State HoldJobs HoldJobs-State type type type type type type type type type type binary binary binary binary binary binary binary binary binary binary 32. 16. 32. 16.
PAGE 333
02 02 03 FName 03 UnitSize 03 UnitAlloc 03 TotalUnits Device-ext 03 FName 03 Flags 03 FormName 03 RetryIntvl 03 NumRetries 03 RestartIntvl 03 MaxRetries PrintProc-ext 03 FName 03 Flags type character 26. !Collectors File name. type binary 16. type binary 32. type binary 32. redefines Buffer-int. type character 8. !Associated Print Process name. type binary 16. type character 16. type binary 16. type binary 16. type binary 16. type binary 16. redefines Buffer-int. type character 26.
PAGE 334
02 02 02 02 02 02 02 02 02 02 02 02 03 03 03 03 03 03 03 03 03 03 03 03 03 03 03 03 03 02 02 02 02 02 02 02 END. resize-ok-state type binary 16. !Resizes ok state resize-fail type binary 32. !Resizes failed resize-fail-state type binary 16. !Resizes failed state alloc-ok type binary 32. !Allocates ok alloc-ok-state type binary 16. !Allocates ok state alloc-fail type binary 32. !Allocates failed alloc-fail-state type binary 16. !Allocates failed state frees-ok type binary 32.
PAGE 335
02 02 Op-Text OpText 02 OpState type binary 16 occurs 12 times. !Operational status type character 1 redefines op-text. !Operational Status type binary 16.
PAGE 336
02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 SockLstn connattempt accepts connects drops conndrops closed segstimed rttupdated delack timeoutdrop rexmttimeo persisttimeo keeptimeo keepprobe keepdrops snd-total snd-pack snd-byte snd-rexmitpack snd-rexmitbyte snd-rexmitfast snd-acks snd-probe snd-urg snd-winup snd-ctrl bad-hdr-len rcv-total rcv-pack rcv-byte rcv-badsum rcv-badoff rcv-
PAGE 337
02 pcbcachemiss 02 persistdrop 02 badsyn 02 droppedsyn 02 sc-added 02 sc-completed 02 sc-timed-out 02 sc-overflowed 02 sc-reset 02 sc-unreach 02 sc-bucketoverflow 02 sc-aborted 02 sc-dupesyn 02 sc-dropped END. DEF 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 type type type type type type type type type type type type type type binary binary binary binary binary binary binary binary binary binary binary binary binary binary 32. 32.
PAGE 338
02 badseqs 02 unack 02 timeout 02 noport 02 rcv-urg 02 rcv-dup-pack 02 rcv-dup-byte 02 rcv-part-dup-pack 02 rcv-part-dup-byte 02 rcv-out-pack 02 rcv-out-byte 02 rcv-after-win-pack 02 rcv-after-win-byte 02 rcv-after-close 02 rcv-win-probe 02 rcv-dup-ack 02 rcv-ack-too-much 02 rcv-ack-pack 02 rcv-ack-byte 02 rcv-win-update 02 paws-drop 02 predict-acks 02 predict-data 02 pcbcachemiss 02 persistdrop 02 badsyn 02 droppedsyn 02 sc-added 02 sc-completed 02 sc-timed-out 02 sc-overflowed 02 sc-reset 02 sc-unreach 02
PAGE 339
02 Word 02 bad-hdr-len 02 bad-xsum 02 nosum 02 bad-len 02 noport 02 noportbcast 02 fullsock 02 pcbcachemiss 02 out-pkts 02 in-pkts-dropped 02 out-pkts-dropped END. type type type type type type type type type type type type binary binary binary binary binary binary binary binary binary binary binary binary DEF ZICMP6Data. 02 err type binary 02 Word type binary 16 redefines err.
PAGE 340
02 old-short 02 old-icmp 02 OutEchoRply 02 OutDstUnrch 02 OutSrcQnch 02 OutRedirect 02 OutEcho 02 OutTimeExcd 02 OutParamPrb 02 OutTimeStmp 02 OutTimeSRpl 02 OutInfoReq 02 OutInfoRpl 02 RouterSolicit 02 badcode 02 too-short 02 xsum 02 bad-len 02 reflect 02 InEchoRply 02 InDstUnrch 02 InSrcQnch 02 InRedirect 02 InEcho 02 InTimeExcd 02 InParamPrb 02 InTimeStmp 02 InTimeSRpl 02 InInfoReq 02 InInfoRpl 02 RouterAdvertise 02 bad-rap-subcode 02 bad-addrlist 02 bad-wpa 02 rdisc-nrecorded END.
PAGE 341
02 fragmented 02 ofragmented 02 cantfrag 02 badoptions 02 noroute 02 badvers 02 rawout 02 badsrcintf 02 fragoverflow END. type type type type type type type type type binary binary binary binary binary binary binary binary binary 32. 32. 32. 32. 32. 32. 32. 32. 32. DEF ZIP6State. 02 ztotal type binary 16. 02 Word type binary 16 redefines ztotal. 02 bad-xsum type binary 16. 02 too-short type binary 16. 02 too-small type binary 16. 02 bad-hdr-len type binary 16. 02 bad-len type binary 16.
PAGE 342
02 wild-card END. type binary 16. DEF ZQIO6Data. 02 data-mds type binary 32. 02 Word type binary 16 redefines data-mds. 02 max-data-mds type binary 32. 02 dup-mds type binary 32. 02 max-dup-mds type binary 32. 02 no-data-mds type binary 32. 02 no-dup-mds type binary 32. 02 res-recov-run type binary 32. 02 qio-limit-warns type binary 32. 02 qio-driver-errs type binary 32. 02 curr-pool-space type binary 32. 02 max-pool-space type binary 32. 02 pool-fails type binary 32. 02 total-mbufs type binary 32.
PAGE 343
02 total-mbufs 02 curr-mbufs-inuse 02 max-mbufs-inuse 02 mbuf-fails 02 dup-driv-mds 02 max-dup-driv-mds 02 no-dup-driv-mds 02 size-128 02 size-256 02 size-512 02 size-1024 02 size-2048 02 size-4096 02 size-8192 02 size-12288 02 size-16384 02 size-32768 02 size-57344 02 qio-so-ip 02 so-forced-close 02 qio-so-que-fulls 02 mdcopy-adj 02 outhdr-adj 02 outdata-adj END.
PAGE 344
DEF ZIGMP6Data. 02 rcv-total type binary 32. 02 Word type binary 16 redefines rcv-total. 02 rcv-tooshort type binary 32. 02 rcv-badsum type binary 32. 02 rcv-queries type binary 32. 02 rcv-badqueries type binary 32. 02 rcv-report type binary 32. 02 rcv-badreports type binary 32. 02 rcv-ourreports type binary 32. 02 snd-reports type binary 32. END. DEF ZIGMP6State. 02 rcv-total type binary 16. 02 Word type binary 16 redefines rcv-total. 02 rcv-tooshort type binary 16. 02 rcv-badsum type binary 16.
PAGE 345
02 Word type binary 16 redefines allmons-sent. 02 somemons-sent type binary 32. 02 allbutme-sent type binary 32. 02 dpas-rcvd type binary 32. 02 migr-rcvd type binary 32. 02 loopbk-rcvd type binary 32. 02 ipfrag-rcvd type binary 32. 02 unk-rcvd type binary 32. 02 bad-frmt-rcvd type binary 32. END. DEF ZMONGQ6State. 02 allmons-sent type binary 16. 02 Word type binary 16 redefines allmons-sent. 02 somemons-sent type binary 16. 02 allbutme-sent type binary 16. 02 dpas-rcvd type binary 16.
PAGE 346
02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 rx-total type binary 32. Word type binary 16 redefines rx-total. rx-idle-discards type binary 32. rx-toosmall type binary 32. rx-tooshort type binary 32. rx-badvers type binary 32. rx-errors type binary 32. rx-local type binary 32. rx-nonlocal type binary 32. rx-multicast type binary 32. rx-badaligns type binary 32.
PAGE 347
02 fwd-eother END. DEF 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 type binary 32. ZIP66State. rx-total type binary 16. Word type binary 16 redefines rx-total. rx-idle-discards type binary 16. rx-toosmall type binary 16. rx-tooshort type binary 16. rx-badvers type binary 16. rx-errors type binary 16. rx-local type binary 16. rx-nonlocal type binary 16. rx-multicast type binary 16.
PAGE 348
02 fwd-baddst 02 fwd-badsrc 02 fwd-enobufs 02 fwd-emsgsize 02 fwd-eother END. type type type type type binary binary binary binary binary 16. 16. 16. 16. 16. DEF ZICMP66Data. 02 tx-error type binary 32. 02 Word type binary 16 redefines tx-error. 02 tx-error-drops type binary 32. 02 tx-nobufs type binary 32. 02 tx-rlimit-drops type binary 32. 02 rx-total type binary 32. 02 rx-info type binary 32. 02 rx-error type binary 32. 02 rx-tooshort type binary 32. 02 rx-checksum type binary 32.
PAGE 349
DEF ZICMP66State. 02 tx-error type binary 16. 02 Word type binary 16 redefines tx-error. 02 tx-error-drops type binary 16. 02 tx-nobufs type binary 16. 02 tx-rlimit-drops type binary 16. 02 rx-total type binary 16. 02 rx-info type binary 16. 02 rx-error type binary 16. 02 rx-tooshort type binary 16. 02 rx-checksum type binary 16. 02 rx-notifications type binary 16. 02 rx-torawip6 type binary 16. 02 rcv-queries type binary 16. 02 rcv-badqueries type binary 16. 02 rcv-reports type binary 16.
PAGE 350
02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 02 END.
PAGE 351
02 udp-filters-err 02 udp-filters-dereg 02 port-filters-drop 02 data-drop 02 subnet-abort 02 subnet-reset 02 subnet-last-err 02 media-lost END. DEF zSubnet6State.
PAGE 352
DEF ZROUTE6Data. 02 zref-cnt 02 word 02 zsubnet-name 02 zallroute 02 zsa-family 02 zradix-type 02 zusage END. type type type type type type type binary 32. binary 16 redefines zref-cnt. character 8. character 4. character 6. character 6. binary 32. DEF ZROUTE6State. 02 zref-cnt 02 word 02 zsubnet-name 02 zallroute 02 zsa-family 02 zradix-type 02 zusage END. type type type type type type type binary binary binary binary binary binary binary 16. 16 redefines zref-cnt. 16. 16. 16. 16. 16.
PAGE 353
02 02 02 02 02 02 02 02 02 END. zsend zrecv family zloc-addr6 zloc-word zloc-filler zforgn-addr6 zforgn-word zforgn-filler type type type type type type type type type binary binary binary binary binary binary binary binary binary 16. 16. 16. 64. 16 redefines zloc-addr6. 64. 64. 16 redefines zforgn-addr6. 64. DEF ZPORT6State.
PAGE 354
TCPIP TELNET Entity Description ASAP 2.8 * This defines the structure written to ASAPCOL by the TCPIP SGP DEF ZTelnetData. 02 zin-conn 02 Word 02 ztotal-open 02 ztotal-net-data 02 zavg-actv-term 02 ztotal-spi-req 02 ztotal-user-data 02 ztotal-net-req 02 ztotal-user-req END. type type type type type type type type type binary binary binary binary binary binary binary binary binary 32. 16 redefines zin-conn. 32. 32. 32. 32. 32. 32. 32. DEF ZTelnetState.
PAGE 355
02 02 02 02 02 02 02 02 02 02 02 02 02 END. zprim-cpu zprim-pin zprim-fnum zbkup-cpu zbkup-pin zbkup-fnum zproto zlport zloc-addr zfport zforgn-addr zsend zrecv DEF ZPortState. 02 zprocname 02 Word 02 Caid 02 Paid 02 objectfile 02 zprim-cpu 02 zprim-pin 02 zprim-fnum 02 zbkup-cpu 02 zbkup-pin 02 zbkup-fnum 02 zproto 02 zlport 02 zloc-addr 02 zfport 02 zforgn-addr 02 zsend 02 zrecv END.
PAGE 356
* This defines the structure written to ASAPCOL by the TCPIP SGP DEF ZWindowData.
PAGE 357
02 zforgn-filler type binary 16. 02 zcaller-addr6 type binary 16. 02 zcaller-filler type binary 16. 02 Openers type binary 16. 02 Processes type binary 16. 02 Active type binary 16. END. DEFINITION WINDOW-Stats1. !Description.............Sect 02 system type binary 16 occurs 4 times. ! system name 02 word type binary 16 redefines system.! word alignment handle 02 sysname type character 8 redefines system. 02 P-key-x type *. ! sysno, domain & its 8.3 02 Q-key-x type * redefines P-key-x.
PAGE 358
02 02 02 02 02 02 02 END. OpText Status OpState Error ErrorState Data State type type type type type type type binary 16 occurs 4 times. ! character 1 redefines OpText. binary 16. ! binary 64. ! binary 16. ! ZServiceData. ! ZServiceState. ! Op state text Operational state Error (if any) Error state (or remove) SERVICE data SERVICE states TMF Entity Statistics Definitions DEFINITION TMF-STATS.
PAGE 359
02 END. Spare4 type binary 16. DDL Section Record Declarations ASAP Database Record Declarations RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File CPU. is DBCPU. SYS. is DBSYS. NET. is DBEXP. PCB. is DBPCB. NCP. is DBNCP. DSK. is DBDSK. APP. is DBAPP. RDF. is DBRDF. FIL. is DBFIL. SPL. is DBSPL. TAP. is DBTAP. TMF. is DBTMF. PRO. is DBPRO. COM.
PAGE 360
File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File RECORD File is $EXPDB. PCB-SRV. is $PCBDB. NCP-SRV. is $NCPDB. DSK-SRV. is $DSKDB. APP-SRV. is $APPDB. RDF-SRV. is $RDFDB. FIL-SRV. is $FILDB. SPL-SRV. is $SPLDB. TAP-SRV. is $TAPDB. TMF-SRV. is $TMFDB. PRO-SRV. is $PRODB. COM-SRV. is $COMDB. TCP-SRV. is $TCPDB. SWP-SRV. is $SWPDB. CIP-SRV. is $CIPDB. Def is net-stats. Sequence is Q-key. End.