Previous Topic: Forecast CommandsNext Topic: Forecasting from the Database


Common Forecast Parameter Descriptions

The following parameters are used throughout the forecast commands and are defined here and referred to later as needed.

DRMODE

If DRMODE=YES (or Y) is specified, the forecast is limited to jobs with an active disaster recovery class. The DRCLASS keyword can override the list of active disaster recovery classes. DRMODE=NO (or N) can be used. If the DRMODE keyword is not specified, DRMODE=YES is used when CA Workload Automation SE is currently running in disaster recovery mode, or DRMODE=NO if not.

DRCLASS

Overrides the list of active disaster recovery classes for the forecast command. If DRCLASS is not specified and the forecast command runs in disaster recovery mode, the list of active disaster recovery classes in CA Workload Automation SE is used. If DRCLASS is specified, only the disaster recovery classes on the DRCLASS keyword are considered active.

Note: The combination of DRMODE and DRCLASS parameters, with the disaster recovery initialization settings (DRMODE,TRIGGERS), impact what the forecast commands display for disaster recovery situations. For example, if the TRIGGERS=DR is in effect, the forecast commands for a specific job show its job flow but only include triggers with an active DRCLASS. The flow terminates on the first trigger with an inactive DRCLASS and does not include that trigger. When TRIGGERS=NONEXEC or TRIGGERS=ALL in effect, all triggers are included. Be sure to check your DRMODE, DRCLASS, and DRMODE TRIGGERS settings if your forecast output is not as expected. The /DISPLAY,ST=DR shows the TRIGGERS setting.

Note: For more information about Disaster Recovery Mode, see the Systems Programming Guide.

INT

See the RINT keyword.

JOB

(Optional) Defines the jobs to forecast.

Note: Job names can be masked with complex masking (? and *).

Default: *

Limits: 1 to 8 alphanumeric characters

*

Indicates to forecast all jobs.

jobname

Defines a specific job name.

jobname*

Defines a generic job name terminated with an asterisk.

(jobname1,jobname2,...,jobname10)

Defines up to ten specific job names.

mask

Defines a keyword value mask.

JOBNET

(Optional) Defines the job network field as the selection criteria for the jobs to forecast.

Default: *

Limits: 1 to 8 alphanumeric characters

*

Specifies all names.

name

Defines a specific name.

name*

Defines a generic name terminated with an asterisk.

mask

Defines a keyword value mask.

Note: If value contains a blank, comma, or quote, it is not possible to specify the value through batch input.

LVL

(Optional) Defines the number of triggering levels to display. If not defined, the forecast stops after 100 levels or the value defined in the FCMAXLEV keyword in the CA Workload Automation SE initialization file.

Default: 100 (or CA Workload Automation SE initialization file override)

Limits: 1 to 3 numeric (1-999)

MAINID

(Optional) Specifies that only those jobs set to run on the specified MAINID appear in the forecast.

Limits: 1 numeric character from 1 to 7 preceded by SY

NW

(Optional) Defines the networks as a selection criteria for the stations to forecast. A combination of STN and NW values governs the final selection of a station to forecast. If STN=T*,NW=N* is specified, only the stations whose names start with T and belong to networks whose names start with N are selected for the forecast.

Default: *

Limits: 1 to 8 alphanumeric characters

*

Specifies all networks to forecast.

network

Defines a specific network name.

network*

Defines a generic network name terminated with an asterisk.

mask

Defines a keyword value mask.

NWOPT

(Optional) Specifies whether the forecast includes the output networks and their individual stations for the jobs. If NWOPT is omitted, no connected networks are included.

N

Specifies to include output networks, but not to list individual workstations in the networks.

S

Specifies to include individual workstations in the network.

RINT|INT

(Optional) Defines the interval time for the forecast of resources needed for the workload. The entire forecast span is divided into successive time intervals of the value specified to forecast the number of jobs running and percent of CPU use during each interval.

Limits: 4 numeric characters specified as hhmm from 0010 (10 minutes) to 2400 (24 hours)

SCHID

Defines the schedule ID value as the selection criteria for jobs to forecast.

Default: 0 (all schedule IDs)
except for FSTRUC the default is 1

Limits: 1 to 3 numeric characters from 0 to 255
except for FSTRUC 1-255

Required: Only if job has no defined schedule

SEG

(Optional) Specified only with LIST=WP or LIST=WPS to define which segment and subsegment of prose to include in the worksheet. If omitted, LIST=WP and LIST=WPS produce all prose associated with a particular job. If only segment selection is desired, the parentheses can be omitted.

Limits: 1 to 8 alphanumeric characters segment
1 to 8 alphanumeric characters subsegment

SEQ

(Optional) Specifies the sequence in which forecast reports are presented.

Default: DLDT

DLDT

Specifies the sequence as the ascending order of deadline or starting date and time of job, ending date and time of job, and job name.

DODT

Specifies the sequence as the ascending order of due-out or ending date and time of job, starting date and time of job, and job name.

JOB

Specifies the sequence is in the ascending order of job name, starting date and time of job, and ending date and time of job.

STN

Specifies the sequence is in the ascending order of station name, starting date and time of station, and ending date and time of station.

STN

(Optional) Defines the workstations to forecast.

Default: *

Limits: 1 to 8 alphanumeric characters

*

Specifies all workstations are to forecast.

station

Defines a specific workstation name.

station*

Defines a generic workstation name terminated with an asterisk.

(station1,...,station10)

Defines up to ten specific workstations names. The workstation name specified by the first positional value can be a specific workstation name or a generic workstation name.

mask

Defines a keyword value mask.

SYS

(Optional) Defines the systems as a selection criteria for the jobs to forecast. A combination of JOB and SYS values governs the final selection of a job to forecast. If JOB=J*,SYS=S* is specified, only the jobs whose names start with J and that belong to systems whose names start with S are selected for the forecast.

Default: *

Limits: 1 to 8 alphanumeric characters

*

Specifies all system names.

system

Defines a specific system name.

system*

Defines a generic system name terminated with an asterisk.

Note: If value contains a blank, comma, or quote, it is not possible to specify the value through batch input.

mask

Defines a keyword value mask.

TRIG

(Optional) Specifies whether the forecast includes the job-triggered jobs, the data set-triggered jobs, or both.

Default: J (except JD for FSTRUC)

J

Specifies to include only the job-triggered jobs.

D

Specifies to include only the data set-triggered jobs.

DJ

Specifies to include both job-triggered and data set-triggered jobs.

JD

Specifies the same as DJ.

N

Does not include job triggers or data set triggers.

Any data set that a forecasted job can create and with a data set trigger defined, is assumed to be created thus triggering the other job.

TYPE

(Optional) Specifies whether the "dont schedule before/after" criteria defined on the job definition panel is honored when generating a forecast.

Default: ACTUAL

ACTUAL

Specifies honor "dont schedule before/after" criteria.

ALL

Specifies show all jobs as scheduled. Also indicates jobs that have NXTCYC,SET=OFF and NXTCYC,SET=SKP specified.

More information:

Masking