ASAP Server Components Overview ASAP Server Components APP

ASAP Server Components Overview ASAP Server Components APP CPU & PCB DISK EXPAND ASAP CI MONITOR NODE COLLECTOR PROCESS RDF LOG SPOOLER TAPE TMF 1

ASAP - Command, Control, & Diagnosis ASAP command interpreter provides: • Command, control, status, and reporting for ASAP. • ASAP database configuration. • ASAP CI is also used to view ASAP exception log. This section covers: • ASAP CI control commands. • ASAP CI control example. • ASAP CI status and log commands. • ASAP CI database configuration commands. • ASAP CI database maintenance commands. • ASAP CI server time synchronization. • ASAP CI entity display commands. • ASAP CI basic commands. 2

ASAP CI - Control Commands SET Displays or Alters ASAP Server Settings. STARTUP Starts COLLECT or MONITOR in specified nodes. SHUTDOWN Stops COLLECT or MONITOR in specified nodes. PC Host Remote Hosts 3

ASAP DATABASE FEATURES DBAPP DBDSK DBCPU § ASAP Relational DB provides History of Objects, States, Performance, and Service Level objectives. § Data Base Automatically maintained. § User defined database partitions. § Schema published in TIM and as DDL on CD § Published DDL allows Ad Hoc DB Queries § Provides Customer/Third Party DB access 4

ASAP Database Configuration ASAP Database configuration allows: § Default Database support. § User defined Database location. § Defined partition support for any ASAP entity. § User defined default partitioning rules. Database configuration commands: § SET Collect command. § SET DB command. § SET SLEEPTIME command. § SET Partition command. Note: Asap Version 1 records can be written to the ASAP Version 2 collector. 5

Database Commands § SET COLLECT defines the Node were the ASAP Database resides. SET COLLECT DBNODE § SET DB defines the location ($Volume. subvol) for the ASAP database files SET DB $DATA. ASAPDB. DB § SET SLEEPTIME defines the time range (hhmm, hhmm) that statistics collection does not occur. Although statistics collection ceases, the ASAP system remains active. SET SLEEPTIME 00: 00, 03: 30 6

Partition Command § SET PARTITION displays and defines partitioning parameters for the ASAP database. Asap partitioning uses standard NSK partitioning rules. The parameters can be set individually for each entity, globally for all entities, or may utilize a combination of the two approaches. To display the current partitioning settings, enter SET PARTITION without any additional parameters. $Data 00 $Data 01 $Data 02 DBCPU Part 0 DBCPU Part 1 DBCPU Part 2 7

SET PARTITION Continued § SET PARTITION [ | | FORMAT 2 ] The has the following format: { | DEFAULT } { | BASE | ALL } [, ] is the name of the specific entity (e. g. CPU, DISK) to which the partitioning options apply. DEFAULT can be used in place of an entity name in order to set default properties which will apply to all entities. is the partition number to which the partitioning options apply. The value must be between 0 and 15 inclusive, BASE, or ALL, where 0 and BASE indicate the base partition of the given entity, and values 1 - 15 indicate secondary partitions. ALL can be used in place of a partition number in order to specify primary and secondary extent sizes or maxextents values that are to apply to all partitions of the entity. 8

SET PARTITION Continued is one of: {KEY } { SYSNO } { PRIEXT } { SECEXT } { MAXEXTENTS } { VOLUME } The SET PARTITION command can also be used to reset the partitioning attributes for all entities, a given entity, a single partition, or a single attribute of a single partition. To do so, use the SET PARTITION command with a . SET PARTITION RESET SET PARTITION DEFAULT 1 KEY “FUNDSTRANSFER” RESET PARTITION FORMAT 2 ON|OFF allows files to grow beyond 2 GB. 9

SET PARTITION Notes NOTES: § A VOLUME cannot be specified for a base partition (i. e. partition number = 0), since this is controlled by the SET DB command. § Volume, Sys. No, and Key values cannot be specified if the partition number is all. § A KEY and/or SYSNO value must be given for all secondary partitions. § Partitioning keys (made up of a combination of the SYSNO and KEY values) must be defined in ascending order for each partition. § A VOLUME must be given for all secondary partitions. 10

Notes Continued § MAXEXTENTS values cannot be specified for secondary partitions if Format 2 is ON. PRIEXT, SECEXT, and MAXEXTS values specified for partitions of the DEFAULT entity are used when creating partitions of all other entities. The collector automatically adjusts the length of the partitioning keys. SET DB command will reset all partitioning attributes. The Collector utilizes only valid partition descriptions when creating the database. When partitioning is enabled for a given entity, the "Valid" column of the SET PARTITION output will indicate the status of each configured partition. The column contains one of the following values: § § § • • • YES No-Vol No-Sys/Key No-Vol, Sys/Key No-Prior Inv ? ? -Key Seq ? ? -Dup Vol ? ? -Vol Un. Known ? ? -Vol Down ? ? -Partn Size Max. Ext n/a 11

SET PARTITION Examples § SET PARTITION DEFAULT ALL PRIEXT 256, SECEXT 512, MAXEXTENTS 300 § SET PARTITION PROCESS 1 SYSNO 53 § SET PARTITION PROCESS 1 SYSNO 11, VOLUME $DATA 1 § SET PARTITION PROCESS 2 SYSNO 21, VOLUME $DATA 2 § SET PARTITION APP 1 SYSNO 120, KEY “FUNDSTRANSFER”, VOLUME $DATA § SET PARTITION APP 0 SYSNO 120 12

ASAP 2 Entities APP Reports APPLICATION availability. CPU Reports CPU availability. DISK Reports Disk devices availability. EXPAND Reports Expand Path and Line availability. FILE Reports on File or Subvolume availability. NODE Reports on Expand end-to-end node availability. PROCESS Reports on user selected processes. PROCESSBUSY Reports on busiest process availability. RDF Reports on RDF availability. SPOOLER Reports on Spooler availability. TAPE Reports on Tape devices availability. TMF Reports on TMF availability. SYSTEM Reports on System availability. 13

