1. © 2004 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice ASAP 2.5 TOI Part 1 Goal, Action, File and Process Monitoring Oct. 15, 2004 joe.davis@hp.com

2. 2 Introduction Welcome to the ASAP 2.5 TOI ASAP 2.5 TOI Part 1 – ASAP Server Goal, Action, File and Process ASAP 2.5 TOI Part 2 – ASAP Server Enhancements and Comm SGP ASAP 2.5 TOI Part 3 – ASAP Client ASAP 2.5 TOI Part 4 – ASAP OVO SPI Audience GCSC NonStop Analysts Other Interested HP Employees Other Places to Go for Information NonStopASAP.com ASAP 2.4 TOI TUT CD #42 TUT CD #30

3. 3 Contents What’s This About Introduction Introduction topics, audience, other references GOAL Command GOAL Command a synonym for RANK ACTION Option ACTION Option specifying recovery actions ACTION Command ACTION Command define rules, view actions FILE Monitoring FILE Monitoring grouping, aggregation, wildcards, OSS PROCESS Monitoring PROCESS Monitoring object filenames, wildcards, OSS SET FILE SET FILE global aggregates, memory sizing SET PROCESS SET PROCESS memory sizing Large ASAP Environments Large ASAP Environments thoughts on using ASAP efficiently AGGREGATE Option AGGREGATE Option new default behavior New Event Tokens New Event Tokens new tokens in ASAP DOTs events

4. 4 GOAL Command A synonym for RANK Can now use GOAL or RANK to set objectives GOAL CPU 0, QUEUE < 2 RANK CPU 0, QUEUE < 2 GOAL and RANK are Synonyms They are Identical ! Back to Contents

5. 5 GOAL Command Specifying Recovery Actions ACTION “ ” | [WAIT ] [NOREPEAT] Defines a repeating recovery action is the action is a stored action string, more on rules later WAIT defines intervals to wait before retry NOREPEAT turns off retry Tokens can be used to substitute for actual values Back to Contents GOAL CPU 3, BUSY < 80 ACTION “TACL STOP $ABC” RANK CPU, STATUS ACTION “TACL RELOAD, PRIME” GOAL is a synonym for RANK

6. 6 GOAL Command Specifying Action Strings “ ” First word of string is CI or program to receive action –ACTION “FUP SECURE, ‘ ’” –ACTION “TACL ACTIVATE ” –ACTION “MYPROG RESTART ” CI command follows Singles quotes are substituted with double quotes Tokens are substituted with actual values at runtime –GOAL FILE $A.B.C, RWEP = “OOOO” ACTION “FUP SECURE, ‘ ’” –FUP SECURE $A.B.C, “OOOO” Back to Contents

7. 7 GOAL Command Action String Tokens the entity name, e.g. CPU, DISK, etc. the physical object name or domain name the ASAP domain name the objective value defined by GOAL or RANK the current state of the object the previous state of the object the name of the attribute, e.g. BUSY, FULL, etc. the operator, GT, LT, EQ, NE, GE, LE the first (leftmost) level of the ASAP domain name - the 2 nd, 3 rd, 4 th and 5 th levels of the ASAP domain name (if any) Back to Contents

8. 8 GOAL Command Specifying Action Strings ACTION is a stored action string Defined using the ACTION RULE command RANK FILE $A.B.C, RWEP=OOOO ACTION SECURE WAIT Number of intervals to wait before retrying action Otherwise actions repeat each interval that condition persists NOREPEAT Don’t repeat the action at each interval Attempted once regardless of outcome Back to Contents

9. 9 GOAL Command Specifying Recovery Actions To make sure USERID is always secured correctly… MONITOR FILE $SYSTEM.SYSTEM.USERID GOAL FILE $SYSTEM.SYSTEM.USERID, RWEP = OOOO ACTION “FUP SECURE, ‘ ’” To make sure C compiles run at a low priority… MONITOR PROCESS $SYSTEM.SYSTEM.C RANK PROCESS $SYSTEM.SYSTEM.C, PRI < 120 ACTION “TACL ALTPRI, ” To make sure no process steals a processor… MONITOR PROCESS $* GOAL PROCESS $*, BUSY < 50 CRITICAL 6000 ACTION “TACL ALTPRI, 10”

