Using SOS/3000 in a Batch Job

Another useful feature of SOS/3000 is its batch job capability. There are three standard batch jobs included in the PUB.LPS group/account named SOSMONJ, SOSJOB, and SOSFULL. In each of these jobstreams you will see a lengthy set of control record lines immediately following the ":run SOS.PUB.LPS" line. These options are described in "SOS Main Option Menu". To change any of the options, modify the characters in the left hand column.

The following is

:job sosmonj,mgr.lps,logfiles

:comment ********************************************************

:comment *** This job will provide continuous SOS monitoring

:comment *** by streaming itself and logging off every night at

:comment *** midnight.

:comment ********************************************************

:comment This job is intended for use with SOS version F.04a or later.

:comment Versions of this job that were supplied with earlier versions

:comment of SOS may no longer work and should not be used.

:comment

:comment Similarly, this job may be invalidated by future SOS releases.

:comment

:comment Please refer to the release notes of each version for further

:comment information.

:tellop *** SOS/3000 Batch Job Collection is Starting! ***

:comment Refer to the comments in the soslogxj job for information about

:comment providing input to sos.

:setdump

:run sos.pub

Y : Should batch output be suppressed

300 : SOS sample interval

Y : Display Key Indicators of Performance

Y : Display advice

Y : Display informational advice messages

2 : Global display option

Y : Display global memory statistics

Y : Display global disc statistics

Y : Collect process/workload Information

Y : Display process information

Y : Display workload information

Y : Display only active workloads

0.0 : CPU percentage required for display

Your Company Name

N : Display extended process line

N : Display 132 column process line

N : Show Wait State on first process line

N : Display first instead of full response time

Y : Display page fault rate instead of IO/Transaction

N : Display total I/O percent instead of R/W counts

Y : Display only active processes

0.0 : CPU percentage required for display

Y : Display session processes

Y : Display job processes

Y : Display system processes

Y : Display command interpreter processes

Y : Display dead processes which have died

@.@ : Process logon filter

4 : Process sort option

N : Sort processes in ascending order

0 : Process display limit

Y : Display CPU pulse points

N : Display Memory pulse points

N : Display Disc I/O pulse points

N : Display misc pulse points

Y : Should logging be enabled?

Y : Should disc space utilization info be logged

10 : Process log limit

Y : Should process tracking be enabled

N : Should Memory detail information be displayed

N : Should Global Stop information be displayed

N : Should Disc I/O summary information be displayed

N : Should Tape drive I/O detail information be displayed

N : Should system printer I/O detail information be displayed

N : Should serial printer I/O detail information be displayed

Y : Should device detail info be limited to active devices

N : Should terminal response detail information be displayed

N : Should system transaction manager detail information be displayed

N : Should user transaction manager detail information be displayed

0 : Enter duration of job in minutes

:eod

:stream sosmonj.pub

:tellop *** SOS/3000 Batch Job Collection is Finished! ***

:eoj

a sample of SOSMONJ.

The following is

:job sosjob,mgr.lps,logfiles

:comment ********************************************************

:comment *** This job will run for 8 hours at a 5-minute interval

:comment *** between reports and will display:

:comment *** processes which have used some CPU

:comment *** global, disc, and performance advice

:comment *** You may change the run and interval time (see below)

:comment ********************************************************

:comment This job is intended for use with SOS version F.04a or later.

:comment Versions of this job that were supplied with earlier versions

:comment of SOS may no longer work and should not be used.

:comment

:comment Similarly, this job may be invalidated by future SOS releases.

:comment

:comment Please refer to the release notes of each version for further

:comment information.

:tellop *** SOS/3000 Batch Job Collection is Starting! ***

:comment Refer to the comments in the soslogxj job for information about

:comment providing input to sos.

:setdump

:run sos.pub

Y : Should batch output be suppressed

300 : SOS sample interval

Y : Display Key Indicators of Performance

Y : Display advice

Y : Display informational advice messages

2 : Global display option

Y : Display global memory statistics

Y : Display global disc statistics

Y : Collect process/workload Information

Y : Display process information

Y : Display workload information

Y : Display only active workloads

0.0 : CPU percentage required for display

Your Company Name

N : Display extended process line

N : Display 132 column process line

N : Show Wait State on first process line

N : Display first instead of full response time

Y : Display page fault rate instead of IO/Transaction

N : Display total I/O percent instead of R/W counts

Y : Display only active processes

0.0 : CPU percentage required for display

Y : Display session processes

Y : Display job processes

Y : Display system processes

Y : Display command interpreter processes

Y : Display dead processes which have died

@.@ : Process logon filter

4 : Process sort option

N : Sort processes in ascending order

0 : Process display limit

Y : Display CPU pulse points

N : Display Memory pulse points

N : Display Disc I/O pulse points

