Jobtrac Reference Summ ENU
Jobtrac Reference Summ ENU
Jobtrac Reference Summ ENU
® ™
Management
Reference Summary
r11 SP1
Second Edition
This documentation and any related computer software help programs (hereinafter referred to as the
“Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by CA at
any time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in
part, without the prior written consent of CA. This Documentation is confidential and proprietary information of CA
and protected by the copyright laws of the United States and international treaties.
Notwithstanding the foregoing, licensed users may print a reasonable number of copies of the documentation for
their own internal use, and may make one copy of the related software as reasonably required for back-up and
disaster recovery purposes, provided that all CA copyright notices and legends are affixed to each reproduced copy.
Only authorized employees, consultants, or agents of the user who are bound by the provisions of the license for
the product are permitted to have access to such copies.
The right to print copies of the documentation and to make a copy of the related software is limited to the period
during which the applicable license for the Product remains in full force and effect. Should the license terminate for
any reason, it shall be the user’s responsibility to certify in writing to CA that all copies and partial copies of the
Documentation have been returned to CA or destroyed.
EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, TO THE EXTENT PERMITTED BY
APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING
WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY
LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT
LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY
ADVISED OF SUCH LOSS OR DAMAGE.
The use of any product referenced in the Documentation is governed by the end user’s applicable license
agreement.
Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the
restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-
7014(b)(3), as applicable, or their successors.
All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
For online technical assistance and a complete list of locations, primary service
hours, and telephone numbers, contact Customer Support at
http://ca.com/support.
3
4 Reference Summary
Contents
Chapter 1. Primary Commands . . . . . . . . . . . . . . . . . . . . . . . . . 9
Prefix Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
A= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
ADD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
ADD parms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
ADDLOC= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
ADR Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
AMR Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
ARG Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
AUDIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
AUTH Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
B= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
BROWSE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
BUSGRP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
CANCEL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
CC Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
CCPF Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
CPM Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
D Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
D= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
DATES Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
DATE= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
DELETE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
DOC or DOCEDIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
DSNQ= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
DTFMT= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
EDEP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
EDIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
EMAIL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
EMAILLST Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
ENDSAVE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
ENQ Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
ENQN= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
EXCLUDE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
FIND Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
FORCE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
FSWAP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
GSO Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
HIST Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
HOMELOC= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
I Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
IPLS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
ISERVE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
J= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
JCL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Contents 5
JCLTRAC Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
JMF Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
JOBQ= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
JTS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
K= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
L= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
MACT or MANUAL Command . . . . . . . . . . . . . . . . . . . . . . . . . . 62
MISSING Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
N= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
O or OUT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
PARMS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
PASSWORD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
PP= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
PROFILE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
PURGE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
RALL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
RELEASE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
REMLOC= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
RESET Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
RESOURCE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
RESV Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
RETRY Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
RSRC Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
RUN Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
S Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
SAR Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
SARDB Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
SAVE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
SCL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
SCS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
SHIFT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
SORT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
SPACE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
STATUS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
SYS CYCS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
SYS HOLS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
SYS OPTS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
SYS USER Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
T= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
TEMP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
VER Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
VOLUME Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
WAIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
XNODE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
? or ?EDIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
@HOLD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
@INT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
@REL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
@RES Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
6 Reference Summary
Chapter 2. Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . 107
Contents 7
@PRIORITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
@REPORT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
@RERUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
@SCHENV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
@SETLOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
@TODAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
@TRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
@WDnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
@WORKD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
UDEFn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
8 Reference Summary
Chapter 1. Primary Commands
The following chapter describes the top line (command line) Unicenter®
CA-Jobtrac™ Job Management (Unicenter CA-Jobtrac) commands available on
various product panels.
Prefix Command
The prefix command displays the Scheduled Event Display panel listing all
events beginning with prefix.
──prefix────────────────────────────────────────────────────────────
Example
This example displays all events whose names begin with TESTJ.
TESTJ
Note: All of the primary commands cannot be used as prefixes.
10 Reference Summary
A= Command
A= Command
The A= command displays the Scheduled Event Display panel listing all events
with specified abend code or catalog checks.
──A=─┬─abend─┬──────────────────────────────────────────────────────
├─CC────┤
├─CAT───┤
├─S─────┤
└─U─────┘
Examples
ADD Command
The ADD command displays the Event/Jobstream Addition panel.
──┬─A───┬───────────────────────────────────────────────────────────
└─ADD─┘
ADD parms
This command adds event named eventname to the current schedule and
assigns manual release dependency (M), current time and date, maximum
condition code value 0000, and process period RQ-userid. If the event is a
schedule or Unicenter CA-Jobtrac task, you must include the 0. Optionally,
specify a version number (.vv) and/or location ID (,L=nnn).
Specify the event type by using the (,C) (,D) or (,E) options. The event types
are as follows:
,C
Indicates that the named event defines a command to be executed at a
particular remote node.
,D
Indicates that the named event is a dummy job.
,E
Indicates the named event is a REXX IMOD.
12 Reference Summary
ADD Command
Specify the GSS node name (up to 16 characters) of the executing node for
the named event with the ,N=nodename parameter. Depending on the type of
event, use the REXX IMOD (,E event type), or to specify a command to be
executed at a particular remote node (,C event type).
──ADD──┬─────────────────┬──┬─────┬──┬────────┬──┬──────────┬────────
└──┬─eventname─┬──┘ └─.vv─┘ └─,L=nnn─┘ └─,─┬─C─┬──┘
├─sclname──┤ ├─D─┤
└─tasknm───┘ └─E─┘
──┬─────────────┬──┬──────────────────────────────┬──────────────────
└─,N=nodename─┘ └─,A=─┬─command─────────────┬──┘
├─imod-arg────────────┤
└─shellscriptname.arg─┘
Examples
ADDLOC= Command
The ADDLOC= command adds events (for viewing only) from location specified
by nnn (any location ID 000-254) to the Scheduled Event Display panel. If the
location is not defined in the user's TRACAUTH profile, added events can only
be monitored. If you use the TRACX26 user exit, you cannot use ADDLOC=nnn
to add events for viewing.
──ADDLOC=nnn────────────────────────────────────────────────────────
Example
This example adds events (for viewing only) from the location 029 to the
display.
ADDLOC=29
Note: To remove events (for viewing only) from the display, use the
REMLOC=029 command.
14 Reference Summary
ADR Command
ADR Command
The ADR command displays the active ADR (Automatic Dataset Recognition)
table.
For editing the ADR tables, see “JTS Command” on page 58.
AMR Command
The AMR command displays the active AMR (Automatic Message Recognition)
table.
For editing the AMR tables, see “JTS Command” on page 58.
16 Reference Summary
ARG Command
ARG Command
The ARG command displays the argument to pass based on the event type.
The argument is displayed in a pop-up panel.
The Edit Argument pop-up panel is displayed for editing purposes if the ARG
command is issued from the Scheduled Event Detail panel.
The Argument pop-up panel is displayed for viewing only if the ARG command
is issued from the Event Execution Detail panel.
AUDIT Command
The AUDIT command displays the Change Audit History panel for events. The
panel displays information about changes made to an event.
18 Reference Summary
AUTH Command
AUTH Command
The AUTH command displays the user's location Authorization Profile panel. If
AUTH is entered with no parameter, the Authorization Profile for the user
entering the command is displayed. If a user ID is included, the specified user
profile is displayed. If prefix* is specified, the profile displayed is for the group of
users whose user IDs begin with prefix. If you use the TRACX26 user exit,
AUTH has no effect.
──AUTH──┬────────────────┬──────────────────────────────────────────
└─=─┬─userid──┬──┘
└─prefix─┘
Examples
This example displays the Authorization Profile panel for the user entering the
command.
AUTH
This example displays the Authorization Profile panel for the user with ID
TSOUSR.
AUTH=TSOUSR
This example displays the Authorization Profile panel for all users whose ID
begins with TSO.
AUTH=TSO
B= Command
The B= command displays a Scheduled Event Display panel listing events with
the business group name specified by bgname. Replace prefix with the first few
letters of the bgname of the events you want to display on the Scheduled Event
Display panel.
──B=─┬─bgname──┬────────────────────────────────────────────────────
└─prefix─┘
Example
20 Reference Summary
BROWSE Command
BROWSE Command
The BROWSE command displays either the JCL or the SCL that will be used
for the event. The JCL can be either temporary-use or production JCL. You can
only view the JCL or SCL, you cannot edit it with this command. Displays the
IMOD Facility of CA-GSS (Global SubSystem) if the event is a REXX IMOD.
BUSGRP Command
The BUSGRP command displays the Business Group Status panel. The panel
displays information about each business group. You can select the busgrp and
then go to the Scheduled Event Display panel for those jobs in this busgrp.
22 Reference Summary
CANCEL Command
CANCEL Command
The CANCEL command exits from a panel and cancels any changes you have
made. Use this command to exit a panel without saving any changes you have
made.
CC Command
The CC command displays the Step Condition Code Exceptions panel. The
Step Condition Code Exceptions panel is a pop-up panel that displays the
condition code parameters that have been defined for an event.
24 Reference Summary
CCPF Command
CCPF Command
The CCPF command displays the active CCPF (Condition Code Program Filter)
table.
For editing the CCPF tables, see “JTS Command” on page 58.
CPM Command
The CPM command displays the CA Critical Path Monitor panels.
26 Reference Summary
D Command
D Command
The D command defines or executes the default command specified by
command. The default command is executed automatically when Unicenter
CA-Jobtrac is accessed or whenever D is entered.
──D──┬─────────┬────────────────────────────────────────────────────
├─command─┤
└─OFF─────┘
Examples
This example defines the command K=LAW as the default command. K=LAW
is executed automatically when Unicenter CA-Jobtrac is accessed or when D is
entered.
D K=LAW
This example executes the default command. If no default command has been
defined, the RALL command is executed. The DEFAULT COMMAND
parameter is located in the 'PROFILE' command display in the CA-Jobtrac User
Profile panel.
D
D= Command
The D= command displays Scheduled Event Display panel listing all events with
specified dependency or dependencies.
──D=─┬─A──┬─────────────────────────────────────────────────────────
├─D──┤
├─E──┤
├─H──┤
├─I──┤
├─J──┤
├─JW─┤
├─M──┤
├─O──┤
├─P──┤
├─Q──┤
├─R──┤
├─T──┤
├─X──┤
├─?──┤
└───┘
A
Displays events with the abend bypass dependency code.
D
Displays events with the data set required dependency code.
E
Displays events with the edit JCL dependency code.
I
Displays events with the environmental dependency code.
J
Displays events with the JCL required dependency code.
JW
Displays events with WLM resource dependency.
M
Displays events with the manual release dependency code.
O
Displays events with the output release dependency code.
P
Displays events with the predecessor event dependency code.
Q
Displays events with the queued release dependency code.
28 Reference Summary
D= Command
R
Displays events with the resource dependency code.
T
Displays events with time thresholds (the scheduled start time differs from
the target time).
X
Displays events with the mutual exclusion dependency code.
?
Displays events with the view documentation dependency code.
*
Displays events submitted using AUTO-SCHD.
Examples
This example displays all events on the current schedule with the dependency
code E.
D=E
This example displays all events on the current schedule with dependency
codes D, P, and/or X.
D=DXP
DATES Command
The DATES command, depending on security authorization, edits the specified
DATELIB member (the PRODDATE member is the default), which contains
Automatic Date Insertion rules. Optionally, you can add mbrname to display the
DATELIB member specified by mbrname. Other members in the DATELIB data
set might be JMFSYM01 and EXCLPARM. If authorized, you can edit the
member.
┌─PRODDATE─┐
──DATES──┼──────────┼───────────────────────────────────────────────
├─mbrname──┤
├─JMFSYM1─┤
└─EXCLPARM─┘
30 Reference Summary
DATE= Command
DATE= Command
The DATE= command defines the date parameter. Only events whose target
date matches this parameter are displayed on the Scheduled Event Display
panel. This parameter remains in effect until you change it or exit Unicenter
CA-Jobtrac.
──DATE=─┬─dd────────┬───────────────────────────────────────────────
├─mmdd──────┤
├─ddmm──────┤
├─mmdd-mmdd─┤
├─ddmm-ddmm─┤
└─ALL───────┘
Examples
This example lists events with target dates on the fourth day of any month.
DATE=4
This example lists events with target dates from April 11 through April 15.
DATE=411-415
DELETE Command
The DELETE command deletes the selected event awaiting submission. The
selected event is deleted from the current schedule and put on the history
database with the user ID of the user who deleted the event. If you have
Unicenter CA-11, this command automatically changes the Unicenter CA-11
status of the event to PRODUCTION. Any predecessors or successors that are
related to this event are not released from dependence on this event.
32 Reference Summary
DOC or DOCEDIT Command
┌──────────┐
───┬─DOC─────┬──┼───────────┼──┬─────┬──────────────────────────────
└─DOCEDIT─┘ ├─eventname─┤ └─nnn─┘
└─prefix───┘
DSNQ= Command
The DSNQ= command displays enqueue research for the data set name or
data set name prefix specified by dsname. The resulting display lists all users
of the data set.
──DSNQ=─┬─dsname─┬──────────────────────────────────────────────────
└─prefix─┘
34 Reference Summary
DTFMT= Command
DTFMT= Command
The DTFMT= command changes the date format on Scheduled Event Display
panels to American or International format. Specify A for a date in the format of
mm/dd. Specify I for a date in the format of dd/mm.
──DTFMT=─┬─A─┬──────────────────────────────────────────────────────
└─I─┘
EDEP Command
The EDEP command displays the Environmental Dependencies panel for a
specific event that shows the environmental dependencies for an event.
36 Reference Summary
EDIT Command
EDIT Command
The EDIT command edits JCL for the selected event or SCL for the selected
schedule. If authorized, you can edit the JCL or SCL. The JCL can be either
temporary-use or production JCL. Displays the IMOD Facility of CA-GSS if the
event is a REXX IMOD.
EMAIL Command
The EMAIL command allows editing of the email location data set to specify
email template information in the TRACMnnn location data sets. You must
specify either a member name, a prefix, or an *. You must specify a location
following the comma as either L=nnn or just nnn. If you specify the member
name as * or prefix*, the PDS member list displays the requested list of
members. You can then select a member to edit. If you specify a member
name without an *, edit for the member is invoked directly.
──EMAIL─┬─member──┬─,─┬────┬─nnn────────────────────────────────────
├─prefix─┤ └─L=─┘
└────────┘
38 Reference Summary
EMAILLST Command
EMAILLST Command
The EMAILLST command alters or displays the list of EMAIL template member
names and the events that trigger the email creation for a job on the
checkpoint.
──EMAILLST──────────────────────────────────────────────────────────
ENDSAVE Command
The ENDSAVE command exits from a panel and saves any changes you have
made.
40 Reference Summary
ENQ Command
ENQ Command
The ENQ command displays the Enqueue Research panel.
ENQN= Command
The ENQN= command displays enqueue activity for the QNAME specified by
enqname.
──ENQN=enqname──────────────────────────────────────────────────────
42 Reference Summary
EXCLUDE Command
EXCLUDE Command
The EXCLUDE command excludes certain events from the listed events on the
display based on whether those certain events are predecessors or successors.
The RESET command refreshes the Missing Events panel.
──EXCLUDE─┬─P────────────┬──────────────────────────────────────────
├─PREDECESSORS─┤
├─S────────────┤
└─SUCCESSORS───┘
FIND Command
The FIND command searches the display for character strings. Use single or
double quotes around string. You can limit the search to a specific column.
Specify a column name that is longer than one word in
columnname1-columnname2-columnname3 format. Use the FIND command
with no parameters to repeat the previous find.
┌─—───────────────┐ ┌─NEXT──┐
┬───────────────┬┴──┼───────┼────────────────────
──FIND──'string'───
└─'column-name'─┘ ├─ALL───┤
├─FIRST─┤
└─LAST──┘
Example
This example finds all the occurrences of EOM in the Event Name column on
the panel.
FIND EOM EVENT-NAME ALL
44 Reference Summary
FORCE Command
FORCE Command
The FORCE command allows jobs to be released when Unicenter CA-Jobtrac
is on hold. Issuing this command requires the use of both a line command (*)
and a primary command (FORCE).
Place the * on the line next to the job to be forced, and then enter FORCE on
the command line. The job is allowed to run, even if Unicenter CA-Jobtrac is on
hold. The job is still subject to any dependencies that it may have. It is only
released when all of its dependencies are removed.
This command does not force jobs to run when the checkpoint is locked.
The * line command, when specified without the FORCE command, displays a
hex dump of the checkpoint record for the event. This command is typically not
useful to operators. It is intended for use at the request of Technical Support.
FSWAP Command
The FSWAP command changes the database and token that is being accessed
by the Unicenter CA-Jobtrac ISPF interface to access forecast information or
swaps back to the production database/token. When swapped to a forecast
database, the event related displays will access the forecast data. Tables and
calendars, JCL, SCL related commands continue to access the production
database or be unavailable.
──FSWAP─┬─token─┬───────┬──┬────────────────────────────────────────
│ └─,dbid─┘ │
└─PROD─────────────┘
Example
This example swaps to the forecast database for token 'A'. The database ID
used is the default specified in the FCSTDBID keyword of the PPOPTION
(JOBTRA00) member.
FSWAP A
This example swaps to the forecast database for token 5 for forecast database
0165.
FSWAP 5,165
This example swaps to the production database and token defined by the
JOBTRACx DD DUMMY.
FSWAP PROD
46 Reference Summary
GSO Command
GSO Command
The GSO command displays the GSO panels for the selected SCL member. If
member name is used, the specified schedule is displayed from the specified
SCL library (nnn). If * is used with or without a partial name (prefix), an ISPF
EDIT Member List is displayed listing all the schedules whose names start with
a partial schedule name. Select a name from the list.
┌────────┐
──GSO─┼─────────┼──┬─────┬──────────────────────────────────────────
├─memname─┤ └─nnn─┘
└─prefix─┘
Example
This example displays the schedule WEEKSCD from your default SCL library.
GSO WEEKSCD
HIST Command
The HIST command displays the Event History Display panel for the selected
events.
Note: Specifying * causes Unicenter CA-Jobtrac to read the entire history
database. The response time for this command depends on the size of the
history database.
───┬─H────┬──┬─eventname─┬──────────────────────────────────────────
└─HIST─┘ ├─prefix───┤
└──────────┘
48 Reference Summary
HOMELOC= Command
HOMELOC= Command
The HOMELOC= command changes or sets your default location where nnn is
the location ID.
──HOMELOC=nnn───────────────────────────────────────────────────────
Note: To change the default location, see “PROFILE Command” on page 70.
I Command
The I command displays the Change Audit History panel for an event. The
panel displays information about changes made to an event.
50 Reference Summary
IPLS Command
IPLS Command
The IPLS command displays the IPL History panel.
ISERVE Command
The ISERVE command displays the IMOD Facility of CA-GSS. This facility is
used to create REXX IMODs. Be aware that CA-GSS must be set up for edit.
52 Reference Summary
J= Command
J= Command
The J= command displays the Scheduled Event Display panel listing all events
beginning with prefix.
──J=prefix──────────────────────────────────────────────────────────
Example
This example produces a Scheduled Event Display panel listing all events
whose names begin with TESTJ.
J=TESTJ
JCL Command
The JCL command displays the production JCL for an event for editing. If
eventname is used, the specified event's production JCL member is displayed.
If * is used with a prefix (partial event name), a list is displayed listing all the
JCL members whose names start with the prefix. Use * without a prefix to
display a listing of all the JCL members. Select a name from the list. Optionally,
you can specify a production JCL library using the nnn parameter where nnn is
the location ID.
┌──────────┐
──JCL─┼───────────┼──┬─────┬────────────────────────────────────────
├─eventname─┤ └─nnn─┘
└─prefix───┘
54 Reference Summary
JCLTRAC Command
JCLTRAC Command
The JCLTRAC command accesses the CA-JCLTrac primary options panel to
update options and to generate reports.
Or, this command invokes the JCL ANALYZER that syntax checks the JCL
member.
JMF Command
The JMF command invokes EDIT on the JMFSYM01 member of the Unicenter
CA-Jobtrac DD DATEFILE library.
56 Reference Summary
JOBQ= Command
JOBQ= Command
The JOBQ= command displays enqueue research for the event specified by
eventname or event prefix. The resulting display lists all data sets and
resources in use by the event. The specified event must be executing when this
command is issued.
──JOBQ=─┬─eventname─┬───────────────────────────────────────────────
└─prefix───┘
Example
JTS Command
The JTS command displays the Table Services Selection Menu. You can use
the menu to edit, browse, activate, copy, or print the following tables:
■ ADR tables (perform specified actions when data sets are closed)
■ AMR tables (perform specified actions when console messages are issued)
■ SCS tables (schedule commands for execution)
■ CCPF tables (impose condition code processing on a program, job, job
step, or procstep)
58 Reference Summary
K= Command
K= Command
The K= command displays a Scheduled Event Display panel listing events with
the specified characteristic or characteristics. Use this command to display
events currently having the dependency or dependencies you specify.
┌──
─────┐
┬───┬┴────────────────────────────────────────────────────────
──K=──
├─A─┤
├─C─┤
├─D─┤
├─E─┤
├─H─┤
├─L─┤
├─N─┤
├─R─┤
├─S─┤
├─T─┤
├─V─┤
└─W─┘
A
Displays events that terminated abnormally. This includes events that
abended, were purged, ended with an abnormal condition code, or had a
JCL error.
C
Displays events that have completed. This includes events that abended,
were purged, had a JCL error, or are awaiting output release.
D
Displays events with a dependency code.
E
Displays events that are currently executing.
H
Displays events with no incomplete predecessors.
L
Displays events whose scheduled start time has passed (late) or have a
late status.
N
Displays NJE jobs submitted on this node.
R
Displays events that are late awaiting rerun.
S
Displays remotely-submitted NJE jobs.
T
Displays events that are awaiting scheduled start time or date.
V
Displays events with Pred Count values that do not match the number of
current predecessors listed.
W
Displays events that have been submitted by Unicenter CA-Jobtrac but
have not begun execution (awaiting an initiator).
Examples
This example lists all events awaiting restart, currently executing, or completed.
K=REC
60 Reference Summary
L= Command
L= Command
The L= command displays a Scheduled Event Display panel listing events with
location ID specified by the nnn parameter (any location ID 000 to 254).
──L=nnn──┬───────────────┬──────────────────────────────────────────
└─,─┬─SHIFT1─┬──┘
├─SHIFT2─┤
└─SHIFT3─┘
Example
This example displays all events in location 000 and the times in the SYS
USER panel for SHIFT3 times.
L=,SHIFT3
62 Reference Summary
MISSING Command
MISSING Command
The MISSING command displays the Missing Events panel. Also see
“EXCLUDE Command” on page 43.
N= Command
The N= command displays a Scheduled Event Display panel listing any event
with a node parameter, including cross-platform jobs.
──N=nodename────────────────────────────────────────────────────────
64 Reference Summary
O or OUT Command
O or OUT Command
The O or OUT command displays sysout capture facility panels. If O or OUT is
entered with no parameter, the Sysout Capture Facility menu is displayed.
───┬─O───┬──┬───────────┬───,──D────────────────────────────────────
└─OUT─┘ ├─eventname─┤
├─prefix───┤
├──────────┤
└─&─────────┘
eventname|prefix*
Displays a Sysout Capture panel listing all sysouts for the specified event
name or prefix or, if sysouts for only one event match the event name or
prefix, displays the event actual sysouts
*
Displays a Sysout Capture panel listing all sysouts.
&
Displays the sysout archive index.
D
Displays deleted sysout entries.
To display the sysouts online, enter S in the field to the left of the event whose
sysouts you want to display. Or to print the sysouts, enter O in the field to the
event whose sysouts you want to print.
Examples
This example displays deleted sysout entries for any event beginning with
TEST.
O TEST,D
66 Reference Summary
PARMS Command
PARMS Command
The PARMS command Invokes edit capability on the PPOPTION library.
Optionally, you can specify memname to invoke edit capability on a particular
member from the TRACPARM DD. Possible member names are JOBTRA00,
EXCLPARM, and RESOURCE.
──PARMS──┬─────────┬────────────────────────────────────────────────
└─memname─┘
PASSWORD Command
The PASSWORD command displays the Remote System Credentials panel
from the Scheduled Event Detail panel. The panel is displayed using the event
name (or alternate member name if allowed) and the event location.
68 Reference Summary
PP= Command
PP= Command
The PP= command displays a Scheduled Event Display panel listing events
scheduled for the process period specified by procprd.
──PP=procprd────────────────────────────────────────────────────────
Example
This example lists all events scheduled for process period TUESDAY.
PP=TUESDAY
PROFILE Command
The PROFILE command displays the CA-Jobtrac User Profile panel. The
CA-Jobtrac User Profile panel is a pop-up panel that allows the users to
customize their Unicenter CA-Jobtrac ISPF interface options, such as default
location, enabling prompts, default search command, date format, or the
Unicenter CA-View database name.
70 Reference Summary
PURGE Command
PURGE Command
The PURGE command purges the selected event from the current schedule.
It also changes the status of the event to PURGED by userid. If you have
Unicenter CA-11, this command automatically changes the Unicenter CA-11
status of the event to PRODUCTION. Also see the P line command in
Chapter 2, “Line Commands” on page 107.
RALL Command
The RALL command displays all events on the current schedule. Also see “D
Command” on page 27.
72 Reference Summary
RELEASE Command
RELEASE Command
The RELEASE command releases dependencies.
Also see the A line command in Chapter 2, “Line Commands” on page 107.
REMLOC= Command
The REMLOC= command removes events for viewing from the location
specified by nnn (any location ID 000-254) from the Scheduled Event Display
panel. If you use the TRACX26 user exit, you cannot use REMLOC=nnn to
remove events for viewing.
──REMLOC=nnn────────────────────────────────────────────────────────
Example
This example removes events with location 029 for viewing from the panel.
REMLOC=29
Note: To add events (for viewing only) to the display, use the ADDLOC=029
command.
74 Reference Summary
RESET Command
RESET Command
The RESET command refreshes the current panel's display.
──┬─R─────┬─────────────────────────────────────────────────────────
└─RESET─┘
RESOURCE Command
The RESOURCE command displays the Resource Assignments panel for the
selected event that is currently using resources. This shows definitions of
resource dependencies for the selected event.
76 Reference Summary
RESV Command
RESV Command
The RESV command displays a list of any current DASD reserves in effect.
RETRY Command
The RETRY command retries the posting of the completion status information
of an NJE job back to the submitting system from the execution system.
78 Reference Summary
RSRC Command
RSRC Command
The RSRC command displays the Resource Assignments panel for the
selected event. This shows definitions of resource dependencies for the
selected event. This command is the same as the RESOURCE command.
RUN Command
The RUN command adds the event named eventname to the current schedule
for immediate submission (no dependencies). Assigns current time and date
and process period RQ-userid. If the event is a schedule or Unicenter
CA-Jobtrac task, you must include the 0. Optionally, specify a version number
(.vv) and/or location ID (,L=nnn). If a duplicate event exists on the current
schedule, its location will be used as the location for the newly added event.
Specify the event type by using the (,C) (,D) or (,E) options. The event types
are as follows:
,C
Indicates that the named event defines a command to be executed at a
particular remote node.
,D
Indicates that the named event is a dummy job.
,E
Indicates the named event is a REXX IMOD.
Specify the GSS node name (up to 16 characters) of the executing node for the
named event with the ,N=nodename parameter. Depending on the type of
event, use the REXX IMOD (,E event type), or to specify a command to be
executed at a particular remote node (,C event type).
──RUN──┬─────────────────┬──┬─────┬──┬────────┬──┬──────────┬────────
└──┬─eventname─┬──┘ └─.vv─┘ └─,L=nnn─┘ └─,─┬─C─┬──┘
├─sclname──┤ ├─D─┤
└─tasknm───┘ └─E─┘
──┬─────────────┬──┬──────────────────────────────┬──────────────────
└─,N=nodename─┘ └─,A=─┬─command─────────────┬──┘
├─imod-arg────────────┤
└─shellscriptname.arg─┘
80 Reference Summary
RUN Command
Examples
This example adds PRODJOB1 with location ID 002 to the current schedule for
immediate submission.
RUN PRODJOB1,L=2
This example adds Version 5 of PRODJOB1 with location ID 002 to the current
schedule for immediate submission.
RUN PRODJOB1.5,L=2
S Command
The S command displays a Scheduled Event Detail panel for the event
specified by eventname. If the event has been submitted, an Event Execution
Detail panel is displayed instead.
──S──eventname──────────────────────────────────────────────────────
Example
82 Reference Summary
SAR Command
SAR Command
The SAR command displays the CA-View Primary Selection panel. The first
time you issue this command, the Unicenter CA-View product prompts you for a
high-level database name. Enter the high-level index of the Unicenter CA-View
database you want to access. This name is saved in your Unicenter CA-Jobtrac
user profile. The sysout that you selected is displayed, and you can enter any
Unicenter CA-View command you want. For more information about Unicenter
CA-View commands, see the Unicenter CA-View documentation.
SARDB Command
The SARDB command changes the Unicenter CA-View database that Unicenter
CA-Jobtrac interfaces with. When you issue this command, Unicenter CA-View
displays the Unicenter CA-View Database Selection panel where you can
specify a different high-level database name. Enter the high-level index of the
Unicenter CA-View database you want to access. The new name is saved in
your Unicenter CA-Jobtrac user profile.
84 Reference Summary
SAVE Command
SAVE Command
The SAVE command saves any changes you have made to an event from a
panel.
SCL Command
The SCL command displays a schedule from a specified SCL library (nnn). If
memname is used, the specified schedule is displayed. If * is used with a prefix
(partial schedule name), a list is displayed listing all the schedule members
whose names start with the prefix. Use * without a prefix to display a listing of
all the schedule members. Select a name from the list. Also see the E line
command in Chapter 2, “Line Commands” on page 107.
┌─────────┐
──SCL──┼──────────┼──┬─────┬────────────────────────────────────────
├─memname──┤ └─nnn─┘
├─memname─┤
└─prefix──┘
Example
This example displays the schedule WEEKSCD from your default SCL library.
SCL WEEKSCD
86 Reference Summary
SCS Command
SCS Command
The SCS command displays the active System Command Scheduling table.
For editing the SCS tables, see “JTS Command” on page 58.
SHIFT Command
The SHIFT command displays a Scheduled Event Display panel listing events
with target submission times during the shift specified (1, 2, or 3). The T= and
SHIFT primary commands are mutually exclusive.
──┬─SHIFT1─┬────────────────────────────────────────────────────────
├─SHIFT2─┤
└─SHIFT3─┘
Note: For more information, see “SYS USER Command” on page 95 to set up
SHIFT1, 2, and 3 and “L= Command” on page 61.
Example
This example lists events with target submission times during the second shift.
SHIFT2
88 Reference Summary
SORT Command
SORT Command
The SORT command sorts the display in either ascending or descending order
based on the values in a specified column. Specify a column name that is
longer than one word in columnname1-columnname2-columnname3 format.
Use the SORT command without any parameters to put the display back in its
original sequence.
┌─—───────────────┐
┬───────────────┬┴──┬───┬──────────────────────────────────
──SORT───
└─'column-name'─┘ ├─A─┤
└─D─┘
Example
This example sorts the display in ascending order by the contents of the Status
column.
SORT CURRENT-STATUS
SPACE Command
The SPACE command displays an analysis of DASD (Direct Access Storage
Device) space.
90 Reference Summary
STATUS Command
STATUS Command
The STATUS command displays an analysis of component resource use on the
Unicenter CA-Jobtrac database and sysout capture file. Also displays version
and genlevel, token, and restage options.
Valid processing cycles span from 2 to 254 days. This panel can hold up to 105
different calendar locations. Each location can have up to 14 cycles.
92 Reference Summary
SYS HOLS Command
94 Reference Summary
SYS USER Command
T= Command
The T= command displays a Scheduled Event Display panel listing events with
target times during the time period specified. You can specify either a single
hour (hh) or a time range (hhmm-hhmm). The T= and SHIFT primary
commands are mutually exclusive.
──T=hh─┬─────────┬──────────────────────────────────────────────────
└─mm-hhmm─┘
Examples
This example lists events with target times from 12:00 p.m. to 12:59 p.m.
T=12
This example lists events with target times from 1:23 a.m. to 4:11 a.m.
T=123-411
96 Reference Summary
TEMP Command
TEMP Command
The TEMP command displays the temporary-use JCL for an event for editing if
the event has not been submitted or has not completed successfully. If no
temporary-use JCL exists for the event, a member containing a copy of the
event's production JCL is created in the temporary-use JCL library for the
event. On the Scheduled Event Detail panel, you see the field JCL source=T.
Also see “T= Command” on page 96.
VER Command
The VER command displays the version number of your Unicenter CA-Jobtrac.
98 Reference Summary
VOLUME Command
VOLUME Command
The VOLUME command executes CA-JCLTrac to create a Volume Pull List
panel from a real-time look at the JCL. This command is ignored if issued
against schedule members, IMODs, dummy jobs, or jobs in completed status. If
CA-JCLTrac encounters an error, the message JCL PROCESSING ERROR
appears on the panel. One or more CA-JCLTrac messages will be written to the
console describing the problem in more detail. The Volume Pull List Assist
panel includes vaulting and tape creation information supplied through
TRACX25. CA-JCLTrac uses the current setting for the EXIT25 or NOEXIT25
option for your TSO session to determine whether to call the exit.
WAIT Command
The WAIT command displays enqueue conflicts.
XNODE Command
The XNODE command displays the Cross Node Query-Criteria Selection panel.
? or ?EDIT Command
The ? command displays documentation members for viewing.
──┬─?─────┬──┬─────────────────┬──┬─────┬───────────────────────────
└─?EDIT─┘ │ ┌──────────┐ │ └─nnn─┘
└──┼─eventname─┼──┘
└─prefix───┘
@HOLD Command
The @HOLD command puts Unicenter CA-Jobtrac on hold. Places message
SCHEDULE HELD in upper-right corner of the panel. Issues the TRAC111I
user HAS PLACED SCHEDULE ON HOLD console message.
@INT Command
The @INT command requests a continuous update of the Scheduled Event
Display panel. The keyboard is locked while the update is in progress.
Depending on the type of terminal you have, you can enter either the PA1 or
the ATTN key to terminate the update session and wait for the panel to
reappear. The default is five seconds. Use the nn parameter if you want to set
an interval time that differs from the default time. This command is valid only
after you enter the RALL command.
──@INT──┬───────────┬───────────────────────────────────────────────
│ ┌─5──┐ │
└─=─┴─nn─┴──┘
@REL Command
The @REL command releases Unicenter CA-Jobtrac if it were put on hold.
Issues the TRAC001I user HAS RELEASED SCHEDULE HOLD console
message.
@RES Command
The @RES command displays the Global Resource Definitions panel. Also see
“RESOURCE Command” on page 76.
Record Format
The following figure depicts the record format of an SCL member. The following
sections briefly describe the columns of the record. For more information about
SCL, see the Schedule Creation Guide.
Event Name
The following describes the Event Name field:
SCL Heading
EVENTNM
Columns
1-8
Description
Specifies the name of one of the following to be added to the current
schedule:
■ Job (1-8 characters)
■ Schedule (1-7 character name of the SCL member, preceded by
zero, as in 0sclname)
■ Task (0ARCHIVE, 0SYSARCH, 0JOBARCH)
■ REXX IMOD (1-8 characters)
■ Dummy job (1-8 characters)
A + (plus sign) in column one means that the record is a
continuation record.
Threshold
The following describes the Threshold SCL field:
SCL Heading
blank
Column
9
Description
Specifies the action to occur at the time shown in the Time (TIME)
field. Possible entries:
blank
Indicates both start and target time.
A
Indicates abort time.
S
Indicates start time only.
T
Indicates target time only.
The Threshold field (no heading, column 9) and the Time field (TIME, columns
10-13) work together to provide one or more of the following functions:
■ Set a target time (time after which an unsubmitted event is flagged LATE)
■ Set a start time (earliest time an event can be submitted for execution)
■ Set an abort time (latest time an event can be submitted for execution)
Time
The following table describes the Time SCL field:
SCL Heading
TIME
Columns
10 - 13
Description
Specifies the time at which the action indicated by the Threshold
field (column 09) is to occur. Possible entries:
hhmm
Four-digit number, where hh specifies the hour (00-23)
and mm specifies the minute (00-59).
*
Sets the time based on the event's historical start time.
Depending on the available event history, the time is set
differently. The use of * is not much recommended.
Depending on various combinations of dependencies you
specify, the results might not be what you expected. For
more information, see the creating schedules chapters.
ASAP
As soon as all other dependencies are met.
Holiday Action
The following describes the Holiday Action SCL field:
SCL Heading
blank
Column
14
Description
Specifies the action to occur if the event's target date falls on a
holiday. This field cannot be used with the process period
WORKDAYS. Possible entries:
blank
Indicates the event is not scheduled at all (unless the
target date is not the current date).
S
Indicates the event is scheduled for the target date, even
though it is a holiday.
H
Indicates the event is scheduled for the target date, even
though it is a holiday, and is assigned a holiday hold with
a manual dependency (MH dependency code).
N
Indicates the event is scheduled for the next calendar
day after the holiday, even if the next day is not a regular
workday.
W
Indicates the event is scheduled for the next workday
following the holiday.
O
Indicates the event is scheduled only on holidays. If the
target date is not a holiday, the event is not scheduled at
all.
P
Indicates the event is scheduled for the workday previous
to the holiday.
Date
The following describes the Date SCL field:
SCL Heading
DATE
Columns
15 - 18
Description
Specifies the date on which the event is to be submitted (target
date). Possible entries:
mmdd
Four-digit number, where mm specifies the month (01-12)
and dd specifies the day (01-31).
mm**
The event is scheduled any day during the month
specified (for example, 02** schedules the event any day
during February).
**dd
The event is scheduled during any month on the
specified day (for example, **10 schedules the event on
the 10th day of any month).
*
The event is scheduled for the current date.
*+n
The event is scheduled for n days after the current date
(for example, *+3 schedules the event for the current
date plus three).
ASAP
As soon as all other dependencies are met. ASAP DATE
requires ASAP TIME. ASAP DATE jobs never become
late.
Event Type
The following describes the Event Type SCL field:
SCL Heading
blank
Column
19
Description
Identifies the type of event you are scheduling. Possible entries:
C
Indicates the event defines a command to be executed at
a particular remote node.
D
Indicates the event is a dummy job.
E
Indicates the event is a REXX IMOD. For information
about the use of REXX IMODs in Unicenter CA-Jobtrac,
see the Extended Scheduling Services Guide.
blank
Indicates the event is any other type of event.
Execution Dependency
The following describes the Execution Dependency SCL field:
SCL Heading
DEPS
Columns
20 - 24
Description
Specifies execution dependencies to be assigned. Possible entries
include the following:
A
Indicates an abend bypass.
D
Indicates a data set required dependency.
E
Indicates an edit JCL dependency.
J
Indicates a JCL required dependency.
M
Indicates a manual release dependency.
O
Indicates an output release.
P
Indicates a predecessor event dependency.
Q
Indicates a queued release dependency.
?
Indicates a view documentation dependency.
Referback
The following describes the Referback SCL field:
SCL Heading
blank
Column
25
Description
Specifies conditional requirements. This can be coded on the event's
secondary record or on referback records to add execution
dependencies to the primary record. Possible entries:
A=
Indicates that the event listed in the
Successor/Predecessor (RELEASEn) fields of the same
record is an alternate member name for the event's JCL.
Normally, the event's JCL must be in a member with the
same name as the event, this allows you to use a
member with a different name.
I=
Defines a time interval at which the event is to be
submitted.
CC=
Defines step exceptions to the maximum condition code
value defined for the event.
R=
Defines resource conditions to be satisfied before the
event can be submitted. This version only supports one
character resource codes. Use RS= instead.
RS=
Defines resource conditions to be satisfied before the
event can be submitted. Resource codes (up to 8) are
separated by commas. Each code can be two characters
long and must be defined in the RESOURCE PPOPTION
member.
&
Allows the argument for the IP= and ED= referback field
entries to continue to a length of 255 characters.
IP=
This entry specifies an argument to pass to the event
named in the Event Name (EVENTNM) field.
E
Indicates that events listed in the Successor/Predecessor
(RELEASEn) fields of the same record are environmental
dependencies.
ED=
Indicates that the event listed in the
Successor/Predecessor (RELEASEn) fields is an
environmental dependency. Unlike the E entry, ED
defines only one environmental dependency, but it also
gives the ability to specify a retry count, retry interval,
and an argument to pass to the environmental
dependency.
NODE=
Indicates the GSS node name (up to 16 characters) of
the executing node for the named event.
+
Indicates that events listed in the Successor/Predecessor
(RELEASEn) fields of the same record are successors.
-
Indicates that events listed in the Successor/Predecessor
(RELEASEn) fields of the same record are predecessors.
=
Defines a conditional predecessor relationship for the
events listed in the Successor/Predecessor (RELEASEn)
fields. They become predecessors only if they are
already on the current schedule when the primary event
(EVENTNM) is added.
EMAIL=
Specifies that this referback replaces completely, for this
job, any values that are specified on an @EMAIL= global
forward.
EMAIL+
Specifies to add the values specified in this keyword to
the values that are specified on the @EMAIL= global
forward. If no @EMAIL= was specified, only the values
in the EMAIL+ referback are used.
FLOWSTART=
Specifies the names of CPM (Critical Path Monitoring)
flows for which this event is the starting point.
FLOWEND=
Specifies the names of CPM (Critical Path Monitoring)
flows for which this event is the ending point.
PRIORITY=
Specifies the priority for each job submitted. The priority
is used to control job submission by submitting jobs with
the highest priority first. The value specified must be a
numeric value between 0 and 100. 0 is the highest
priority, and 100 is the lowest priority. If not specified,
the default is 100.
REPORT=
Allows the Unicenter Service Desk reporting to be turned
on or off for this job.
SCHENV=
This parameter is specified on the job definition and
applies to one specific job. This value takes precedence
over both the global startup parameter and the group
SCL parameter. NO can be specified for this value to
indicate no SCHENV= value be inserted on this job's
JOB statement. This parameter has no default. If not
found, the value is obtained from the @SCHENV= SCL
parameter or the SCHENV= startup parameter.
Successor/Predecessor
The following describes the Successor/Predecessor SCL field:
SCL Heading
RELEASEn
Columns
26 - 57
Description
Defines the successors, predecessors, alternate member name, and
environmental dependencies (see “Referback” on page 121) for the
event.
Process Period
The following describes the Process Period SCL field:
SCL Heading
PROCESSP
Columns
59 - 68
Description
Defines a finite period during which an event can be added to the
current schedule (see the process period keywords and the cyclic
process period keywords for possible entries later in this guide).
Conditional Operators
The following describes the Conditional Operators SCL field:
SCL Heading
O
Column
69
Description
Defines logical relationships among process periods of different SCL
records. Possible entries:
+
Establishes AND logical relationship within a continuation
record
/
Establishes OR logical relationship within a continuation
record
X
Establishes EXCEPT logical relationship within a
continuation record
R
Establishes REPLACE logical relationship with the
following SCL EVENT DEFINITION
Predecessor Count
The Predecessor Count (P) field should not be used or needed. This field is
used to support legacy schedules.
Location ID
The following describes the Location ID SCL field:
SCL Heading
LOC
Columns
76 - 78
Description
Defines a location ID to be assigned to the event. The entry must be
a three-digit number (000-254).
Version Number
The following describes the Version Number SCL field:
SCL Heading
VV
Columns
79 - 80
Description
Defines a specific version number to be assigned to the event. The
entry must be a two-digit number (01-99). Default is 01.
Keywords
These are the process period keywords.
+!eventname
Eligible only if the event specified is not on the current schedule.
+eventname
Eligible only if the event specified is on the current schedule.
{mm|**}/{dd|**}/{yy|**}
Eligible only on the specified absolute or generic date. Use the format
specified in your global options--American (mmddyy) or International
(ddmmyy).
Replace mm with a two-digit number (01-12) specifying a month. Replace
dd with a two-digit number (01-31) specifying a day of the month. Replace
yy with a two-digit number (00-99) specifying a year. Using ** (two
asterisks) in any part of the date creates a generic date.
Examples
2/2/6
(American) Eligible on February 20, 2006, only.
15//
(International) Eligible on the 15th day of any month during any year.
@!eventname
Eligible only if the event specified is not on the current schedule in a
noncompleted status.
@eventname
Eligible only if the event specified is on the current schedule in a
noncompleted status (that is, waiting, executing, and so on).
=MTWTFSS
Eligible for scheduling any day specified by the positional characters
M(onday), T(uesday), W(ednesday), T(hursday), F(riday), S(aturday), and
S(unday). Any day on which the event should not be scheduled must be
replaced by a . (period).
Examples
=M.W.F..
Eligible any Monday, Wednesday, or Friday.
=....F..
Eligible on Fridays only.
DAILY
Eligible for scheduling any day.
day#{nn|LAST}
Eligible on the nnth occurrence of the specified day during any month.
Replace nn with a number 01 through 05 (leading zeros can be omitted), or
use LAST to specify the last occurrence. Replace day with a day of the
week: MON, TUE, WED, THU, FRI, SAT, SUN.
Examples
MON#1
Eligible on the first Monday of any month.
THU#LAST
Eligible on the last Thursday of any month.
SUN#3
Eligible on the third Sunday of any month.
dayMn
Eligible on the specified occurrence, calculated from the end of the month,
of the specified day. Replace n with a number 1 through 5. Replace day
with a day of the week: MON, TUE, WED, THU, FRI, SAT, SUN.
Examples
MONM2
Eligible the second-to-last Monday of any month.
WEDM3
Eligible the third-to-last Wednesday of any month.
EOM
Eligible the last workday of any month.
EOY
Eligible the last workday of the year.
EVnday(x)
Eligible every nth weekday (day) of the year, starting with the xth
occurrence of the weekday. Replace n with a numeral 1-9. Replace day
with a day of the week: MON, TUE, WED, THU, FRI. Replace x with a
numeral 1-9.
Examples
EV3FRI(1)
Eligible every third Friday starting with the first Friday of the year.
EV5MON(5)
Eligible every fifth Monday starting with the fifth Monday of the year.
Note: You must adjust this process period every year.
FOM
Eligible the first workday of any month.
FRIDAY
Eligible on Fridays only.
LASTDAY
Eligible the last physical day of the month (including Saturdays and
Sundays).
MONDAY
Eligible on Mondays only.
QTRn
Eligible the first WORKDAY of the quarter specified by n. Replace n with a
number 1-4, where:
QTR1 is the quarter beginning the first WORKDAY in January
QTR2 is the quarter beginning the first WORKDAY in April
QTR3 is the quarter beginning the first WORKDAY in July
QTR4 is the quarter beginning the first WORKDAY in October
QTRnA
Eligible any day during the quarter specified by n. Replace n with a number
1-4, where:
QTR1A is the quarter beginning January 1.
QTR2A is the quarter beginning April 1.
QTR3A is the quarter beginning July 1.
QTR4A is the quarter beginning October 1.
SATURDAY
Eligible on Saturdays only.
SUNDAY
Eligible on Sundays only.
THURSDAY
Eligible on Thursdays only.
TUESDAY
Eligible on Tuesdays only.
UDEFx
Eligible on dates specified by the matching UDEFx parameter in the same
SCL member (where the character x in the process period keyword
matches the x in the parameter).
WEDNESDAY
Eligible on Wednesdays only.
WEEKDAY#L
Eligible the last workday of the week that is not a holiday. This process
period considers a workweek to be Monday through Friday. For workweeks
that include Saturday or Sunday, see the WEEKDAY#LW process period.
Usually this is going to be Friday. If Friday is a holiday, however, the last
workday of the week would be Thursday.
WEEKDAY#LW
Eligible the last workday of the week that is not a holiday. This process
period considers a workweek to be Monday through Sunday. For
workweeks that do not include Saturday or Sunday, see the WEEKDAY#L
process period.
Usually this is Sunday. If Sunday is a holiday, however, the last workday of
the week would be Saturday.
Note: If SAT and SUN are holidays (specified in SYS CYCS), SAT is
weekday 6, and SUN is weekday 7.
WEEKDAY#n
Eligible on the workday of the week specified by n (1-7). During a week
with no holidays, weekday 1 is Monday, 2 is Tuesday, 3 is Wednesday, 4 is
Thursday, 5 is Friday, 6 is Saturday, 7 is Sunday. During a week with a
holiday, weekday 1 is the first day that is not a holiday, 2 is the second day
that is not a holiday, and so on.
Example
WEEKDAY#4
Eligible any Thursday.
Note: If SAT and SUN are holidays (specified in SYS CYCS), SAT is
weekday 6, and SUN is weekday 7.
WEEKDAYXn
Eligible all workdays of the week except the numeric day of the week
specified by n (1-7). During a week with no holidays, weekday 1 is Monday,
2 is Tuesday, 3 is Wednesday, 4 is Thursday, 5 is Friday, 6 is Saturday, 7
is Sunday. During a week with a holiday, weekday 1 is the first day that is
not a holiday, 2 is the second day that is not a holiday, and so on.
Example
WEEKDAYX4
Eligible any day except weekday number 4. If no holidays occur during the
week, weekday 4 is Thursday and the event is eligible Monday, Tuesday,
Wednesday, and Friday. If, however, Tuesday were a holiday, weekday
number 4 would be Friday and the event would be eligible Monday,
Wednesday, and Thursday.
Note: If SAT and SUN are holidays (specified in SYS CYCS), SAT is
weekday 6, and SUN is weekday 7.
WEEKYR{>|<}nn
Eligible any day of any week of the year after (>) or before (<) the week
specified by nn (01-54). You can omit leading zeros.
Example
WEEKYR>5
Eligible any day of the last two weeks of the year starting on either JAN 1
or DEC 31.
WEEKYR#nn
Eligible any day during the week of the year specified by nn (01-54) starting
on JAN 1. You can omit leading zeros.
Example
WEEKYR#3
Eligible any day during the 3rd week of the year.
WEEKYRXnn
Eligible any day except during the week of the year specified by nn (01-54).
You can omit leading zeros.
Example
WEEKYRX2
Eligible any day of the year except during the 2nd week of the year starting
on JAN 1.
WORKDAY{>|<}nn
Eligible on any workday of the month after (>) or before (<) the workday
specified by nn (where nn is a two-digit number 01-31).
Example
WORKDAY>15
Eligible any workday after the 15th workday of the month.
WORKDAY#nn
Eligible on the nnth workday of any month (where nn is a two-digit number
01-31).
Examples
WORKDAY#2
Eligible on the 20th workday of any month (not the 20th day of the month,
since Saturdays, Sundays, and holidays are not workdays).
WORKDAY#3
Eligible on the third workday of any month.
WORKDAYMnn
Eligible on the nnth workday of the month, calculated from the end of the
month (where nn is a two-digit number 01-31).
Example
WORKDAYM5
Eligible the fifth-to-last workday of any month.
WORKDAYS
Eligible on any workday, excluding Saturdays, Sundays, and holidays.
WORKDAYXnn
Eligible on any workday (Monday through Friday, excluding holidays) except
the nnth workday of any month (where nn is a two-digit number 01-31).
Examples
WORKDAYX2
Eligible any day except the 20th workday of any month.
WORKDAYX3
Eligible any day except the third workday of any month.
Xday#{nn|LAST}
Eligible on any occurrence of the specified day during any month, except
for the nnth occurrence of the specified day. Replace nn with a number 01
through 05 for the weeks of the month, or use LAST to specify the last
occurrence. Replace day with a day of the week: MON, TUE, WED, THU,
FRI, SAT, SUN. You can omit leading zeros.
Examples
XMON#1
Eligible any Monday except the first Monday of any month.
XTHU#LAST
Eligible any Thursday except the last Thursday of any month.
XEOM
Eligible every workday except the last workday of any month.
XEOY
Eligible every workday except the last workday of the year.
XUDEFx
Not eligible on dates specified by the matching UDEFx parameter in the
same SCL member (where the character x in the process period keyword
matches the x in the parameter).
The SYS CYCS panel can hold a maximum of 105 cyclic calendars.
Each location can have a minimum of 2 dates spanning 254 days and a
maximum of 14 spanning a minimum of 2 days.
CYCDAY{>|<}nn
Eligible any workday of the cycle after (>) or before (<) the workday specified
by nn where nn is 01 to 99. You can omit leading zeros.
CYCDAY#nnn
Eligible on the nnnth workday of any processing cycle (where nnn is a
three-digit number 001-254).
Examples
This example displays what is eligible on the 10th day of processing cycles.
CYCDAY#1
This example displays what is eligible on the 150th day of processing cycles.
CYCDAY#15
CYCDAYMnnn
Eligible on the nnnth workday of the month, calculated from the end of the cycle
(where nnn is a three-digit number 001 through 254).
Examples
CYCDAYXnn
Eligible on any workday except the nnth workday of any processing cycle
(where nn is a two-digit number 01-99). You can omit leading zeros.
Examples
This example displays what is eligible any workday except the first workday of
processing cycles.
CYCDAYX1
This example displays what is eligible any workday except the 99th workday of
processing cycles.
CYCDAYX99
CYCLAST
Eligible on the last day of any cycle.
CYCLEnn
Eligible in the nnth cycle period. If nn has a leading zero, it can be omitted.
CYCLE01 through CYCLE14 or CYCLE1 through CYCLE14.
Example
Suppose you have the following cycle periods (cycles 5 to 12 are not shown).
CYCLE1 - 1/3 through 2/16
CYCLE2 - 2/17 through 3/9
CYCLE3 - 3/1 through 4/21
CYCLE4 - 4/22 through 5/4
CYCLE13 - 11/1 through 12/21
CYCLE14 - 12/22 through 1/2
March 12 falls in the third cycle period. If today is March 12 and you schedule
an event with a process period of CYCLE03 or CYCLE3, it would be scheduled
for today. CYCLE04 would not schedule for today.
dayCYC#{n|L}
Eligible on the nth occurrence of the specified day during any processing cycle.
Replace n with a number 1-5 (5 week cycle maximum), or use L to specify the
last occurrence. Replace day with a day of the week: MON, TUE, WED, THU,
FRI, SAT, SUN.
Examples
This example displays what is eligible on the third Monday of any processing
cycle.
MONCYC#3
This example displays what is eligible on the last Friday of any processing
cycle.
FRICYC#L
dayCYCMn
Eligible on the nth occurrence, calculated from the end of the cycle, of the
specified day. Replace n with a number 1-5 (5 week cycle maximum). Replace
day with a day of the week: MON, TUE, WED, THU, FRI, SAT, SUN.
Examples
WEEK#nn
Eligible any day during the week of a cycle specified by nn (01-37). You can
omit leading zeros.
Example
This example displays what is eligible any day during the 3rd week of the
current cycle.
WEEK#3 or WEEK#3
WEEKX{>|<}nn
Eligible any day of any week of a cycle following (>) or preceding (<) the week
specified by nn (01-37). You can omit leading zeros.
Example
This example displays what is eligible any day of the last two weeks of the
cycle.
WEEK>35
WEEKXnn
Eligible any day except during the week of a cycle specified by nn (01-37). You
can omit leading zeros.
Example
This example displays what is eligible any day of the year except during the
2nd week of the current cycle.
WEEKX2 or WEEKX2
XdayCYC#{n|L}
Eligible on any occurrence of the specified day during any processing period,
except for the nth occurrence of the specified day. Replace n with a number 1-5
(5 week cycle maximum), or use L to specify the last occurrence. Replace day
with a day of the week: MON, TUE, WED, THU, FRI, SAT, SUN.
Examples
This example displays what is eligible any Monday except the fourth Monday of
any processing cycle.
XMONCYC#4
This example displays what is eligible any Wednesday except the first
Wednesday of any processing cycle.
XWEDCYC#1
+TODAY
The +TODAY global control record initiates a test run of the schedule using the
specified date (Julian date, where yy is the year and ddd is the day of the year)
as the current date. An asterisk (*) in the Date (DATE) field indicates that you
want to use the current date for the test run. The test run allows schedule
testing and projections of scheduling action for the specified date. No physical
updates of the current schedule are made. Look at the output of the SCL to see
how the test worked.
──+TODAY=─┬─yyddd─┬─────────────────────────────────────────────────
└──────┘
@BUSGRP
The @BUSGRP global control record specifies that the business group name
assigned to subsequent events in the schedule is used until the next
@BUSGRP is found in the SCL member.
Note: For more information, see “BUSGRP Command” on page 22.
──@BUSGRP=name──────────────────────────────────────────────────────
@CYCnnn
The @CYCnnn global control record specifies that the non-default cyclic
calendar with ID nnn be used for events in the schedule that have no location
ID coded. This is used until the next @CYCnnn is found in the SCL member.
@CYCnnn=
The @CYCnnn= global control record defines each mmdd (date) to be the start
date of a processing cycle for events in the schedule having a location ID
matching the ID nnn. @CYCnnn only affects the selection of cyclic calendars.
It overrides, for cyclic calendars only, the location specified in a previous
@SETLOC. This location remains the default location for cyclic calendars until
the end of the SCL member is reached or until another @CYCnnn or
@SETLOC is found in the schedule.
┌─,──┐
mmdd┴───────────────────────────────────────────────────
──@CYCnnn=──
Example
@DATEFORM
The @DATEFORM global control record specifies the date format you want to
use. American (A) is in the form mmddyy. The International (I) is in the form
ddmmyy. The default is American (A).
┌─A─┐
──@DATEFORM=─┴─I─┴──────────────────────────────────────────────────
@EMAIL
The @EMAIL global control record specifies an email template that applies to
all jobs that follow.
┌─,──────────────┐
┬──────────────┬┴────────────────────────────
──@EMAIL=member/SCFRL──
└─member/SCFRL─┘
member
Indicates the email template member name.
SCFRL
Specifies event flags to indicate the events that will generate an email. You
can specify one or more of the following codes:
S
Job submit.
C
Job normal completion or purge.
F
Job failure due to abend, condition codes, or delete.
R
Normal completion of a rerun. Only valid if F is also specified.
L
Job is late submitting.
To stop the email information from applying to jobs, specify the following:
@EMAIL=
This prevents the email assignment for those jobs that follow this statement.
@FLOWnn
The @FLOWnn global control record associates events in a schedule with a
CPM (Critical Path Monitoring) flow name. The @FLOWnn= keywords can be
specified to define the flow name that should be added to the event's
checkpoint records. Events with a flow name have CAIENF events issued to
report the job status to the CPM monitor.
┌─,──────────┐
┬──────────┬┴───────────────────────────────────────────
──@FLOWnn=──
└─flowname─┘
@HOLnnn
The @HOLnnn global control record specifies that the non-default holiday
calendar with ID nnn be used for events in the schedule that have no location
ID coded. nnn is a three-digit location ID.
@HOLnnn=
The @HOLnnn= global control record defines each mmdd (date) to be a
holiday for events in the schedule having a coded location ID matching the ID
nnn. @HOLnnn only affects the selection of holiday calendars. It overrides, for
holiday calendars only, the location specified in a previous @SETLOC. This
location remains the default location for holiday calendars until the end of the
SCL member is reached or until another @HOLnnn or @SETLOC is found in
the schedule.
┌─,──┐
mmdd┴───────────────────────────────────────────────────
──@HOLnnn=──
Example
@HOL=11,22,33,44,55,66,77,88,99,11,1111,1212,1225,1228
Note: Commas must separate mmdd, and only 14 are allowed per location.
@INITIMOD
The @INITIMOD global control record specifies that subsequent events should
(=YES) or should not (=NO) use the global initiation IMOD. To use this feature,
see DYNAMLOC in the Planning and Implementation Guide.
┌─YES─┐
──@INITIMOD=─┴─NO──┴────────────────────────────────────────────────
@PRIORITY
The @PRIORITY global control record specifies the priority for each job that
follows this statement. The priority is used to control job submission by
submitting jobs with the highest priority first. The value specified must be a
numeric value between 0 and 100. 0 is the highest priority, and 100 is the
lowest priority.
┌─1─┐
──@PRIORITY=─┴─nnn─┴────────────────────────────────────────────────
@REPORT=
The @REPORT= global control record allows the Unicenter Service Desk
reporting to be turned on or off for the group of jobs that follow this statement.
┌─NO──┐
──@REPORT=─┴─YES─┴──────────────────────────────────────────────────
To stop the Report option from applying to jobs, specify the following:
@REPORT=
This prevents the assignment for those jobs that follow this statement. If no
keyword is specified, or @REPORT= is specified without a value, the global
initialization parameter REPORT=YES|NO determines the setting on this option.
@RERUN
The @RERUN global control record defines the date (Julian date, where yy is
the year and ddd is the numerical day of the year) to be used as the current
date for a rerun of the schedule.
──@RERUN=yyddd──────────────────────────────────────────────────────
@SCHENV
The @SCHENV global control record specifies the value to be inserted on the
SCHENV= JOB statement parameter for a job or a group of jobs and takes
precedence over the SCHENV= startup parameter. The value specified applies
until a new value is specified or until a null value is specified. NO can be
specified to disallow insertion of the SCHENV= parameter on the JOB
statement for the job or group of jobs. This parameter has no default. If this
parameter is omitted, the value specified on the SCHENV= startup parameter
will be used. Before using this feature, see the chapter "Using the IBM
Workload Management (WLM) Scheduling" in the Extended Scheduling
Services Guide.
@SETLOC
The @SETLOC global control record specifies that the location ID nnn be
assigned to subsequent events in the schedule. @SETLOC sets the location
for all functions, including calendar selection. An @SETLOC overrides any
@HOLnnn or @CYCnnn that precedes it. This location remains the default
location until the end of the SCL member is reached or until another @SETLOC
is found in the schedule.
──@SETLOC=nnn───────────────────────────────────────────────────────
@TODAY
The @TODAY global control record forces the calendar resolution to the date
defined by yyddd (Julian date, where yy is the year and ddd is the numerical
day of the year). Events are added to the current schedule as if the date
specified were the current date.
──@TODAY=yyddd──────────────────────────────────────────────────────
@TRACE
The @TRACE global control record displays hexadecimal representation of
schedule records from the checkpoint. This record is used for diagnostic
purposes only.
@WDnnn
The @WDnnn global control record overrides the location zero workday
calculations. Use it to add Saturday or Sunday or both to locations other than
zero. Replace nnn with the location ID of the location you want to affect.
──@WDnnn=─┬─SAT────┬────────────────────────────────────────────────
├─SUN────┤
├─SATSUN─┤
└─MTWTF──┘
@WORKD
The @WORKD global control record resets the workdays parameter for location
000 to include Saturday (@WORKD=SAT), Sunday (@WORKD=SUN), or
Saturday and Sunday (@WORKD=SATSUN), or returns the workdays
parameter to Monday through Friday (@WORKD=MTWTF).
──@WORKD=─┬─SAT────┬────────────────────────────────────────────────
├─SUN────┤
├─SATSUN─┤
└─MTWTF──┘
UDEFn
The UDEFn global control record defines unique process period dates for
events having process period keyword UDEFn (where n in the process period
keyword matches the n in this parameter). Replace mmdd with the date to be
defined as the process period. Replace processp with the name you want to
assign to the process period.
┌─,───────────┐
mmdd=processp┴────────────────────────────────────────────
──UDEFn=──