10. 10 GOAL Command Specifying Recovery Actions To make sure process $ABC doesn’t loop… MONITOR PROCESS $ABC GOAL PROCESS $ABC, BUSY < 80 ACTION “TACL SUSPEND ” To make sure there is enough space on a volume… RANK DISK $DATA, FRAGMENT > 100 ACTION DCOM To send ASAP alert information to your own TACL macro… MONITOR SPOOLER $SPL43 GOAL SPOOLER $SPL43, NUMJOBS < 500 INFO ACTION “TACL FIXSPOOL ”

11. 11 GOAL Command Defining Custom Event Numbers INFO|CRITICAL [REPEAT] [NODISPLAY] [ ] [- ] is used when the objective fails is used when the object returns to normal Range 6000-9999 No EMS template associated with custom event However EMS text token is present for display Back to Contents GOAL CPU, BUSY < 80 CRITICAL 6001-6002 RANK CPU, BUSY < 80 CRITICAL REPEAT 6001 GOAL CPU 3, BUSY < 91 CRITICAL -6002

12. 12 ACTION Command A New Dual Purpose Command Used to list actions Actions are added using the RANK command Actions are displayed using the RANK command ACTION displays only actions ACTION is used by the ASAP Action Server Used to define, list and delete ACTION RULES Stored action strings Used in the RANK command Useful for repeating action strings Back to Contents

13. 13 ACTION Command Listing Actions Listing Actions ACTION ACTION \REMOTE ACTION CPU ACTION CPU 0 ACTION CPU 0 BUSY ACTION CPU 0 BUSY LT –Fully qualified selector returns tokenized output –Determines the action that will be applied to specific entity- domain Back to Contents +ACTION CPU STATUS tacl reload,prime (WAIT = 1) CPU 00 PCB LT tacl run $system.asapx3.testmac FILE $ASAP.JOE.ZZZ RWEP EQ RESECURE FILE $ASAP.MM.NOTTHERE STATUS fup create (WAIT = 3) FILE $ASAP.MM.ZZZ OWNER EQ fup give, FILE $ASAP.MM.ZZZ RWEP EQ RESECURE (WAIT = 3) FILE $ASAP.MM.ZZZ STATUS fup create FILE $ASAP.XX.NOTTHERE STATUS fup create PROCESS $MARK STATUS tacl run $data.obj.markl/name $mark,nowait/ PROCESS $STEP BUSY GT ACTIVATE (WAIT = 1) PROCESS $STEP BUSY LT SUSPEND TMF BEGINTR EQ tmfcom; enable begintrans; exit

14. 14 ACTION Command Defining Rules ACTION RULE = Rules are reusable ACTION strings –ACTION RULE SUSPEND=TACL SUSPEND No quotes around string, no single quote substitution These rules are pre-defined ACTION RULE ACTIVATE = TACL ACTIVATE ACTION RULE ALTPRI = TACL ALTPRI, ACTION RULE DEFRAG = DCOM ACTION RULE GIVE = FUP GIVE, ACTION RULE PRIMARY = SCF PRIMARY, ACTION RULE RELOAD = TACL RELOAD, PRIME ACTION RULE SECURE = FUP SECURE, ACTION RULE SUSPEND = TACL SUSPEND Back to Contents

15. 15 ACTION Command Listing and Deleting Rules Listing RULES ACTION RULE ACTION RULE \REMOTE ACTION RULE Deleting RULES ACTION RULE, DELETE Complete Syntax ACTION[/OUT /] [LIST] [\ ] [ ] [ ] [ [ ]] RULE [\ ] [ ] [= ] | [,DELETE] Back to Contents

16. 16 FILE Monitoring Specifying Files and Subvolumes MONITOR FILE $VOL.SUBVOL.FILE $VOL\SUBVOL\FILE MONITOR FILE $VOL.SUBVOL $VOL\SUBVOL\## MONITOR FILE $ASAP.JOE.NOTTHERE MONITOR FILE $DATA2.DATABASE Back to Contents ASAP domain name