ASAP 2. 0 ENTITIES ASAP Entities Characteristics: § Default Entity support. § User defined Entity configurations. § Entities can report on availability of user specified objects. § User defined threshold settings of specified objects and attributes using the operators >, <, =, <>, <= and >=. Entity configuration commands: § SET command. § MONITOR command. § RANK command. Note: Asap Version 1 records can be written to the ASAP Version 2 collector. 14

CPU Entity Features $0. . F § All CPU types are supported. § All memory types are supported. § Auto-discovery of all configured cpu’s. § Performance availability counters. § Supports user defined CPU object monitoring. § Supports user defined discrete object thresholds 15

CPU Attributes Attribute Description Value BUSY Percent CPU busy Integer QUEUE CPU 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 Percent of total physical memory pages locked Integer PGS Percent of total physical memory pages locked Integer PCB Percent usage low pcb’s (pins 0 -254) Integer PCBX Percent usage of high pcb’s pins above 255 Integer TLE Percent usage of time list elements Integer SEGS Percent of maximum virtual memory segments used Integer 16

DISK Entity Features $J § All disk types are supported except for Virtual disks and optical disks. § Auto-discovery of all configured disk volumes. § Availability information reported by the client is: The largest performance value of a volume pair. Highest operational state information of the volume pair. § Supports user defined disk object monitoring. § Supports user defined discrete object thresholds 17

DISK SET Command § SET Disk ON|OFF Enables/Disables disk availability information. Default OFF § Set Disk object $System. system. asapdsk defines the Disk program object filename. Default $SYSTEM. ASAPDSK § Set Disk Param “Param, param 1…” Disk params: CPU defines the Cpu where the MEASFH process will reside. NOMEAS prevents disk performance statistics and availability thresholds from being collected. RATE defines the interval, in minutes, that DISK availability information is reported back to the Collector. The Disk SGP uses the ASAP rate as the 18 default.

DISK SET Command Continued Disk Params Cont: VOLUME [<$volume>][. ][] specifies the location of the Measure Data file. Default $System. system SUBVOL 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. Here is an example of the SET DISK command: +SET DISK ON, OBJECT $SYSTEM. ASAPDSK, PARAMETERS “SWAPVOL $DATA. ASAP RATE 10" 19

DISK Attributes ATTRIBUTE DESCRIPTION Value P Primary disk path in use, value = P or B Char 1 wide M Mirror disk path in use, value = P or B Char 1 wide CPU Primary CPU # of the DP 2 process for the volume Integer FULL Percentage of disk space currently used Integer REQUESTS Number of Disk I/O requests per second Integer BUSY Percent time disk busy reading, writing, & seeking Integer WRITE Percent time disk busy writing Integer 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 Integer INKB Input kilobytes per second Integer OUTKB Output kilobytes per second Integer RATE Total of DP 2 reads, writes, and seeks per second Integer READS Number of DP 2 read operations per second Integer 20

DISK – Troubleshooting tips § DISK SGP uses measure API interface for collecting raw DP 2 counters. – Use the commands in MEASCOM for determining if it is a measure problem or disk entity problem § ADD MEASUREMENT $VOL. SUBVOL. ZASP § STATUS MEASSUBSYS § LISTACTIVE DISC $VOL (Cpu, Channel, Controller Unit) LISTACTIVE DISC $SYSTEM (0, 0, %24, 0) or (0, 0, 20, 0) § LISTACTIVE DISC $VOL (cpu, SVNET, Group, Module, Slot) LISTACTIVE DISC $SYSTEM (0, X, 1, 1, 11) § STOP MEASUREMENT $VOL. SUBVOL. ZASP § DELETE MEASUREMENT $VOL. SUBVOL. ZASP 21

EXPAND Entity Features $K § All Expand line types are supported. Including multi-line Expand. § Auto-discovery of all configured Expand lines and Expand paths. § Performance availability counters. § Expand SGP is a multiple entity. The two entity types are Expand. IP. § Supports user defined Expand object monitoring. § Supports user defined discrete object thresholds 22

EXPAND Set Command § Set Expand ON|OFF Enables/Disables Expand availability information. Default OFF § Set Expand object $System. system. asapdsk defines the Expand program object filename. Default $SYSTEM. ASAPEXP § Set Expand Param “Param” Expand params: RATE defines the interval, in minutes, that EXPAND statistics are reported back to the Collector. The Expand SGP uses the ASAP rate as the default. Here is an example of the SET EXPAND command: +SET EXPAND ON, OBJECT $SYSTEM. ASAPEXP, PARAMETERS “RATE 10" 23

EXPAND Attributes ATTRIBUTE DESCRIPTION Value POOL Percent utilization of Expand line handler I/O Pool Integer PFAIL Number of pool failures during the sample interval Integer No. Buf Number of no buffer failures Integer BCC Number of BCC errors during the sample interval Integer Nak. Snt Number of Level-4 negative acks sent Integer Nak. Rvd Number of Level-4 negative acks received Integer Pkt. Snt Number of Level-4 packets sent Integer Pkt. Rvd Number of Level-4 packets received Integer PThru. Snt Number of Level-4 Pass. Thru packets sent Integer PThru. Rvd Number of Level-4 Pass. Thru packets received Integer Lnk. Snt Number of requests sent Integer Lnk. Rvd Number of requests received Integer 24

EXPANDIP Attributes ATTRIBUTE DESCRIPTION Value DFram. Snt Number of IP/ATM data frames sent Integer DFram. Rvd Number of IP/ATM data frames received Integer DFByte. Snt Data kilobytes sent per second Integer DFByte. Rvd Data kilobytes received per second Integer Cnct. Cmd. Snt Number of IP/ATM connect commands sent Integer Cnct. Cmd. Rvd Number of IP/ATM connect commands received Integer Cnct. Rsp. Snt Number of IP/ATM connect responses sent Integer Cnct. Rsp. Rvd Number of IP/ATM connect responses received Integer 25

