Previous Topic

Next Topic

Book Contents

Book Index

KSL Library Scripts

This table lists the KSL library scripts and their associated products, libraries, and JOB members. If an associated job member is not listed for a script, a standard KSL procedure can be used for that script.

You can use these scripts to design scripts for your own report utilities.

Note: In addition to the scripts in the IOA KSL library, the IOA SAMPLE library contains many other useful scripts. However, the scripts in the IOA SAMPLE library have been developed and supplied by users. They have been placed in the IOA SAMPLE library as examples. They have not been tested and they are not supported.

Script

Product

Library

JOB member in xxx.JCL

Description

ADDCOND7

IOA

KSL

ADDMNCND

Manual operations to be performed at night (Previously called REP7COND).

ADDMAYBE

CTM

KSL

MAYBEJOB

A general utility routine that adds the MAYBE condition to jobs with the following criteria:

  • If the TIME parameter is after the FROM TIME, and before the UNTIL TIME, as defined in the Control-M Job Definition.
  • If the GROUP parameter is the same as, or has same prefix as, the GROUP defined in the Control-M Job Definition. Leaving the GROUP parameter blank includes all GROUPs.

BJR5ALL

CTB

 

 

All Control-M/Analyzer Log messages during a specified period.

BRPBLEFT

CTB

KSL

 

All Control-M/Analyzer missions that have not yet been scheduled, and a description for the problem.

BRPCOMM

CTB

KSL

 

Values of variables committed to the database for each rule invocation.

BRPGRP

CTB

KSL

 

Site-defined application groups and their current mode of implementation.

BRPINV

CTB

KSL

 

Status of all jobs currently in the Active Balancing file.

BRPJPRT

CTB

KSL

 

Printout of the invocation report of a specific rule.

BRPRLBK

CTB

KSL

 

Roll back a specific Rule Activity display entry.

BRPRLDEF

CTB

KSL

 

Printout of specified rule definitions.

BRPROLL

CTB

KSL

 

Roll back a Control-M/Analyzer invocation from a specified job step.

BUTCRGRP

CTB

KSL

 

Create a group in the Control-M/Analyzer database.

BUTCRVAR

CTB

KSL

 

Create a variable definition under a specified group in the Control-M/Analyzer database.

BUTMSORD

CTB

KSL

 

Order a Control-M/Analyzer balancing mission.

CTDSCREN

CTD

SAMPLE

 

Printout of all Control-V screens (for documentation and training).

CTOALOR1

CTO

SAMPLE

 

Lists the Automation Log messages for the specified date (Previously called REPOALO).

CTTEXPV

CTT

SAMPLE

 

Uses Control-M/TAPE API in order to expire (make scratch) volumes. the program reads the input volumes from the SYSIN DD.

DHLDGRP1

CTD

SAMPLE

 

Hold a group of reports.

HOLDELGR

CTM

KSL

DELGROUP

Hold and delete all entries related to a certain Control-M group.

HOLDGRP

CTM

KSL

HOLDGRUP

Hold a group of jobs in the AJF.

HOLDGRUP

CTM

 

 

Hold a group of jobs.

MAYBEJOB

CTM

 

 

Add prerequisite conditions for maybe jobs.

ORDERBPR

CTD

SAMPLE

 

Order or force backup, printing or restore missions.

ORDERREP

CTD

SAMPLE

 

Order or force report decollating missions.

ORDERRUL

CTO

SAMPLE

 

Order a specified rule (Previously called RULORDER).

PRINTREP

CTD

CTV

SAMPLE

 

Print specific reports by specifying report name, index value and date.

REP3GRUP

CTM

 

 

Status of all the jobs of specified groups.

REP3LEFT

CTM

 

 

All jobs still in the Active Job File that did not run during the previous night (wait schedule, ended NOT OK, executing) and the reasons for the problems.

REP3STAT

CTM

 

 

Statistical summary of what must be done tonight, or job status in the morning.

REP3TAPE

CTM

 

 

Status of all jobs using tapes.

REP3WHY

CTM

 

 

All jobs in the Active Jobs file having a WAIT SCHEDULE status.

REP5ABND

IOA

 

 

All abends in a given period.

REP5ALL

IOA

 

 

All IOA Log file messages of a specified period.

REP5MSGD

IOA

 

 

All IOA Log file messages of specified message codes for a specific period.

REPCALND

IOA

SAMPLE

 

Printout of calendar definitions (Previously called REP8CAL).

REPJOBAV

CTM

KSL

REP3AVER

This report prints job statistical information for all or selected jobs currently residing on the AJF.

REPJOBGR

CTM

KSL

REP3GRUP

This report prints the status of all jobs on the AJF belonging to specified groups.

REPJOBMO

CTM

KSL

REP3LEFT

Print all the jobs left (WAIT SCHEDULE, ended not ok, executing) on the active jobs file, and a description for the problem.

REPJOBMO