N : Display misc pulse points

Y : Should logging be enabled?

Y : Should disc space utilization info be logged

10 : Process log limit

Y : Should process tracking be enabled

N : Should Memory detail information be displayed

N : Should Global Stop information be displayed

N : Should Disc I/O summary information be displayed

N : Should Tape drive I/O detail information be displayed

N : Should system printer I/O detail information be displayed

N : Should serial printer I/O detail information be displayed

Y : Should device detail info be limited to active devices

N : Should terminal response detail information be displayed

N : Should system transaction manager detail information be displayed

N : Should user transaction manager detail information be displayed

480 : Enter duration of job in minutes

:eod

:tellop *** SOS/3000 Batch Job Collection is Finished! ***

:eoj

a sample of Batch Job.

With few exceptions, the batch output is virtually identical to that of the interactive screen. The job duration states how long the collection will take place before the job ends peacefully. If you specify a “0” (zero) at the “Enter duration of job in minutes” question, the job will run until 12:00 midnight. At this time it will send the output report, $STDLIST, to the spooler. For your convenience, we have supplied a job called SOSMONJ. This job already has the re-stream command in it and will automatically stream SOSMONJ.PUB.LPS. This ensures a perpetual run of the program especially if you have logging enabled. We highly recommend this so you will have a log file for each day. You may also include a STREAM of SOSJOB in your SYSSTART file.

At any time an SOS/3000 job may be prematurely aborted and you will still receive reports to that point. We suggest that you have different jobs that provide the types of options you want enabled. For example, you might have one job (SOSJADV) for an advice-only collection and another for only processes that use more than 5% of the CPU, etc.

If you want detailed disc I/O data to be displayed, enter a Y (Yes) after the question “Should disc I/O detail information be displayed?” This will cause a page of disc I/O data to be generated after each standard SOS/3000 logfiles. Refer to the "Disc Space Utilization Formula for SOS Log Files" to calculate the disc space utilization of logfiles.

The log file size is automatically the EOF unless you abort the batch job. If you abort a batch job it will take a pre-allocated log file space of 20000. Then if you restart the batch job the prior log file will automatically be converted to EOF, thus cleaning up disc space.

The following is

:job sosfull,mgr.lps,logfiles; outclass=lp,1

:comment ********************************************************

:comment *** This job will provide continuous SOS monitoring

:comment *** by streaming itself and logging off every night at

:comment *** midnight.

:comment *** It provides full reporting to $stdlist.

:comment ********************************************************

:comment This job is intended for use with SOS version F.04a or later.

:comment Versions of this job that were supplied with earlier versions

:comment of SOS may no longer work and should not be used.

:comment

:comment Similarly, this job may be invalidated by future SOS releases.

:comment

:comment Please refer to the release notes of each version for further

:comment information.

:tellop *** SOS/3000 Batch Job Collection is Starting: ***

:comment Refer to the comments in the soslogxj job for information about

:comment providing input to sos.

:setdump

:run sos.pub

Y : Should batch output be suppressed

300 : SOS sample interval

Y : Display Key Indicators of Performance

Y : Display advice

Y : Display informational advice messages

2 : Global display option

Y : Display global memory statistics

Y : Display global disc statistics

Y : Collect process/workload Information

Y : Display process information

Y : Display workload information

Y : Display only active workloads

0.0 : CPU percentage required for display

Your Company Name

N : Display extended process line

N : Display 132 column process line

N : Show Wait State on first process line

N : Display first instead of full response time

Y : Display page fault rate instead of IO/Transaction

N : Display total I/O percent instead of R/W counts

Y : Display only active processes

0.0 : CPU percentage required for display

Y : Display session processes

Y : Display job processes

Y : Display system processes

Y : Display command interpreter processes

Y : Display dead processes which have died

@.@ : Process logon filter

4 : Process sort option

N : Sort processes in ascending order

0 : Process display limit

Y : Display CPU pulse points

N : Display Memory pulse points

N : Display Disc I/O pulse points

N : Display misc pulse points

Y : Should logging be enabled?

Y : Should disc space utilization info be logged

10 : Process log limit

Y : Should process tracking be enabled

N : Should Memory detail information be displayed

N : Should Global Stop information be displayed

N : Should Disc I/O summary information be displayed

N : Should Tape drive I/O detail information be displayed

N : Should system printer I/O detail information be displayed

N : Should serial printer I/O detail information be displayed

Y : Should device detail info be limited to active devices

N : Should terminal response detail information be displayed

N : Should system transaction manager detail information be displayed

N : Should user transaction manager detail information be displayed

0 : Enter duration of job in minutes

:eod

:stream sosfull.pub

:tellop *** SOS/3000 Batch Job Collection is Finished! ***

:eoj

a sample of SOSFULL jobstream.