EXPANDIP Attributes Continued ATTRIBUTE DESCRIPTION Qry. Cmd. Snt Number of query commands sent Value Integer Qry. Cmd. Rvd Number of query commands received Integer Qry. Rsp. Snt Number of query responses sent Integer Qry. Rsp. Rvd Number of query responses received Integer Mem. Low Number of times memory low indication given by QIO Integer Inv. Frn Number of IP/ATM invalid frames received Integer Drp. Frm Number of IP/ATM frames dropped Integer Inv. Adr Number of IP/ATM frames rcvd from an unexpected system Integer 26

EXPAND – Troubleshooting tips § Expand SGP uses SPI interface for communicating with the Expand manager process $Zexp. – Use the commands in SCF for determining if it is a Expand manager problem or Expand entity problem § Assume line $ Type 63 subtype 1, 2, 6 are Multiline Expand. § STATS LINE $ § STATS PATH $ non multiline Expand § STATS PATH $ § STOP $ZEXP if allowed by customer 27

File Features $L § File domain can be a selected file or a sub-volume § Domain name examples: – $System. system. userid – $Data. sqldb § All file types supported, including Format 2, SQL, virtual files, but not OSS files § Sub-domains attributes and states are aggregated to the sub-volume domain level § Detailed information about sub-domains of a sub-volume is available via ‘Show Object Details’ Client popup menu § Auto-discovers ASAPMON file § Supports user defined file object monitoring. § Supports user defined discrete object thresholds 28

FILE Set Command § Set File ON|OFF Enables/Disables file availability information. Default ON § Set File object $System. Asapfil defines the File program object filename. Default $SYSTEM. ASAPFIL § Set File Param “Param” File params: RATE defines the interval, in minutes, that FILE availability information is reported back to the Collector. The File SGP uses the ASAP rate as the default. Here is an example of the SET FILE command: +SET FILE ON, OBJECT $SYSTEM. ASAPFIL, PARAMETERS “RATE 10" 29

File Attributes State Pair? Domain Description File domain name *Status Yes Operational Status Error Yes Error number indicating status of data Full Yes Percentage full Eof Yes Size in bytes Owner Yes Group, User Rwep Yes Read, Write, Execute, Purge security Open Yes File is open? Tmf Yes File is audited by TMF? Files Yes Number of files in sub-volume Code File code Format File format Type File type Partitions Number of partitions Last. Open Last time file was opened in LCT Last. Modif Last time file was modified in LCT *Status attribute also has State. Is. Op=Yes, you cannot set objectives on it. 30

NODE Entity Features $G § Auto-discovery of all configured nodes. § End to End Performance availability counters. § Does NOT support user defined node object monitoring. § Does NOT support user defined discrete object thresholds 31

NODE Set Command § Set Node ON|OFF Enables/Disables Node availability information. Default OFF § Set File object $System. Asapncp defines the node program object filename. Default $SYSTEM. ASAPNCP § Set Node Param “Param” Node params: RATE defines the interval, in minutes, that NODE statistics are reported back to the Collector. The Node SGP uses the ASAP rate as the default. Here is an example of the SET NODE command: +SET NODE ON, OBJECT $SYSTEM. ASAPNCP, PARAMETERS “RATE 10" 32

PROCESS Entity Features $T § Non. Stop Kernel are supported, OSS processes are not supported. § Performance availability counters. § User defined process object monitoring. § User defined discrete object thresholds support. § Auto-discovery of $M 33

PROCESS Set Command § Set Process ON|OFF Enables/Disables Process availability information. Default ON. § Set Process object $System. Asappro defines the Process program object filename. Default $SYSTEM. ASAPPRO § Set Process Param “Param, Param 1” Process params: RATE defines the interval, in minutes, that PROCESS availability information is reported back to the Collector. The Process SGP uses the ASAP rate as the default. TRACE turns on $RECEIVE trace to the EMS and ASAP log files. Here is an example of the SET PROCESS command: +SET PROCESS ON, OBJECT $SYSTEM. ASAPPRO, PARAMETERS “RATE 10 TRACE" 34

PROCESS Objective Attributes § The following process attributes can have objectives set against using the RANK PROCESS, command. ATTRIBUTE DESCRIPTION Value ERROR Collection error Integer CPU Process primary CPU Integer PRI Primary process priority Integer BCPU Process backup CPU Integer BUSY Process Busy Decimal PSTATE Unalloc, Start, Run, Suspnd, Dbg brk, Dbg trap, Dbg req, Insp Character 8 WSTATE Lsig/Lpipe(status), Pon(cpu pwr), Iopon (I/O pwr), Intr Character 8 MPAGES Memory pages in use Integer MSENT Messages sent per second Integer MRECVD Messages received per second Integer QLEN Receive queue length Integer MQLEN Maximum receive queue length Integer PFAULTS Page faults per second Integer 35

PROCESSBUSY Features $0. . F § All Non. Stop Kernel processes are supported. § Ranks n Busiest Processes. § Performance availability counters. § Supports user defined Busy PCB object monitoring. § Supports user defined discrete object thresholds 36

PROCESSBUSY Attributes ATTRIBUTE DESCRIPTION Value BUSY Average Cpu Busy Integer RCVQ Process receive queue length integrated Integer RCVMSG Messages received per second Integer SNDMSG Messages sent per second Integer PAGES Number of memory manager pages allocated to process Integer LCB Number of LCBs in use by the process Integer 37

