CHKSTDJOBS CHECK STANDARD JOBS TAAJOFC
The Check Standard Jobs command provides a method of determining if required system and standard processing jobs are active. CHKSTDJOBS operates by using the output of the TAA CVTWRKACT command when the system is known to be in a good state. When a check is needed, CVTWRKACT is used again and compared against the standard values. Testing CHKSTDJOBS ------------------ ** It is best (but not essential) to run this test when the system is quiet and no other batch work is being performed. ** To provide for a test, enter the following command: SBMJOB JOB(TSTSTDJOBS) CMD(DLYJOB 300) JOBQ(QSYSNOMAX) This will submit a job which waits for 5 minutes to allow a test. ** Run the following CRTSTDJOBS command. Choose a library so that the STDJOBP file will be on the library list when CHKSTDJOBS is run. CRTSTDJOBS OUTLIB(xxx) The STDJOBP file would be created with the active batch jobs. ** Run the CHKSTDJOBS command. This command would normally be run with the default of DLTSPLF(*YES) which would produce an escape message if any jobs from STDJOBP are not currently active. CHKSTDJOBS If a batch job was in existence when CRTSTDJOBS was run and is now complete, you should see an escape message. The spooled file is always retained if an error occurs. ** End the test job that was submitted: ENDJOB JOB(TSTSTDJOBS) OPTION(*IMMED) ** After waiting a moment for the TSTSTDJOBS job to be ended, run the CHKSTDJOBS command again: CHKSTDJOBS You should receive an escape message because the TSTSTDJOBS job is no longer active. ** Display the output listing. You should at least see the TSTSTDJOBS job is flagged. You will probably see some standard jobs with a count of more than one. This is typical of system server jobs. When there is more than one job for the same subsystem, job, and user name (the job number is not considered), the count will reflect the number of duplicates. Note that it is not an error if additional batch jobs are active. Only the standard jobs are considered. Establishing a standard jobs file --------------------------------- ** The CRTSTDJOBS command should be run when the system is in a state that you would consider 'standard', but no additional batch jobs are being run. If you want to use the same library as used in the prior test, enter: CRTSTDJOBS ACTION(*REPLACE) ** You can check the file with: CHKSTDJOBS DLTSPLF(*NO) ** If a job is active that you do not want to be considered as standard, the record should be removed from the STDJOBP file. You can remove a job from the STDJOBP file by using: DLTDBFRCD FILE(xxx/STDJOBP) SELFLD(AJJOB) SELVAL(yyy) where yyy is the job name you want to delete. ** A new record may be added to the file with a tool such as EDTDBF. The following fields must be entered: AJSBS Subsystem AJJOB Job AJUSR User The field AJJCPU is used by CRTSTDJOBS to determine the number of jobs that should exist. Enter a value for AJJCPU (typically 1). If you have multiple jobs for the same subsystem, job, and user, enter the count of duplicates into AJJCPU. ** Once you have the STDJOBP file as desired, you can run the CHKSTDJOBS command and check for errors. The following is typical code in a CL program. CHKSTDJOBS STDJOBPLIB(xxx) MONMSG MSGID(TAA9893) EXEC(DO) /* Failed */ /* */ /* Your handling of the failed */ /* condition */ /* */ ENDDO /* Failed */ You might want to have a never ending program submitted by a startup program that checks every hour such as: LOOP: DLYJOB DLY(3600) /* Previously shown code */ GOTO LOOP ** On each new release of the system (or in some cases PTF changes), you may need to repeat the process to see if the system has added other jobs that need to be considered. How CHKSTDJOBS operates ----------------------- When CRTSTDJOBS is run, the TAA Tool CVTWRKACT is used to output a file of the active batch jobs. The file is then sorted by subsystem, job, and user. The AJJCPU field is used to hold the count of the required active jobs. It is zeroed out in all records. The CVTWRKACT file is then read and each corresponding record in the sorted file is updated with a count of one in the AJJCPU field. Note that the key is subsystem, job, and user so only the first duplicate record (if any) is updated for each duplicate. The file is then copied to the STDJOBP file in the named library. When CHKSTDJOBS is run, CVTWRKACT is used for the active batch jobs. The AJINTC field is zeroed out for each record in the STDJOBP file. Each active job is then read and if a corresponding record exists in STDJOBP, the AJINTC field is updated with a count of one. The STDJOBP is then read and the AJJCPU field is compared to the AJINTC field. Any differences are flagged. A spooled file is always output. If no differences were found and DLTSPLF(*YES) was specified, the spooled file is deleted. If differences were found, an escape message is issued. CHKSTDJOBS escape messages you can monitor for ---------------------------------------------- TAA9893 One or more jobs that should be active are not. Escape messages from based on functions will be re-sent. CRTSTDJOBS Command parameters *CMD ----------------------------- STDJOBPLIB The library where the STDJOBP file will exist. The command should be run when the system is in a standard state, but no other batch work is being performed. See the tool documentation. ACTION The action to be performed. *CREATE is the default to create the file and copy the active batch jobs. *REPLACE may be specified to replace the data in the existing file with the current active batch jobs. CHKSTDJOBS Command parameters *CMD ----------------------------- STDJOBPLIB The library where the STDJOBP file exists. This file must be created by CRTSTDJOBS. DLTSPLF A *YES/*NO value to determine if the spooled file created by the command should be retained. *YES is the default to delete spooled file if no differences are found. Note that the spooled file is always retained if differences are found. *NO may be specified to always retain the spooled file. Restrictions ------------ None. Prerequisites ------------- The following TAA Tools must be on your system: CVTWRKACT Convert work active DUPTAADBF Duplicate data base file EDTVAR Edit variable RTVFMT Retrieve format RTVSYSVAL3 Retrieve system value 3 SNDCOMPMSG Send completion message SNDDIAGMSG Send diagnostic message SNDESCINF Send escape information SNDESCMSG Send escape message SNDSTSMSG Send status message SORTDBF Sort data base file Implementation -------------- See the previous instructions. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- CHKSTDJOBS *CMD TAAJOFC QATTCMD CRTSTDJOBS *CMD TAAJOFC2 QATTCMD TAAJOFCC *PGM CLP TAAJOFCC QATTCL TAAJOFCC2 *PGM CLP TAAJOFCC2 QATTCL TAAJOFCR *PGM RPG TAAJOFCR QATTRPG TAAJOFCR2 *PGM RPG TAAJOFCR2 QATTRPG