17. 17 FILE Monitoring Specifying Logical Prefixes M FILE MYFILES\$VOL.SUBVOL.FILE MYFILES\$VOL\SUBVOL\FILE M FILE MYFILES\WORK\$VOL.SUBV.FILE MYFILES\WORK\$VOL\SUBV\FILE M FILE MYFILES\$VOL.SUBVOL MYFILES\$VOL\SUBVOL\## MONITOR FILE MYFILES\$DATA2.JOE.TEST MONITOR FILE MYFILES\$DATA3.JOE MONITOR FILE MYFILES\$DATA4.JOE.TEST Back to Contents

18. 18 FILE Monitoring Specifying Wildcard Templates MONITOR FILE $VOL.SUB*.FILE* $VOL.SUB*.FILE*\## $VOL.SUB*.FILE*\$VOL\SUB\FILE (If aggregate-only removed) M FILE MYFILES\$VOL.S*.F* MYFILES\$VOL.S*.F*\## MYFILES\$VOL.S*.F*\$VOL\SUB\FILE (If aggregate-only removed) MONITOR FILE $DATA4.JOE*.* MONITOR FILE $DATA4.JOE*.*\##, DELETE MONITOR FILE $DATA3.JOE*.* MONITOR FILE $M02.*.* Back to Contents

19. 19 FILE Monitoring Specifying OSS Filenames M FILE /home/data/filename HOME\DATA\FILENAME M FILE MYFILES/home/data/filename MYFILES\HOME\DATA\FILENAME M FILE ANYNAME\YOU\WANT PATH / ANYNAME\YOU\WANT Rules Name cannot exceed 64 bytes Name cannot exceed 5 levels of hierarchy Back to Contents

20. 20 FILE Monitoring Specifying Aggregate Domains MONITOR FILE $VOL.SUBVOL Creates an automatic aggregate-only domain MONITOR FILE $VOL.SUB*.* Creates an automatic aggregate-only domain MONITOR FILE $VOL\# Creates an aggregate domain for all files being monitored on $VOL MONITOR FILE MYFILES\# Creates an aggregate for all of MYFILES Back to Contents

21. 21 FILE Monitoring More Aggregate Examples MONITOR FILE $VOL.SUB*.*\$VOL\SUB1\# Creates an aggregate domain for all files in $VOL.SUB1 where the file is selected by a wildcard specifier The automatic aggregate-only domain, $VOL.SUB*.*\##, would have to be deleted before this domain would be output Back to Contents

22. 22 FILE Monitoring Wildcard Domain Names A wildcard template entered in a MONITOR command is used to select objects and to create a domain name level A wildcard template entered to a RANK command does not select objects, it only refers to the ASAP domain name level Meaning if you do this: MONITOR FILE $VOL.SUBV.FILE RANK FILE $VOL.SUB*.*, FULL < 80 The RANK command will not apply to that file because ASAP does not treat “$VOL.SUB*.*” as a wildcard specifier in any command except the MONITOR command This is true for FILE and PROCESS Back to Contents

23. 23 FILE Monitoring Wildcard Domain Names You can do this: M FILE $VOL.SUBV.FILE RA FILE $VOL, FULL < 80 RA FILE $VOL.SUBV, FULL < 85 RA FILE $VOL\SUBV, FULL < 85 RA FILE $VOL.SUBV.FILE, FULL < 90 RA FILE $VOL\SUBV\FILE, FULL < 90 Note the “.” and “\” are interchangeable in this form of the RANK command Back to Contents

24. 24 FILE Monitoring Wildcard Domain Names Or you can do this: M FILE $VOL.SUB*.* RA FILE $VOL.SUB*.*, FULL < 80 RA FILE $VOL.SUB*.*\$VOL, FULL < 80 RA FILE $VOL.SUB*.*\$VOL.SUBV, FULL < 85 RA FILE $VOL.SUB*.*\$VOL\SUBV, FULL < 85 RA FILE $VOL.SUB*.*\$VOL.SUBV.FILE, FULL < 90 RA FILE $VOL.SUB*.*\$VOL\SUBV\FILE, FULL < 90 Because ASAP treats “$VOL.SUB*.*” as a domain name level in all commands except MONITOR Back to Contents

25. 25 PROCESS Monitoring Specifying Process Names MONITOR PROCESS $NAME $NAME MONITOR PROCESS $NAME* $NAME*\## $NAME*\$NAME (If aggregate-only removed) Back to Contents MONITOR PROCESS $STEP MONITOR PROCESS $ZOO* ASAP domain name ASAP domain names