PROCESSBUSY Set Command § Processbusy is not an Extended SGP it is part of the CPUSGP ($ZOO 0. . $ZOOF) § To set Processbusy availability information off use the Monitor Processbusy 0. . F, OFF. Default ON § Set Processbusy Param “Param, Param 1” Processbusy params ENTRIES defines the number of busy processes per CPU will be collected/displayed. The range is 1 - 20. default is 3. This attribute is optional. SUBSAMPLES defines the number of subsampling will be taken during a sample interval, specified by SET RATE. The range is 1 - 10. The default is 3. This attribute is optional. Example: SET PROCESSBUSY ENTRIES 5, SUBSAMPLES 3. 38

RDF Features $N § Supported with RDF/IMP(X) V 1. 3 onward § RDF SGP object by default is installed on $SYSTEM. RDF. ASAPRDF § Collects availability information on the RDF monitor, extractors, receivers, updaters and purger. § Supports user defined RDF object monitoring. § Supports user defined discrete object thresholds § SGP autodiscovers RDF environments by finding RDF CONFIG files (code 721) on $SYSTEM 39

RDF Set Command § Set RDF ON|OFF Enables/Disables RDF availability information. Default OFF § Set RDF object $System. Asaprdf defines the RDF program object filename. Default $SYSTEM. ASAPRDF § Set RDF Param “Param, Param 1” RDF params: RATE defines the interval, in minutes, that RDF availability information is reported back to the Collector. The RDF SGP uses the ASAP rate as the default. TRACE turns on $RECEIVE trace to the EMS and ASAP log files. Here is an example of the SET RDF command: +SET RDF ON, OBJECT $SYSTEM. ASAPRDF, PARAMETERS 40 “RATE 10 TRACE"

MONITOR RDF command § The alternative to autodiscovery is to monitor specific RDF environments. MONITOR RDF CHI->NYC (note no backslashes on node names) § Limited validation, errors will be reported by RDF SGP to event log every poll interval 41

RDF Objective Attributes § The following RDF attributes can have objectives set against using the RANK RDF, command. DESCRIPTION ATTRIBUTE Value ERROR Error number indicating status of data Integer RTDSECS Relative time delay in seconds Integer RTDTIME Relative time delay in hh: mm: ss Integer PCPU Primary CPU Integer BCPU Backup CPU Integer PRIORITY Execution priority Integer 42

RDF Command RDF [/out /] [* ] [[. ] * ] [, ] [] [[. ] ] where options is one or more of: CPU Displays RDF domain/metric values in the specified CPU DETAIL Displays RDF Metric values based on FORMAT command settings. SAMPLES Number of samples to display. STATE Displays RDF Metric values and their objective states. TIME Show stats starting at a time other than the current time. VOLUME Displays the associated disk volumes. 43

RDF Troubleshooting § Check RDF SGP is actually running on both the RDF primary and backup nodes § If no stats are being reported, check RDF status with RDFCOM from the RDF primary system using STATUS RDF § If autodiscovery is being used find all the code 721 RDF CONFIG files FILEINFO $SYSTEM. *. CONFIG This will show the environments that should be reporting stats § If using MONITOR RDF for specific RDF environments check what is being monitored with MONITOR RDF, LIST § Manually stopping the $N process will cause it to be restarted and re-autodiscover 44

Spooler Features $O § Spooler autoconfiguration is $SPLS § 4 Spooler sub-domains for each spooler domain. – $SPLSColl, $SPLSDev, $SPLSPrint and $SPLSSuper for the $SPLS spooler § Specific detail information at a lower sub-domain level – $SPLSDEV$LP has specific device info § Spooler monitoring is done at the top domain level – MONITOR SPOOLER $SPLS § Spooler ranking can be done at any level – RANK SPOOLER $SPLSDEV$LP, DEACTIVATE 45

Spooler Features (cont. ) § Information available in 2 modes: aggregation and detail – $SPLSDev is the aggregate for the print devices – $SPLSDev$LP is a specific device available in detail mode § SGP default mode is aggregation – Use SGP startup parameter DETAIL to have SGP work in detail mode 46

SPOOLER Set Command § Set Spooler ON|OFF Enables/Disables Spooler availability information. Default OFF § Set Spooler object $System. Asapspl defines the node program object filename. Default $SYSTEM. ASAPSPL § Set SPL Param “Param, Param 1” SPL params: DETAIL returns individual records for the spooler collector, processes and devices. RATE defines the interval, in minutes, that Spooler availability information is reported back to the Collector. The Spooler SGP uses the ASAP rate as the default. 47

SPOOLER Set Command Continued TRACE turns on $RECEIVE trace to the EMS and ASAP log files. Here is an example of the SET SPOOLER command: +SET SPOOLER ON, OBJECT $SYSTEM. ASAPSPL, PARAMETERS “RATE 10 TRACE" 48

Spooler Attributes State Pair? Applies to Domain Spooler domain name Domain Description All *Status Yes Operational Status All Error Yes Last error number encountered by object All Number of objects comprising the entry All Num. Objs PCPU Yes Primary CPU for the object Coll, Print, Super BCPU Yes Backup CPU for the object Coll, Print, Super Jobs Yes Number of jobs for the object All Batch Yes Number of batch jobs for the object All Open Yes Number of open jobs for the object All Print Yes Number of printing jobs for the object All Hold Yes Number of jobs on hold for the object All Dev. Qs Yes Number of device queues for the object Dev, Print, Super Locs Yes Number of locations for the object Dev, Print, Super Fonts Yes Number of font jobs for the object Dev, Super Full% Yes Percentage full Coll, Super *Status attribute also has State. Is. Op=Yes, you cannot set objectives on it. 49

Spooler Attributes - Detail Description Applies to Domain Prty Priority of the process for the object Coll, Print, Super File/Process Name Associated file or process name All Size of collector units Coll Unit. Alloc Number of collector units currently used Coll Tot. Units Total number of collector units available Coll Flags Configuration flags Dev, Print Retry Number of retries attempted while in error Dev Intvl Interval to wait between retries Dev Maximum number of retries allowed Dev Form. Name Form name associated with print device Dev Colls Total number of collectors in spooler Super Devs Total number of printer devices in spooler Super PProcs Total number of print processes in spooler Super Attributes State Pair? 50