CTM

KSL

CTMPSIMS

Skeleton for simulation job and tape pull list.

REPJOBRS

CTM

KSL

REPJOBRS

Last night restart history report.

REPJOBSA

CTM

KSL

REP3STAV

Print list of jobs that exceeded average elapsed time.

REPJOBSS

CTM

KSL

REP3STAT

Print a statistical summary of what should be done tonight, or job status the next day.

REPJOBSY

IOA

SAMPLE

 

 

REPJOBTP

CTM

KSL

REP3TAPE

Prints the status of all jobs on the AJF using a tape.

REPJOBWH

CTM

KSL

REP3WHY

Print list of jobs which are in WAIT SCHEDULE status.

REPLGGRD

CTD

SAMPLE

 

Print all log messages for specific groups.

REPLGMSG

IOA

KSL

REP5MSGD

Print all log messages for specific messages for a specific period of time.

REPLOGAB

IOA

KSL

REP5ABND

Print all ABENDS in a period.

REPLOGAL

IOA

KSL

REP5ALL

All IOA Log file messages of a specified period.

REPLOGAL

IOA

KSL

REP5ALL

Print all the log messages for a specific date.

REPLOGCN

IOA

SAMPLE

 

Print all log events associated with messages.

REPLOGEM

CTM

SAMPLE

 

Print all the emergency (recovery) jobs which were activated in a period.

REPLOGEX

IOA

SAMPLE

 

Log - exception report.

REPLOGGR

CTR

SAMPLE

 

Print all log messages of specified groups.

REPLOGMN

IOA

SAMPLE

 

Print all log messages of type user.

REPLOGNC

CTM

SAMPLE

 

Print all 'NOT CATLGD 2' log events in a period.

REPLOGRS

CTM

SAMPLE

 

Print all log events associated with messages.

REPLOGST

IOA

SAMPLE

 

Night exception report (Previously called REP5EXP).

REPLOGST

IOA

SAMPLE

 

Print job statistics at night.

REPLOGUS

IOA

SAMPLE

 

Print all log messages of specified users.

REPOJHST

CTO

SAMPLE

 

List events and important messages for specified jobs and started tasks. Input to the report is the REPJHIST rule table in the Control-O RULES library (Previously called REPJHSJ).

REPRERUN

CTM

KSL

RERUNJOB

Rerun a specified job.

REPRULED

CTO

SAMPLE

 

Prints specified rule definitions (Previously called REPRLDEF).

REPSCHED

CTM

KSL

REPJBDEF

Report routine to print job schedules.

REPUPRT

CTD

KSL

 

Print a report via IMMEDIATE/DEFERRED print option in the USER screen.

REPUSRHP

CTD

KSL

 

Print a list of the user's reports currently available in the history file.

REPUSRHR

CTD

KSL

 

Change retention period of reports of specified job from the history file.

REPUSRPP

CTD

KSL

 

Print a list of user's reports currently available for online viewing. The reports will be requested to PRINT DEFERRED (with a PRINTING MISSION).

REPUTREE

CTD

SAMPLE

 

Create a recipient tree from a given report.

REPUURUL

CTD

SAMPLE

 

List of the user’s currently defined rulers.

REPUUSRA

CTD

SAMPLE

 

List of all users who may receive

  • a report from a specified job (including the names of the reports)
  • list of all users who may receive a specific report.
  • list of all user’s reports currently available for online viewing, and their status, line count and page count.

REPUUSRP

CTD

SAMPLE

 

List of all reports a user may receive at any time.

REPVOLES

CTT

SAMPLE

 

List of all or selected volumes in the Media Database.

RPDAMSCH

CTD

SAMPLE

 

Status of all missions currently in the Active Missions file (such as tonight’s schedule or last night’s schedule).

RPDGLBC

CTD

SAMPLE

 

Perform global changes to the IN condition in report decollating missions.

RPDJOBGR

CTD

SAMPLE

 

Status of all report decollating missions of specified groups.

RPDJOBMO

CTD

SAMPLE

 

All missions remaining in the morning (WAIT SCHEDULE, Ended NOTOK), with explanation.

RPDJOBUS

CTD

SAMPLE

 

Status of all the reports (jobs) to be decollated for specified user IDs.

RPDPSCHD

CTD

SAMPLE

 

Printout of printing mission definitions.

RPDRERUN

CTD

SAMPLE

 

Rerun a report decollating mission.

RPDSCHED

CTD

SAMPLE

 

Printout of report decollating mission definitions.

RPRSV

CTM

SAMPLE

 

Print all restart messages for a given period.

RPTABRUL

CTO

SAMPLE

 

Cross-references all tables and rules for each message (Previously called REPOXRFM).

UPDACTC

CTD

SAMPLE

 

Update the number of copies of a report.

UPDRPRT

CTD

SAMPLE

 

This KSL delete oldest duplicate reports those have the same user, jobname and report name.