Escolar Documentos
Profissional Documentos
Cultura Documentos
Reference Summary
r11 SP05
Third Edition
This documentation and any related computer software help programs (hereinafter referred to as the
“Documentation”) are for your informational purposes only and are 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 may not be used or disclosed by you except as may be permitted in a
separate confidentiality agreement between you and CA.
Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the
Documentation, you may print a reasonable number of copies of the documentation for internal use by
you and your employees in connection with that software, provided that all CA copyright notices and
legends are affixed to each reproduced copy.
The right to print copies of the Documentation is limited to the period during which the applicable
license for such software remains in full force and effect. Should the license terminate for any reason, it
is your responsibility to certify in writing to CA that all copies and partial copies of the Documentation
have been returned to CA or destroyed.
The use of any software product referenced in the Documentation is governed by the applicable license
agreement and is not modified in any way by the terms of this notice.
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.
iii
Contact CA
Contact Technical Support
For your convenience, CA provides one site where you can access the
information you need for your Home Office, Small Business, and Enterprise
CA products. At http://ca.com/support, you can access the following:
■ Online and telephone contact information for technical assistance and
customer services
■ Information about user communities and forums
■ Product and documentation downloads
■ CA Support policies and guidelines
■ Other helpful resources appropriate for your product
Provide Feedback
If you have comments or questions about CA product documentation, you
can send a message to techpubs@ca.com.
If you would like to provide feedback about CA product documentation,
complete our short customer survey, which is also available on the CA
Support website, found at http://ca.com/docs.
iv Reference Summary
Contents
Chapter 1. Primary Commands . . . . . . . . . . . . . . . . . . . . . . . . . 1
Prefix Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
A= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
ADD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
ADD parms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
ADDLOC= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
ADR Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
AMR Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
ARG Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
AUDIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
AUTH Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
B= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
BROWSE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
BUSGRP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
CANCEL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
CC Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
CCPF Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
CPM Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
D Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
D= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
DATES Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
DATE= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
DELETE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
DOC or DOCEDIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
DSNQ= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
DTFMT= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
EDEP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
EDIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
EMAIL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
EMAILLST Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
ENDSAVE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
ENQ Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
ENQN= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
EXCLUDE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
FIND Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
FORCE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
FSWAP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
GSO Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
HIST Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
HOMELOC= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
HST Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
I Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
IPLS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
ISERVE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
J= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Contents v
JCL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
JCLTRAC Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
JMF Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
JOBQ= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
JTS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
K= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
L= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
MACT or MANUAL Command . . . . . . . . . . . . . . . . . . . . . . . . . . 55
MISSING Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
N= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
O or OUT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
PARMS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
PASSWORD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
PP= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
PROFILE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
PURGE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
RALL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
RELEASE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
REMLOC= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
RESET Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
RESOURCE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
RESV Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
RETRY Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
RSRC Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
RUN Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
S Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
SAR Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
SARDB Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
SAVE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
SCL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
SCS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
SHIFT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
SORT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
SPACE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
STATUS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
SYS CYCS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
SYS HOLS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
SYS OPTS Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
SYS USER Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
T= Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
TEMP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
VER Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
VOLUME Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
WAIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
XNODE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
? or ?EDIT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
@HOLD Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
@INT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
@REL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
vi Reference Summary
@RES Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Contents vii
@HOLnnn= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
@INITIMOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
@PRIORITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
@REPORT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
@RERUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
@SCHENV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
@SETLOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
@TODAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
@TRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
@WDnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
@WORKD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
UDEFn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Prefix Command
The prefix command displays the Scheduled Event Display panel listing all
events beginning with prefix.
Example
This example displays all events whose names begin with TESTJ.
TESTJ
Note: All of the primary commands cannot be used as prefixes.
2 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.
Examples
ADD Command
The ADD command displays the Event/Jobstream Addition panel.
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 CA Jobtrac JM 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.
4 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).
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.
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.
6 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 51.
AMR Command
The AMR command displays the active AMR (Automatic Message Recognition)
table.
For editing the AMR tables, see “JTS Command” on page 51.
8 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.
10 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.
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.
Example
12 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.
14 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.
16 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 51.
CPM Command
The CPM command displays the CA Critical Path Monitor panels.
18 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 CA Jobtrac
JM is accessed or whenever D is entered.
Examples
This example defines the command K=LAW as the default command. K=LAW
is executed automatically when CA Jobtrac JM 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.
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.
20 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.
22 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 CA Jobtrac
JM.
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 CA
11, this command automatically changes the 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.
24 Reference Summary
DOC or DOCEDIT Command
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.
26 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.
Note: DTFMT affects only the CA Jobtrac JM-controlled dates. The current
date in the panel header is controlled by TSO/ISPF and is not affected by this
parameter. Also see the SYS OPTS date format option.
EDEP Command
The EDEP command displays the Environmental Dependencies panel for a
specific event that shows the environmental dependencies for an event.
28 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.
30 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.
ENDSAVE Command
The ENDSAVE command exits from a panel and saves any changes you have
made.
32 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.
34 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.
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.
Example
This example finds all the occurrences of EOM in the Event Name column on
the panel.
FIND EOM EVENT-NAME ALL
36 Reference Summary
FORCE Command
FORCE Command
The FORCE command allows jobs to be released when CA Jobtrac JM 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 CA Jobtrac JM 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 CA Support.
FSWAP Command
The FSWAP command changes the database and token that is being accessed
by the CA Jobtrac JM 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.
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. (JOBTRA00 keyword EXPFCAST=N)
| FSWAP A
| This example swaps to the forecast database for token 133. The database ID
| used is the default specified in the FCSTDBID keyword of the PPOPTION
| (JOBTRA00) member. (JOBTRA00 keyword EXPFCAST=Y)
| FSWAP 133
| This example swaps to the forecast database for token 5 for forecast database
| 0165. (JOBTRA00 keyword EXPFCAST=Y)
| FSWAP 5,165
This example swaps to the production database and token defined by the
JOBTRACx DD DUMMY.
FSWAP PROD
38 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.
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 CA Jobtrac JM to read the entire history database.
The response time for this command depends on the size of the history
database.
40 Reference Summary
HOMELOC= Command
HOMELOC= Command
The HOMELOC= command changes or sets your default location where nnn is
the location ID.
Note: To change the default location, see “PROFILE Command” on page 63.
HST Command
The HST command displays the Historical Summary panel. The panel displays
information about historical summary intervals and retentions about jobs
submitted and failed since the last interval. You can change the interval by
entering a new interval value and pressing Enter.
42 Reference Summary
I Command
I Command
The I command displays the Change Audit History panel for an event. The
panel displays information about changes made to an event.
IPLS Command
The IPLS command displays the IPL History panel.
44 Reference Summary
ISERVE Command
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.
J= Command
The J= command displays the Scheduled Event Display panel listing all events
beginning with prefix.
Example
This example produces a Scheduled Event Display panel listing all events
whose names begin with TESTJ.
J=TESTJ
46 Reference Summary
JCL Command
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.
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.
48 Reference Summary
JMF Command
JMF Command
The JMF command invokes EDIT on the JMFSYM01 member of the CA
Jobtrac JM DD DATEFILE library.
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.
Example
50 Reference Summary
JTS Command
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)
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.
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.
52 Reference Summary
K= Command
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 CA Jobtrac JM but have not
begun execution (awaiting an initiator).
Examples
This example lists all events awaiting restart, currently executing, or completed.
K=REC
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).
Example
This example displays all events in location 000 and the times in the SYS
USER panel for SHIFT3 times.
L=,SHIFT3
54 Reference Summary
MACT or MANUAL Command
MISSING Command
The MISSING command displays the Missing Events panel. Also see
“EXCLUDE Command” on page 35.
56 Reference Summary
N= Command
N= Command
The N= command displays a Scheduled Event Display panel listing any event
with a node parameter, including cross-platform jobs.
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.
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
58 Reference Summary
O or OUT 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.
60 Reference Summary
PASSWORD Command
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.
PP= Command
The PP= command displays a Scheduled Event Display panel listing events
scheduled for the process period specified by procprd.
Example
This example lists all events scheduled for process period TUESDAY.
PP=TUESDAY
62 Reference Summary
PROFILE Command
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 CA Jobtrac JM ISPF interface options, such as default location,
enabling prompts, default search command, date format, or the CA View
database name.
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 CA
11, this command automatically changes the CA 11 status of the event to
PRODUCTION. Also see the P line command in Chapter 2, “Line Commands”
on page 101.
64 Reference Summary
RALL Command
RALL Command
The RALL command displays all events on the current schedule. Also see “D
Command” on page 19.
RELEASE Command
The RELEASE command releases dependencies.
Also see the A line command in Chapter 2, “Line Commands” on page 101.
66 Reference Summary
REMLOC= Command
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.
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.
RESET Command
The RESET command refreshes the current panel's display.
68 Reference Summary
RESOURCE Command
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.
RESV Command
The RESV command displays a list of any current DASD reserves in effect.
70 Reference Summary
RETRY Command
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.
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.
72 Reference Summary
RUN 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 CA Jobtrac JM
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).
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
74 Reference Summary
S Command
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.
Example
SAR Command
The SAR command displays the CA-View Primary Selection panel. The first
time you issue this command, the CA View product prompts you for a high-level
database name. Enter the high-level index of the CA View database you want
to access. This name is saved in your CA Jobtrac JM user profile. The sysout
that you selected is displayed, and you can enter any CA View command you
want. For more information about CA View commands, see the CA View
documentation.
76 Reference Summary
SARDB Command
SARDB Command
The SARDB command changes the CA View database that CA Jobtrac JM
interfaces with. When you issue this command, CA View displays the CA View
Database Selection panel where you can specify a different high-level database
name. Enter the high-level index of the CA View database you want to access.
The new name is saved in your CA Jobtrac JM user profile.
SAVE Command
The SAVE command saves any changes you have made to an event from a
panel.
78 Reference Summary
SCL Command
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 101.
Example
This example displays the schedule WEEKSCD from your default SCL library.
SCL WEEKSCD
SCS Command
The SCS command displays the active System Command Scheduling table.
For editing the SCS tables, see “JTS Command” on page 51.
80 Reference Summary
SHIFT Command
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.
Note: For more information, see “SYS USER Command” on page 88 to set up
SHIFT1, 2, and 3 and “L= Command” on page 54.
Example
This example lists events with target submission times during the second shift.
SHIFT2
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.
Example
This example sorts the display in ascending order by the contents of the Status
column.
SORT CURRENT-STATUS
82 Reference Summary
SPACE Command
SPACE Command
The SPACE command displays an analysis of DASD (Direct Access Storage
Device) space.
STATUS Command
The STATUS command displays an analysis of component resource use on the
CA Jobtrac JM database and sysout capture file. Also displays version and
genlevel, token, and restage options.
84 Reference Summary
SYS CYCS Command
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.
86 Reference Summary
SYS OPTS Command
88 Reference Summary
T= 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.
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
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 89.
90 Reference Summary
VER Command
VER Command
The VER command displays the version number of your CA Jobtrac JM.
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.
92 Reference Summary
WAIT Command
WAIT Command
The WAIT command displays enqueue conflicts.
XNODE Command
The XNODE command displays the Cross Node Query-Criteria Selection panel.
94 Reference Summary
? or ?EDIT Command
? or ?EDIT Command
The ? command displays documentation members for viewing.
@HOLD Command
The @HOLD command puts CA Jobtrac JM on hold. Places message
SCHEDULE HELD in upper-right corner of the panel. Issues the TRAC111I
user HAS PLACED SCHEDULE ON HOLD console message.
96 Reference Summary
@INT Command
@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.
@REL Command
The @REL command releases CA Jobtrac JM if it were put on hold. Issues the
TRAC001I user HAS RELEASED SCHEDULE HOLD console message.
98 Reference Summary
@RES Command
@RES Command
The @RES command displays the Global Resource Definitions panel. Also see
“RESOURCE Command” on page 69.
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 CA Jobtrac JM, 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 CA 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 115) 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.
@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 14.
@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.
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).
@EMAIL
The @EMAIL global control record specifies an email template that applies to
all jobs that follow.
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.
@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.
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.
@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.
@REPORT=
The @REPORT= global control record allows the CA Service Desk reporting to
be turned on or off for the group of jobs that follow this statement.
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.
@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.
@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.
@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.
@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).
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.