CHKASPTHD Check ASP Threshold

CHKASPTHD CHECK ASP THRESHOLD TAAASPA
The Check ASP (Auxiliary Storage Pool) Threshold tool provides an additional method of notifying the system operator when an ASP has reached its threshold of storage used. A message is sent to QSYSOPR (or a named message queue) that describes the current percentage and remaining storage available. In addition, a separate threshold percentage may be named in conjunction with the SHOUT tool. The system sends a message (CPF0907) describing an ASP storage threshold problem, but the first level text does not describe any values for the operator. The second level text must be accessed to determine which ASP and the amount the threshold has been exceeded. CHKASPTHD would send a message such as: ASP 2 exceeds threshold. Used 93%. Remaining ASP stg 2,360 MB. In a situation where it is normal to exceed the threshold, the operator can more easily determine if a real problem exists. *JOBCTL special authority is required to use CHKASPTHD. CHKASPTHD submits a batch job for one or all ASPs. A typical use of CHKASPTHD WOULD BE: CHKASPTHD MSGQ(*SYSOPR) WAKEUP(300) ASP(1) SHOUTPCT(80) USERS(USERA USERB) The submitted batch job would wake up every 5 minutes and check the usage percentage of ASP 1. If the usage percentage went above 80%, the QSYSOPR message queue would be sent a message. This would only cause a 'break' at the workstation if the message queue was set to break mode. If USERA and/or USERB were signed on, a break message would be sent to their workstation. More details ------------ The batch job would wakes up according to the WAKEUP number of seconds and checks the status of the named ASPs. The QYASPOL API is used to access the ASP information. For each ASP that had exceeded its threshold, a message would be sent to QSYSOPR (a different message queue could be specified). The job queue QSYSNOMAX is used for the batch job which causes the job to run in the QSYSWRK subsystem. A different percentage threshold can also be specified on the command to utilize the function to the TAA SHOUT command. For example, if the normal threshold percentage is 90%, you could specify the SHOUT percentage at 95%. If 95% was reached, the list of users named on the USERS parameter would be notified with a break message. This could be helpful if the System Operator is not available or has not noticed the condition. Performance considerations -------------------------- Between WAKEUP intervals, the batch program is in a delayed state for the number of seconds you specified. When the interval ends, the program uses the QYASPOL API to access the ASP information. The API function always accesses the information for every ASP defined to the system. The program determines which ASP to check based on your command specification. Based on this, you should consider the following: ** The WAKEUP interval should not be too short as each wakeup causes overhead. ** Checking all ASPs does not cause significantly more overhead as the API always returns all information. ** You can have multiple batch jobs that are checking one or more ASPs. This would only make sense if you had different message queues to send messages to, or different SHOUTPCT thresholds, or a different list of users to notify using SHOUT. Testing ------- You can test the CHKASPTHD function by determining the current percentage usage for the required ASP with WRKASP. CHKASPTHD will check against the 'usage percentage'. Then use CHKASPTHD to specify a percentage slightly higher than is currently being used. Name yourself in the USERS parameter. Copy some large file to a temporary library. Check WRKASP to see if the percentage used has been reached. If not, keep copying until the percentage is reached. At that point you should receive a message. Delete the temporary library. End the current CHKASPTHD job. You are now ready to implement the CHKASPTHD command as required. CHKASPTHD escape messages you can monitor for --------------------------------------------- None. Escape messages from based on functions will be re-sent. Command parameters *CMD ------------------ MSGQ The qualified name of the message queue to be sent the standard message if the ASP storage threshold is exceeded. The default is *SYSOPR meaning the QSYSOPR message queue in QSYS. A specific message queue may be named. If the library qualifier is blank, *LIBL is assumed. A library name may be entered or the special values *LIBL or *CURLIB. WAKEUP The wakeup interval of the batch job in seconds. The default is 300 seconds (5 minutes). The value entered must be between 5 seconds and 86,400 seconds (24 hours). ASP The list of ASPs to be checked. The default is *ALL. See the previous documentation for the performance considerations. A maximum of 16 ASPs may be entered. JOB The job name for the submitted batch job. The default is CHKASPTHD. SHOUTPCT A percentage may be entered to allow the CHKASPTHD function to shout at the list of users specified in the USERS parameter. The default is *NONE, meaning only the standard message will be sent to the message queue described by the MSGQ parameter. The intent of allowing another threshold percentage is to provide the function of the TAA SHOUT tool to cause break messages to be sent to specified users. *SAME may be specified to cause the same ASP threshold percentage as defined to the system to be used. A different percentage may be entered such as a value higher than the value defined to the system to allow for a more serious notification. For example, if the threshold defined to the system is 90%, the SHOUTPCT could be set at 95%. This will allow more users to be made aware of an increasing critical condition. There is no check made relative to the current ASP storage threshold set thru DST/SST or the TAA CHGASPA2 command. The SHOUTPCT value can be less than, equal or greater than the ASP storage threshold. If a value is entered, it must be between 01-99. The SHOUTPCT value applied to all ASPs named in the ASP parameter. USERS A list of up to 10 users for the SHOUT tool to send a message to if the SHOUTPCT ASP threshold storage value is reached. The default is *FIRSTUSER. This allows for the active user with the highest user class to be notified. For full details, see the USERS parameter on the SHOUT command. Restrictions ------------ *JOBCTL special authority is required to use CHKASPTHD. Prerequisites ------------- The following TAA Tools must be on your system: CHKDUPLST Check duplicate list CHKJOBCTL Check job control CHKOBJ3 Check object 3 EDTVAR Edit variable EXTLST Extract list EXTLST2 Extract list 2 MOVCHRDEC Move character to decimal RSNLSTMSG Resend last message SHOUT Shout message SNDESCMSG Send escape message Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- CHKASPTHD *CMD TAAASPA QATTCMD TAAASPAC *PGM CLP TAAASPAC QATTCL TAAASPAC2 *PGM CLP TAAASPAC2 QATTCL The TAAASPAC2 program is submitted to batch by TAAASPAC.