26. 26 PROCESS Monitoring Specifying Logical Prefixes M PROCESS MYPROCESSES\MYTESTS\$NAME MYPROCESSES\MYTESTS\$NAME M PROCESS SALES\ORDERS\$NAME* SALES\ORDERS\$NAME*\## SALES\ORDERS\$NAME*\$NAME (If aggregate-only removed) Back to Contents MONITOR PROCESS A\$ZOO*

27. 27 PROCESS Monitoring Specifying Object Filenames M PROCESS $VOL.SUBVOL.OBJECT $VOL.SUBVOL.OBJECT\## $VOL.SUBVOL.OBJECT\$NAME (If aggregate-only removed) M PROCESS TEST\$VOL.SUBVOL.OBJECT TEST\$VOL.SUBVOL.OBJECT\## TEST\$VOL.SUBVOL.OBJECT\$NAME (If aggregate-only removed) Back to Contents MONITOR PROCESS $SYSTEM.SYS00.TACL

28. 28 PROCESS Monitoring Specifying OSS Object Filenames M PROCESS /home/directory/objectfilename HOME\DIRECTORY\OBJECTFILENAME\## HOME\DIRECTORY\OBJECTFILENAME\$NAME (If aggregate-only removed) M PROCESS ANYNAME\YOU\WANT PATH / ANYNAME\YOU\WANT\## ANYNAME\YOU\WANT\$NAME (If aggregate-only removed) Rules Name cannot exceed 64 bytes Name cannot exceed 5 levels of hierarchy Back to Contents

29. 29 PROCESS Monitoring Specifying Aggregate Domains MONITOR PROCESS $A* Creates an automatic aggregate-only domain MONITOR PROCESS $VOL.SUBVOL.OBJECT Creates an automatic aggregate-only domain MONITOR PROCESS MYPROCESSES\# Creates an aggregate for all of MYPROCESSES Back to Contents

30. 30 SET FILE New File SGP Parameters AGG Turn on aggregation at all levels for all domains AGGONLY Turn on aggregate-only at all levels for all domains MAXAGGS The max number of aggregate domains, default 9,999, max 32,766 MAXDOMAINS The max number of aggregate domains, default 9,999, max 32,766 MBYTES The size in megabytes of the dynamic domain pool, default 128, max 512 MINONLY Only write domains with state >= where = 3-8 MINSTATE Defines the state,, where a domain is considered to be alerting NORECS Suppress all historical data and data for ASAP Client Back to Contents

31. 31 SET PROCESS New Process SGP Parameters MAXAGGS The max number of aggregate domains, default 9,999, max 32,766 Always get one less than you ask for MAXDOMAINS The max number of aggregate domains, default 9,999, max 32,766 Always get one less than you ask for MBYTES The size in megabytes of the dynamic domain pool, default 128, max 512 Back to Contents

32. 32 Large ASAP Environments Things to Consider Careful use of wildcard names without aggregate-only Use aggregate-only domains Make sure KMSF has enough swap space Use MAXAGGS and MAXDOMAINS for FILE and PROCESS to increase default limits SET FILE PARAM “MAXDOMAINS 20000” Use MBYTES parameter to increase pool space for dynamically resolved domains SET PROCESS PARAM “MBYTES 256” Partition ASAP database files DBFIL DBPRO Back to Contents

33. 33 AGGREGATE Option Changing Default Behavior Prior to ASAP 2.5 you must include the AGGREGATE option to display aggregate domains when using the APP or PROCESS commands Starting with ASAP 2.5, AGGREGATE is the default option for the APP, FILE and PROCESS commands. A new parameter, NOAGG, is added to turn off display of aggregate domains if so desired Back to Contents

34. 34 New EMS Event Tokens More Clarity ZASP-TKN-ASAP-OBJECTNAME The name of the physical object (if any) ZASP-TKN-ASAP-STATE The current state of the attribute ZASP-TKN-ASAP-LASTSTATE The previous state of the attribute Back to Contents

35. 35 In Summary Final Thoughts GOAL/RANK support ACTION and custom event numbers New ways to monitor Files New ways to monitor Processes New ways to control resources More clarity in ASAP EMS events Thanks for attending this section of the ASAP 2.5 Transfer of Information !