Spooler – Troubleshooting Tips § Autoconfiguration is $SPLS only. § Spooler SGP uses the SPOOLER Procedures Calls SPOOLERSTATUS or SPOOLERSTATUS 2 to get the state and status information § Aggregation vs Detail – Default SGP behavior is aggregation – SPOOLER, DETAIL or SHOW DETAIL INFO can be used to get detail – Use SGP STARTUP PARAM DETAIL to have Spooler SGP collect data in detail mode 51

SYSTEM Entity Features $0. . F § Auto-discovery of all configured cpu’s. § System average of all monitored cpu’s. § Performance availability counters. § Supports user defined System monitoring. § Supports user defined discrete object thresholds SYSTEM Objective Attributes 52

SYSTEM Objective Attributes § The following System attributes can have objectives set against using the RANK SYSTEM, command. ATTR DESCRIPTION Value BUSY Percent CPU busy Integer QUEUE CPU 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 Percent of total physical memory pages locked Integer PGS Percent of total physical memory pages locked Integer PCB Percent usage low pcb’s (pins 0 -254) Integer PCBX Percent usage of high pcb’s pins above 255 Integer TLE Percent usage of time list elements Integer SEGS Percent of maximum virtual memory segments used Integer 53

Tape Features $Q § Tape domains = tape devices – EG. $TAPE 1, $SILO 02 § Autoconfiguration is all tape devices on the node § Information kept about tape domains: – Tape device status information – Tape mount requests § Tape device status information – Information about the current status of the tape device § Tape mount requests information – Information about all the tape mount requests on the node 54

TAPE Set Command § Set Tape ON|OFF Enables/Disables Tape availability information. Default OFF § Set Tape object $System. Asaptap defines the Tape program object filename. Default $SYSTEM. ASAPTAP § Set TAPE Param “Param, Param 1” Tape params: RATE defines the interval, in minutes, that Tape availability information is reported back to the Collector. The Tape SGP uses the ASAP rate as the default. TRACE turns on $RECEIVE trace to the EMS and ASAP log files. Here is an example of the SET TAPE command: +SET TAPE ON, OBJECT $SYSTEM. ASAPTAP, PARAMETERS “RATE 10 TRACE" 55

Tape Attributes (1 of 2) Attributes State Pair? Domain Description Special for Tape, Detail Mount Request Information Tape domain name *Status Yes Device. No Operational status Logical device number PCPU Yes Primary CPU number of tape device BCPU Yes Backup CPU number of tape device Sub. Type Sub type of the tape device ACS Yes if device is an automated cartridge system Checks Indicates which tape checks are enabled Mount. Req Yes Current number of mount requests for device Mount. Time Yes Number of minutes since Mount. Req > 0 Tape. Name Mount Tape Request Number Name of mounted tape on tape device Name of requested tape (if specified) Tape. Status Yes Status of mounted tape on tape device Tape density requested (if specified) Tape. Label Yes Label of mounted tape on tape device Label type requested (if specified) *Status attribute also has State. Is. Op=Yes, you cannot set objectives on it. 56

Tape Attributes (2 or 2) Description Special for Tape, Detail Mount Request Information Label of mounted tape on tape device Label type requested (if specified) Proc. Name of process which has tape device open Proc name requesting tape mount Progname Program filename which has tape device open Prog name requesting tape mount User. ID Userid which is using the tape device Userid requesting tape mount Attributes Tape. Label State Pair? Yes Prot Yes if a write protected tape is requested (if specified) IO Input/Output mode requested (if specified) Action required to statistic mount request *Status attribute also has State. Is. Op=Yes, you cannot set objectives on it. 57

Tape – Troubleshooting tips § TAPE SGP uses SPI interface to talk to MEDIASRV server – MEDIASRV server must at least be D 42 AAT or newer – MEDIASRV is part of the DSM/Tape Catalog Product and must installed properly – MEDIASRV uses the tape server ZSERVER ($ZSVR) SCF; STOP TAPE $*; ALTER $ZZSTO, LABELTAPE ON; START TAPE $* ZSERVER /NAME $ZSVR, NOWAIT, cpu 0, pri 160, term $ymiop. #clci/1 MEDIACOM; ALTER TAPEDRIVE *, NLCHECK OFF 58

TMF Features $R § 4 TMF domains: Auditdump, Audittrail, Tmf, Transactions § Auditdump, Audittrail and Transactions domains are aggregated records, e. g. the Audittrail record represents the Master audit trail and all auxiliary audit trails. § Aggregated records represent only a subset of the subdomain attributes: detailed information about subdomains is available via ‘Show Object Details’ Client popup menu. Use this feature to view the list of pending transactions for example, or the list of audit trails with more attributes § TMF SGP uses SPI calls to TMFSERVE to obtain stats § Auto-discovers all 4 TMF domains 59

TMF Set Command § Set TMF ON|OFF Enables/Disables Tape availability information. Default OFF § Set TMF object $System. Asaptmf defines the TMF program object filename. Default $SYSTEM. ASAPTMF § Set TMF Param “Param, Param 1” Tape params: RATE defines the interval, in minutes, that TMF availability information is reported back to the Collector. The TMF SGP uses the ASAP rate as the default. TRACE turns on $RECEIVE trace to the EMS and ASAP log files. Here is an example of the SET TMF command: +SET TMF ON, OBJECT $SYSTEM. ASAPTAP, PARAMETERS “RATE 10 TRACE" 60