CHKASPTHD CHECK ASP THRESHOLD TAAASPA
The Check ASP (Auxiliary Storage Pool) Threshold tool provides an additional method of notifying the system operator when an ASP has reached its threshold of storage used. A message is sent to QSYSOPR (or a named message queue) that describes the current percentage and remaining storage available. In addition, a separate threshold percentage may be named in conjunction with the SHOUT tool. The system sends a message (CPF0907) describing an ASP storage threshold problem, but the first level text does not describe any values for the operator. The second level text must be accessed to determine which ASP and the amount the threshold has been exceeded. CHKASPTHD would send a message such as: ASP 2 exceeds threshold. Used 93%. Remaining ASP stg 2,360 MB. In a situation where it is normal to exceed the threshold, the operator can more easily determine if a real problem exists. JOBCTL special authority is required to use CHKASPTHD. CHKASPTHD submits a batch job for one or all ASPs. A typical use of CHKASPTHD WOULD BE: CHKASPTHD MSGQ(SYSOPR) WAKEUP(300) ASP(1) SHOUTPCT(80) USERS(USERA USERB) The submitted batch job would wake up every 5 minutes and check the usage percentage of ASP 1. If the usage percentage went above 80%, the QSYSOPR message queue would be sent a message. This would only cause a 'break' at the workstation if the message queue was set to break mode. If USERA and/or USERB were signed on, a break message would be sent to their workstation. More details ------------ The batch job would wakes up according to the WAKEUP number of seconds and checks the status of the named ASPs. The QYASPOL API is used to access the ASP information. For each ASP that had exceeded its threshold, a message would be sent to QSYSOPR (a different message queue could be specified). The job queue QSYSNOMAX is used for the batch job which causes the job to run in the QSYSWRK subsystem. A different percentage threshold can also be specified on the command to utilize the function to the TAA SHOUT command. For example, if the normal threshold percentage is 90%, you could specify the SHOUT percentage at 95%. If 95% was reached, the list of users named on the USERS parameter would be notified with a break message. This could be helpful if the System Operator is not available or has not noticed the condition. Performance considerations -------------------------- Between WAKEUP intervals, the batch program is in a delayed state for the number of seconds you specified. When the interval ends, the program uses the QYASPOL API to access the ASP information. The API function always accesses the information for every ASP defined to the system. The program determines which ASP to check based on your command specification. Based on this, you should consider the following: The WAKEUP interval should not be too short as each wakeup causes overhead. Checking all ASPs does not cause significantly more overhead as the API always returns all information. ** You can have multiple batch jobs that are checking one or more ASPs. This would only make sense if you had different message queues to send messages to, or different SHOUTPCT thresholds, or a different list of users to notify using SHOUT. Testing ------- You can test the CHKASPTHD function by determining the current percentage usage for the required ASP with WRKASP. CHKASPTHD will check against the 'usage percentage'. Then use CHKASPTHD to specify a percentage slightly higher than is currently being used. Name yourself in the USERS parameter. Copy some large file to a temporary library. Check WRKASP to see if the percentage used has been reached. If not, keep copying until the percentage is reached. At that point you should receive a message. Delete the temporary library. End the current CHKASPTHD job. You are now ready to implement the CHKASPTHD command as required. CHKASPTHD escape messages you can monitor for --------------------------------------------- None. Escape messages from based on functions will be re-sent. Command parameters CMD ------------------ MSGQ The qualified name of the message queue to be sent the standard message if the ASP storage threshold is exceeded. The default is SYSOPR meaning the QSYSOPR message queue in QSYS. A specific message queue may be named. If the library qualifier is blank, LIBL is assumed. A library name may be entered or the special values LIBL or CURLIB. WAKEUP The wakeup interval of the batch job in seconds. The default is 300 seconds (5 minutes). The value entered must be between 5 seconds and 86,400 seconds (24 hours). ASP The list of ASPs to be checked. The default is ALL. See the previous documentation for the performance considerations. A maximum of 16 ASPs may be entered. JOB The job name for the submitted batch job. The default is CHKASPTHD. SHOUTPCT A percentage may be entered to allow the CHKASPTHD function to shout at the list of users specified in the USERS parameter. The default is NONE, meaning only the standard message will be sent to the message queue described by the MSGQ parameter. The intent of allowing another threshold percentage is to provide the function of the TAA SHOUT tool to cause break messages to be sent to specified users. SAME may be specified to cause the same ASP threshold percentage as defined to the system to be used. A different percentage may be entered such as a value higher than the value defined to the system to allow for a more serious notification. For example, if the threshold defined to the system is 90%, the SHOUTPCT could be set at 95%. This will allow more users to be made aware of an increasing critical condition. There is no check made relative to the current ASP storage threshold set thru DST/SST or the TAA CHGASPA2 command. The SHOUTPCT value can be less than, equal or greater than the ASP storage threshold. If a value is entered, it must be between 01-99. The SHOUTPCT value applied to all ASPs named in the ASP parameter. USERS A list of up to 10 users for the SHOUT tool to send a message to if the SHOUTPCT ASP threshold storage value is reached. The default is FIRSTUSER. This allows for the active user with the highest user class to be notified. For full details, see the USERS parameter on the SHOUT command. Restrictions ------------ JOBCTL special authority is required to use CHKASPTHD. Prerequisites ------------- The following TAA Tools must be on your system: CHKDUPLST Check duplicate list CHKJOBCTL Check job control CHKOBJ3 Check object 3 EDTVAR Edit variable EXTLST Extract list EXTLST2 Extract list 2 MOVCHRDEC Move character to decimal RSNLSTMSG Resend last message SHOUT Shout message SNDESCMSG Send escape message Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- CHKASPTHD CMD TAAASPA QATTCMD TAAASPAC PGM CLP TAAASPAC QATTCL TAAASPAC2 *PGM CLP TAAASPAC2 QATTCL The TAAASPAC2 program is submitted to batch by TAAASPAC.

Added to TAA Productivity Tools December 15, 2000

Home Page

Last modified on July 15, 2010