Use the AUTOSTAT function when you want to create a Snapshot of selected MUFs with their active task information so that you can process the information and analyze the results. The data is saved in the AutoStatus database.
Command
Specifies to create a Snapshot of the specified MUFs with their active tasks.
Selection Parameters
Identifies the MUF from which the task data is retrieved. You can repeat this parameter to include more than one MUF. Alternately, you can use a wildcard character (*) to specify to select all MUFs whose names begin with the characters you specify.
Repeat/Frequency parameters
Specifies whether the AutoStatus function should remain active and perform periodic Snapshots (until stopped by the user). A value of zero indicates that the function should run only once and then end. A numeric value between 3 and 64800 indicates that the function should remain active and the interval between the Snapshots is set equal to the selected value in seconds. The interval is measured as the time from the end of one Snapshot and the beginning of the next Snapshot. You may want to set the parameter to a sufficient value, such as 600 (10 minutes), to keep the function from generating large numbers of rows in the AutoStatus database. If you are setting a repeats value, set-up the appropriate job parameters to keep the system from canceling the job due to long execution times.
Output parameters
Specifies a 1- to 16-character string that is used to fill in the USERTAG column on each row in the Snapshot table. You can use OUTTAG in various ways. For example, if you are collecting status information from multiple LPARs, you can indicate the LPAR where a given status was collected. In another case, you can process the status rows with your own program and, once a row has been read, you could place a value in the USERTAG column to indicate it has been processed.
Exclusion/Output reduction parameters
Specifies the items to exclude.
Suppresses the creation of any detail task rows that have a DURATION of blanks. During the task inquiry, any task that has not had its current command in process for at least one second has a duration of blanks. This parameter is used to reduce the amount of detail task rows that are written to the AUTOSTAT database. With this option in place, only tasks with a command in process for a duration of one second (:01) or greater are written to the SNAPSHOT database.
Suppresses the writing of a new page header as each SYSPRINT page fills. When you want to keep the SYSPRINT to a minimum, you can use this option.
Suppresses the creation of any detail task rows that have a CURRENT_STATUS of NOTACTIVE. This parameter is used to reduce the amount of detail task rows that are written to the AUTOSTAT database.
Suppresses the open and close of the AUTOSTAT database URT for each Snapshot (see REPEATS). Specifying SNAPEXCL=REPCONNECT tells the utility to open the URT at the beginning of the AUTOSTAT function and to leave it open until the function is ended. In this mode, the AUTOSTAT function issues a COMMIT at the end of each Snapshot process, but not close the URT.
Without the SNAPEXCL=REPCONNECT, the AUTOSTAT function disconnects from the repository MUF after each status Snapshot. Then, just prior to the next Snapshot, the function reopens the URT and reestablishes communication to the repository MUF. This helps ensure that the URT does not remain open for long periods of time while the function is in a "wait" between Snapshots. When you want to limit the amount of opens and closes, and the associated messages in the repository MUF region, specify the SNAPEXCL=REPCONNECT option.
Note: With the SNAPEXCL=REPCONNECT option specified, the user must terminate AUTOSTAT before issuing the EOJ to the repository MUF.
Suppresses the creation of warning messages when specified MUFs are not found (not active) when the status Snapshot is executed.
The expected return code is 0 when executing the AUTOSTAT command. For details on the AUTOSTAT syntax, parameters, JCL and sample output report see the CA Datacom/DB DBUTLTY Reference Guide.
|
Copyright © 2014 CA.
All rights reserved.
|
|