TMF Attributes State Pair? Applies to Domain TMF domain name Domain Description All *Status Yes Operational Status All Error Yes Error number indicating status of data All Master Audit Trail/Auxiliary Auditdump, Audittrail Type Active Yes Audit dump currently dumping? Auditdump Ovflw Yes Overflow space in use? Audittrail Hold Yes Audit stopped, no space in audit trail? Audittrail Used Yes Percentage of audit trail file used Audittrail Tps Yes Transaction rate per second Tmf Begin. Tr Yes Begin transaction status Tmf Catalog Status Tmf Catalog Trans Yes Number of pending transactions Transactions Hung Yes At least one transaction hung? Transactions Duration Yes Elapsed time of a transaction in seconds Transactions *Status attribute also has State. Is. Op=Yes, you cannot set objectives on it. 61

TMF – Troubleshooting tips § TMF SGP uses SPI interface to talk to TMFCOM server – Use those commands in TMFCOM to get the information displayed by the TMF SGP: § status tmf § status transactions § status audittrail § info audittrail § status auditdump 62

ASAP SET Control Command § ASAP control and node configurations settings are performed by using the ASAP SET command. SET APP SET BACKUPCPU | * SET BUFFERED ON | OFF defines whether writes to the data base files are buffered or unbuffered. SET BUFFERED ON helps reduces physical data base I/O for large network configurations. SET BUFFERED OFF assures that physical database I/O occurs in realtime. SET CLEANTIME SET COLLECT SET EDL defines and compiles a file containing ASAP Entity Definition Language (EDL) statements. SET HELPFILE defines the name of the ASAP help file 63

SET Control Command Continued SET ID $ defines the ASAP pid, or ASAP process id name set. Logical Function COLLECT MONITOR (node) SGP (cpu) ASAPXSGP(app) ASAPDSK (dsk) ASAPEXP (exp) ASAPFIL (fil) ASAPNCP (ncp) ASAPPRO (pro) ASAPRDF (rdf) ASAPSPL (spl) ASAPTAP (tap) ASAPTMF (tmf) Process $ pid> pid> pid> S M 0 -F H J K L G T N O Q R Default $Zoo. S $Zoo. M $Zoo 0. . 9 A. . F $Zoo. H $Zoo. J $zoo. K $zoo. L $Zoo. G $zoo. T $zoo. N $zoo. O $zoo. Q 64 $zoo. R

SET Command Continued SET IOCONTROL configures the maximum number of output lines that can be written to the output file for any command before a prompt is issued. SET LOGFILE defines the name of the file used for ASAP command interpreter input/output capture. LOGGING ON/OFF controls access to the file. Default $ASAPVOL. ASAPSUBVOL. LOGFILE SET LOGINTERVAL defines the interval, in minutes that duplicate ASAP error events are suppressed. SET LOGSUPPRESS ON | OFF controls the suppression of duplicate ASAPLOG file error events and EMS tokenized error events. The default is ON. 65

SET Commands Continued SET LOGGING ON | OFF Logging on captures all ASAP CI input/output to be written to the file set by LOGFILE. SET ASAPLOG defines the name of the monitor/collect error disk logfile SET OBJCOLLECT defines the collect program object filename. Default $SYSTEM. ASAPCOL SET OBJMONITOR defines the monitor program object filename. Default $SYSTEM. ASAPMON SET OBJECTIVESAUDIT SET OBJECTIVESDB SET OBJECTIVESEVENT ON | OFF ON | OFF 66

SET Command Continued SET SET SET OBJECTIVESEVENTUP ON | OFF OBJECTIVESEVENTCONSOLEUP ON | OFF OBJECTIVESEVENTSTATE OBJECTIVESEVENTMAX OBJECTIVESRANK STANDARD | PERCENT | HISTORICAL PRIMARY | * PRIORITY SLEEPTIME , SYNCSLOW ON | OFF TERM | OFF defines the Collect or Monitor terminal log-file name to which internal Errors and actions are logged. The default is $0. A disk error log file $SYSTEM. ASAPLOG is always created and maintained. SET TRACE ON | OFF SET INSPECT ON | OFF 67

ASAP CI - Control Example NSK Local Node Workstation ASAP Client ASAP Server Properties Window Graph Window O Browse E Window M Session And Graph Window ASAP Database Real-Time Data Graph Window Management CSG SSG Collect Asap Client See. View Server Command Database Gateway Interface Server App Cpu Disk Expand Process System Report Window – SET DB $DATA. ASAP. DB – SET RETAIN NONE – START COLLECT – – SET START Monitor Chicago Cpu Disk Expand Process Node Monitor Newyork Cpu Disk Expand Process App ASAP Extension Newyork Asap. Xmon App 1 App 2 App 3 DISK ON CHICAGO MONITOR APP ON NEWYORK MONITOR 68

ASAP CI - STATUS Collect § +status collect § CENTDIV Primry Backup Pri Access § § § § Reqs Lmsgs Created Req. Time Srv. Time Et ------ ------- ------- --$ZOOS V 02 1, 122 0, 106 160 255, 255 22581 2 7/10 20 1404: 53 0 $CO. ASAPDB 2. DBSYS Open(0) $CO. ASAPDB 2. DBCPU Open(0) $CO. ASAPDB 2. DBEXP Open(0) $CO. ASAPDB 2. DBPCB Open(0) $CO. ASAPDB 2. DBRDF Open(0) $CO. ASAPDB 2. DBNCP Open(0) $CO. ASAPDB 2. DBAPP Open(0) $CO. ASAPDB 2. DBDSK Open(0) $CO. ASAPDB 2. DBFIL Open(0) $CO. ASAPDB 2. DBSPL Open(0) $CO. ASAPDB 2. DBTAP Open(0) $CO. ASAPDB 2. DBTMF Open(0) $CO. ASAPDB 2. DBPRO Open(0) (rate 1, sleep 0000, clean 0000, retain NONE ) 69

ASAP CI - STATUS Monitor STATUS MONITOR - Displays Status of Monitor and SGP Components. +STATUS MONITOR § § § § CENTDIV Primry Backup Pri Access ------ ------$ZOOM V 02 1, 125 0, 189 160 255, 255 $ZOO 0 V 02 0, 170 160 255, 255 $ZOO 1 V 02 1, 121 160 255, 255 $ZOOG V 02 1, 126 NCP 160 255, 255 $ZOOH V 02 1, 096 APP 160 255, 255 $ZOOJ V 02 1, 165 DSK 160 255, 255 $ZOOK V 02 1, 161 EXP 160 255, 255 $ZOOL V 02 1, 148 FIL 160 255, 255 $ZOOO V 02 1, 099 SPL 160 255, 255 $ZOOQ V 02 1, 132 TAP 160 255, 255 $ZOOR V 02 1, 160 TMF 160 255, 255 $ZOOT V 02 1, 101 PRO 160 255, 255 (collect CENTDIV. $ZOOS, rate 1) Reqs Lmsgs Created Req. Time Srv. Time Et ----- ------- --7604 7 6/16 07 1345: 59 0 15214 1 6/16 07 1345: 59 0 15213 1 6/16 07 1345: 59 0 7601 3 6/16 07 1345: 59 0 6508 957 6/16 07 1345: 59 0 7601 3 6/16 07 1345: 59 0 7741 4 6/16 07 1345: 59 0 7596 7 6/16 07 1345: 59 0 7600 3 6/16 07 1345: 59 0 7597 5 6/16 07 1345: 59 0 7598 5 6/16 07 1345: 59 0 7601 2 6/16 07 1345: 59 0 70

ASAP CI - LOG Command § § § § 01/06/16 01/06/16 01/06/16 01/06/16 0701: 57 0702: 03 0702: 04 0702: 05 0702: 06 0702: 08 0702: 09 0702: 10 0702: 12 0702: 13 0702: 15 0702: 39 0702: 53 3001 1022 1023 1023 1023 1881 1720 ZOOM INFO ZOO 0 INFO ZOO 1 INFO ZOOG INFO ZOOH INFO ZOOJ INFO ZOOK INFO ZOOL INFO ZOOO INFO ZOOQ INFO ZOOR INFO ZOOT INFO ZOOH 0 INFO ZOOH 1 INFO ZOOJ INFO Non. Stop Backup Created. Cpu: MONITOR V 02. 00 (29 JUN 2001) started SGP NCP V 02. 00 (29 JUN 2001) started SGP APP V 02. 00 (29 JUN 2001) started SGP DSK V 02. 00 (29 JUN 2001) started SGP EXP V 02. 00 (29 JUN 2001) started SGP FIL V 02. 00 (29 JUN 2001) started SGP SPL V 02. 00 (29 JUN 2001) started SGP TAP V 02. 00 (29 JUN 2001) started SGP TMF V 02. 00 (29 JUN 2001) started SGP PRO V 02. 00 (29 JUN 2001) started APP V 02. 00 (29 JUN 2001) started ASAPDSK ZASPZOO started. Notes: 1. All ASAP Exceptions are logged in Tandem EMS Event log. 2. Asap Messages can be found in the Asap Messages Manual 71

ASAP CI - Database Maintenance Commands § SET RETAIN – Controls what the ASAP Server does at “Cleantime”. SET RETAIN ALL NONE ROLLOVER § SET CLEANTIME – Controls when the DB Cleanup occurs. SET CLEANTIME 2215 § CLEANUP – Command Manually invokes ASAP Database cleanup. 72 CLEANUP COLLECT

ASAP CI - Time Synchronization Commands PC Host Remote Hosts • SET SYNC , Automatically Causes Monitor node(s) to Sync to Collect node. specifies interval in modulo minutes past midnight. specifies the number of times to do sync. Example: SET SYNC 60, 2 syncs time at 1: 00 and 2: 00 AM. • SYNC Node Command Manually causes Node to Sync to Collect node. to Sync to COLLECT node Time-of-day. § SET SYNCSLOW ON|OFF Defines the clock synchronization algorithm. 73

ASAP CI - Entity Commands • Entity Commands provide reporting of availability. • Used for batch reporting & trouble-shooting of statistic values. APP Reports APPLICATION availability. CPU Reports CPU availability. DISK Reports DISK availability. FILE Reports File availability LH Reports Expand Line Handler availability. NODE Reports Expand end-to-end availability. PROCESS Reports User selected Process availability. PROCESSBUSY Reports Busiest Process. RDF Reports RDF subsystem availability. SPOOLER Reports Spooler subsystem availability. TAPE Reports Tape subsystem availability. TMF Reports TMF subsystem availability. 74

CPU Command CPU [/out /] [* ] [] [[. ] * ] [, ] [[. ] ] where options is one or more of: SAMPLES DETAIL Displays all statistics for the specified CPU or system. Displays high PIN PCB configuration and usage statistics for D-series and above systems. PERCENT Displays the percentage of the total resource values for Memory pages, Control blocks (PCB, PCBX, LCB, and TLE), System, & Map. Pool. USE Displays usage statistics for Memory pages, Control blocks (PCB, PCBX, LCB, and TLE), System, and Map. Pool. CONFIGURED Displays the configured values for Memory pages, Control blocks (PCB, PCBX, LCB, and TLE), System, and Map. Pool. HISTO Displays a histogram of CPU Busy, CPU Queue Length, and Memory Queue length. This is the default for the CPU CMD 75

CPU Command Continued AVG TYPE TIME STATE Displays the statistical averages across all running CPUs for the specified system during each sample period. Displays CPU types. hh[: mm [m/d/y]] Shows all attributes that have an associated state. 76

DISK Command DISK [/out /] [* ] [] [[. ] * ] [, ] [[. ] ] where options is one or more of: AVG Displays the largest statistic valued for the entire device. CPU Lists stats Primaried in the CPU as specified by CPU number. INFO Device information Capacity, MB avail, Address, and state info. PERCENT Statistic percentage for the $vol-p & $vol-m disk drives. QUEUE Queue length for $vol-p & $vol-m. RATE Statistics per second for the $vol-p & $vol-m disk drives. SAMPLES Number of samples to display. STATE Show all attributes that have an associated state. Works with the options, rate, queue, and without any addtional options. TIME Show stats starting at a time other than the current time. 77

FILE Command FILE [/out /] [* ] [[. ] * ] [, ] [] [[. ] domain ] where options is one or more of: COUNT Maximum number of subdomains to display. EXACT Shows statistics for only the specified domain. MINSTATE Displays files in a subvolume, depending on the selected option: – states Shows files with a state greater than or equal to state – AUTO Shows files with a state higher than 2, or else shows all files – AUTOSHORT Shows files with a state higher than 2, or else shows the subvolume record. DETAIL Shows all available statistics attributes, without states. SAMPLES Number of samples to display. STATE Show all attributes that have an associated state. Works with the options, rate, queue, and without any addtional options. TIME Show stats starting at a time other than the current time. 78

LH Command LH [/out /] [* ] [] [[. ] * ] [, ] [[. ] ] where options is one or more of: INFO Device information Transport, LDEV, Next. Sys, and operational state AVG Displays Level 2 information/supervisory (I/S) frames sent and received and I/S frame ratios. HISTO Displays a histogram of the message size distribution. IP Displays the Expand statistics for Expand lines configured using either the IP transport or the ATM transport. LINE Displays only Expand line handlers for subtype 0, 2, 3, 4, and subtype 6. PATH Displays Expand statitistics only for Expand multi line Path process subtype 1. POOL Displays Pool use. RATES Displays counts normalized to number per second. SAMPLES Number of samples to display. 79

LH Command Continued STATE TIME USE Show all attributes that have an associated state. Works with the options, rate, queue. Show stats starting at a time other than the current time. Displays statistics about current pool usage. 80

NODE Command NODE [/out /] [* ] [[. ] * ] [, ] [] [[. ] nodename ] where options is one or more of: NONULLOUT Displays only Nodes with nonzero end-to-end stats SAMPLES Number of samples to display. TIME Show stats starting at a time other than the current time. 81

PROCESS Command PROCESS [/out /] [* [] ] [[. ] * ] [, ] [[. ] <$Process>] where options is one or more of: CPU Returns information only for all processes on the specified CPU. DETAIL Returns more detailed information about the specified monitored processes. SAMPLES Number of samples to display. STATE Show all attributes that have an associated state. TIME Show stats starting at a time other than the current time. 82

PROCESSBUSY / PB Command PROCESSBUSY | PB [/out /] [* ] [[. ] * [] [[. ] ] ] [, ] where options is one or more of: ENTIRIES Displays the number of busy processes to be displayed for each CPU. INFO Displays detailed processbusy availability attributes. STATS Displays detailed processbusy availability attributes SAMPLES Number of samples to display. STATE Show all attributes that have an associated state. TIME Show stats starting at a time other than the current time. 83

RDF Command RDF [/out /] [* ] [[. ] * ] [, ] [] [[. ] ] where options is one or more of: CPU Displays RDF domain/metric values in the specified CPU DETAIL Displays RDF Metric values based on FORMAT command settings. SAMPLES Number of samples to display. STATE Displays RDF Metric values and their objective states. TIME Show stats starting at a time other than the current time. VOLUME Displays the associated disk volumes. 84

Spooler Command SPOOLER [/out /] [* ] [[. ] * ] [, ] [] [[. ] ] where options is one or more of: DETAIL Shows detailed information for the specified spooler domain (supervisor, collector, device, print process). EXACT Returns information about domains which exactly match spoolerspec. MINSTATE Shows detailed information on subdomains with states greater than or equal to what is specified. – states Minimum state to report. – AUTO Shows files with a state minimum or higher than 2. – AUTOSHORT indicates to return aggregate information where state is greater than or equal to 2 SAMPLES Number of samples to display. SHORT When used with DETAIL or MINSTATE, displays information in short form. STATES Displays Spooler Metric values and their objective states. 85

Spooler Command Continued TIME Show stats starting at a time other than the current time. § To get spooler detail information in the ASAP client, use SHOW DETAIL INFORMATION 86

Tape Command TAPE [/out /] [* ] [[. ] * ] [, ] [] [[. ] ] where options is one or more of: DETAIL Display detailed tapemount information for the specified tape domain. SAMPLES Number of records to display. STATES Display states associated with tape attributes. TIME Show stats starting at a time other than the current time. EXACT Retrieve information only which exactly match tapespec. § To get tape mount information in the ASAP client, use SHOW DETAIL INFORMATION 87

TMF Command TMF [/out /] [* ] [[. ] * ] [, ] [] [[. ] ] where options is one or more of: DETAIL Display detailed information for the specified domain, without states. MINSTATE Shows detailed information on subdomains with states greater than or equal to what is specified. – states Minimum state to report. – AUTO indicates to use state 2 as the minimum. – AUTOSHORT indicates to return aggregate information where state is greater than or equal to 2 SAMPLES Number of records to display. STATES Display states associated with TMF attributes. TIME Show stats starting at a time other than the current time. 88

ASAP CI - Basic Commands EXIT Stops the ASAP command interpreter. FC Standard Tandem Fix Command. HELP Displays explanation of specified ASAP command. NEW FEATURES Enter HELP NEW FEATURES for new features NEW USER Enter HELP NEW USER for getting started. OBEY Causes commands in OBEY file to be executed. PAUSE Suspends program until stop/abend/brk msg. SYSTEM Specifies default system name. VOLUME Changes and/or Displays default volume name. ! Exclamation Mark is End-of-line Comment Delimeter. 89

90