Você está na página 1de 174

CA Jobtrac Job Management

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.

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, LOST INVESTMENT,
BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED
OF SUCH LOSS OR DAMAGE.

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.

The manufacturer of this Documentation is CA.

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.

Copyright © 2006 CA. All rights reserved.


CA Product References
This document references the following CA products:
■ CA Jobtrac™ Job Management (CA Jobtrac JM)
■ CA 7® Workload Automation (CA 7)
■ CA 11™ Restart and Tracking (CA 11)
■ CA ACF2™ Security (CA ACF2)
■ CA AutoSys® Workload Automation (CA AutoSys WA)
■ CA Datacom®/DB Database (CA Datacom/DB)
■ CA Easytrieve® Report Generator (CA Easytrieve)
■ CA Examine™ Auditing (CA Examine)
■ CA Librarian® (CA Librarian)
■ CA MIA Message Sharing (CA MIC)
■ CA MIA Tape Sharing (CA MIA)
■ CA MII Data Sharing (CA MII)
■ CA MIM Resource Sharing (CA MIM)
■ CA Network and Systems Management Job Management Option (CA
NSM JM Option)
■ CA OPS/MVS® Event Management and Automation (CA OPS/MVS)
■ CA Panvalet® (CA Panvalet)
■ CA Scheduler® Job Management (CA Scheduler)
■ CA Spool™ Print Management (CA Spool)
■ CA SYSVIEW® Realtime Perfomance Management (CA SYSVIEW)
■ CA Top Secret® Security (CA Top Secret)
■ CA Universal Job Management Agent (CA Universal Job Management
Agent)
■ CA View® Output Archival and Viewing (CA View)

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

Chapter 2. Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . 101

Chapter 3. SCL (Schedule Control Language) . . . . . . . . . . . . . . 107


Record Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Event Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Holiday Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Event Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Execution Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Referback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Successor/Predecessor . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Process Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Conditional Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Predecessor Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Data Set Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Maximum Condition Code . . . . . . . . . . . . . . . . . . . . . . . . . 119
Location ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Version Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Chapter 4. Process Period Keywords . . . . . . . . . . . . . . . . . . . 121


Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Chapter 5. Cyclic Process Period Keywords . . . . . . . . . . . . . . . 129


CYCDAY{>|<}nn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
CYCDAY#nnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
CYCDAYMnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
CYCDAYXnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
CYCLAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
CYCLEnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
dayCYC#{n|L} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
dayCYCMn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
WEEK#nn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
WEEKX{>|<}nn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
WEEKXnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
XdayCYC#{n|L} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Chapter 6. SCL Global Control Records . . . . . . . . . . . . . . . . . . 143


+TODAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
@BUSGRP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
@CYCnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
@CYCnnn= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
@DATEFORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
@EMAIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
@FLOWnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
@HOLnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

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

Chapter 7. Dependency Code Descriptions . . . . . . . . . . . . . . . . 165

viii Reference Summary


Chapter 1. Primary Commands
The following chapter describes the top line (command line) CA Jobtrac™ Job
Management (CA Jobtrac JM) commands available on various product panels.

Chapter 1. Primary Commands 1


Prefix Command

Prefix Command
The prefix command displays the Scheduled Event Display panel listing all
events beginning with prefix.

This command has the following format:


──prefix────────────────────────────────────────────────────────────

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command has the following format:


──A=─┬─abend─┬──────────────────────────────────────────────────────
├─CC────┤
├─CAT───┤
├─S─────┤
└─U─────┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Examples

This example lists all events with abend code SD37.


A=SD37

This example lists all events with catalog checks.


A=CAT

This example lists all events with condition code checks.


A=CC

This example lists all events with system abends.


A=S

Lists all events with user abends.


A=U

Chapter 1. Primary Commands 3


ADD Command

ADD Command
The ADD command displays the Event/Jobstream Addition panel.

This command has the following format:


──┬─A───┬───────────────────────────────────────────────────────────
└─ADD─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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).

This command has the following format:


──ADD──┬─────────────────┬──┬─────┬──┬────────┬──┬──────────┬────────
└──┬─eventname─┬──┘ └─.vv─┘ └─,L=nnn─┘ └─,─┬─C─┬──┘
├─ sclname──┤ ├─D─┤
└─ tasknm───┘ └─E─┘
──┬─────────────┬──┬──────────────────────────────┬──────────────────
└─,N=nodename─┘ └─,A=─┬─command─────────────┬──┘
├─imod-arg────────────┤
└─shellscriptname.arg─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Examples

This example adds PRODJOB1 to current schedule.


ADD PRODJOB1

This example adds PRODJOB1 to current schedule with location ID 002.


ADD PRODJOB1,L= 2

This example adds Version 5 of PRODJOB1 to current schedule with location


ID 002.
ADD PRODJOB1. 5,L= 2

Chapter 1. Primary Commands 5


ADDLOC= Command

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.

This command has the following format:


──ADDLOC=nnn────────────────────────────────────────────────────────

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail

For editing the ADR tables, see “JTS Command” on page 51.

Chapter 1. Primary Commands 7


AMR Command

AMR Command
The AMR command displays the active AMR (Automatic Message Recognition)
table.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail

Chapter 1. Primary Commands 9


AUDIT Command

AUDIT Command
The AUDIT command displays the Change Audit History panel for events. The
panel displays information about changes made to an event.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Business Group Status
■ Scheduled Event Display
■ Scheduled Event Network
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

For more information, see “I Command” on page 43.

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.

This command has the following format:


──AUTH──┬────────────────┬──────────────────────────────────────────
└─=─┬─userid──┬──┘
└─prefix─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Authorization Profile

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

Chapter 1. Primary Commands 11


B= Command

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.

This command has the following format:


──B=─┬─bgname──┬────────────────────────────────────────────────────
└─prefix─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Example

This example lists events assigned business group name ACCTING.


B=ACCTING

For more information, see “BUSGRP Command” on page 14.

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.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

Chapter 1. Primary Commands 13


BUSGRP Command

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

For more information, see “B= Command” on page 12.

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.

This command is used on all edit or display panels.

Chapter 1. Primary Commands 15


CC Command

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.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

16 Reference Summary
CCPF Command

CCPF Command
The CCPF command displays the active CCPF (Condition Code Program Filter)
table.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

For editing the CCPF tables, see “JTS Command” on page 51.

Chapter 1. Primary Commands 17


CPM Command

CPM Command
The CPM command displays the CA Critical Path Monitor panels.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display

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.

This command has the following format:


──D──┬─────────┬────────────────────────────────────────────────────
├─command─┤
└─OFF─────┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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

This example resets the default command.


D OFF

Chapter 1. Primary Commands 19


D= Command

D= Command
The D= command displays Scheduled Event Display panel listing all events with
specified dependency or dependencies.

This command has the following format:


──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.

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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

Chapter 1. Primary Commands 21


DATES Command

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.

This command has the following format:


┌─PRODDATE─┐
──DATES──┼──────────┼───────────────────────────────────────────────
├─mbrname──┤
├─JMFSYM 1─┤
└─EXCLPARM─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command has the following format:


──DATE=─┬─dd────────┬───────────────────────────────────────────────
├─mmdd──────┤
├─ddmm──────┤
├─mmdd-mmdd─┤
├─ddmm-ddmm─┤
└─ALL───────┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Examples

This example lists events with target dates on the fourth day of any month.
DATE= 4

This example lists events with target date of April 11 only.


DATE= 411

This example lists events with target dates from April 11 through April 15.
DATE= 411- 415

Chapter 1. Primary Commands 23


DELETE Command

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.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail

24 Reference Summary
DOC or DOCEDIT Command

DOC or DOCEDIT Command


The DOC command displays documentation members for viewing.

The DOCEDIT command displays documentation members for editing.

If eventname is used, the specified event's documentation member is displayed.


If * is used with a prefix (partial event name), a list is displayed listing all the
documentation members whose names start with the prefix. Use * without a
prefix to display a listing of all the documentation members. Select a name from
the list. Optionally, you can specify a documentation library using the nnn
parameter where nnn is the location ID. The location ID parameter (nnn) allows
you to access multiple documentation libraries. Also see “? or ?EDIT
Command” on page 95.

The commands have the following format:


┌─ ─────────┐
───┬─DOC─────┬──┼───────────┼──┬─────┬──────────────────────────────
└─DOCEDIT─┘ ├─eventname─┤ └─nnn─┘
└─prefix───┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail
■ NJE Execution Detail

Chapter 1. Primary Commands 25


DSNQ= 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.

This command has the following format:


──DSNQ=─┬─dsname─┬──────────────────────────────────────────────────
└─prefix─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Enqueue Research

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.

This command has the following format:


──DTFMT=─┬─A─┬──────────────────────────────────────────────────────
└─I─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Cyclic Calendar
■ Holiday Calendar

This command updates your CA Jobtrac JM TSO profile.

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.

Chapter 1. Primary Commands 27


EDEP Command

EDEP Command
The EDEP command displays the Environmental Dependencies panel for a
specific event that shows the environmental dependencies for an event.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

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.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

Chapter 1. Primary Commands 29


EMAIL Command

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.

This command has the following format:


──EMAIL─┬─member──┬─,─┬────┬─nnn────────────────────────────────────
├─prefix─┤ └─L=─┘
└─ ───────┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Detail
■ Scheduled Event Display
■ Event Execution Detail

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.

This command has the following format:


──EMAILLST──────────────────────────────────────────────────────────

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail

Chapter 1. Primary Commands 31


ENDSAVE Command

ENDSAVE Command
The ENDSAVE command exits from a panel and saves any changes you have
made.

This command is used on the following panels:


■ ADR Table (in EDIT mode only)
■ AMR Table (in EDIT mode only)
■ CCPF Table (in EDIT mode only)
■ SCS Table (in EDIT mode only)
■ Cyclic Calendar
■ Holiday Calendar
■ Scheduled Event Detail
■ Event Execution Detail
■ Event/Jobstream Addition
■ GSO panels

32 Reference Summary
ENQ Command

ENQ Command
The ENQ command displays the Enqueue Research panel.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Enqueue Research

Chapter 1. Primary Commands 33


ENQN= Command

ENQN= Command
The ENQN= command displays enqueue activity for the QNAME specified by
enqname.

This command has the following format:


──ENQN=enqname──────────────────────────────────────────────────────

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Enqueue Research

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.

This command has the following format:


──EXCLUDE─┬─P────────────┬──────────────────────────────────────────
├─PREDECESSORS─┤
├─S────────────┤
└─SUCCESSORS───┘

This command is used on the Missing Events panel.

Chapter 1. Primary Commands 35


FIND Command

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.

This command has the following format:


┌─—───────────────┐ ┌─NEXT──┐
┬───────────────┬┴──┼───────┼────────────────────
──FIND──'string'───
└─'column-name'─┘ ├─ALL───┤
├─FIRST─┤
└─LAST──┘

This command is used on the following panels:


■ ADR Table and ADR Table List
■ AMR Table and AMR Table List
■ Business Group Status
■ CCPF Table and CCPF Table List
■ Change Audit History and Cross Node Query
■ Event History Display and Event Resource Profile
■ Holiday Calendar and Cyclic Calendar
■ Missing Events
■ IPL History
■ Scheduled Event Display and Network
■ SCS Table and SCS Table List
■ Sysout Capture and Volume Pull List
■ DASD Selection List and VTOC
■ Global Resource Definitions

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.

Chapter 1. Primary Commands 37


FSWAP Command

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.

| This command is affected by the JOBTRA00 keyword EXPFCAST value.


| Depending on the setting, the token can be a single character or a 1-3 digit
| number.
| Note: For more information about forecasting and the forecast token, see the
| Schedule Creation Guide.

This command has the following format:


──FSWAP─┬─token─┬───────┬──┬────────────────────────────────────────
│ └─,dbid─┘ │
└─PROD─────────────┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display

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.

This command has the following format:


┌─ ───────┐
──GSO─┼─────────┼──┬─────┬──────────────────────────────────────────
├─memname─┤ └─nnn─┘
└─prefix─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

Example

This example displays the schedule WEEKSCD from your default SCL library.
GSO WEEKSCD

Chapter 1. Primary Commands 39


HIST Command

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.

This command has the following format:


───┬─H────┬──┬─eventname─┬──────────────────────────────────────────
└─HIST─┘ ├─prefix───┤
└─ ─────────┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail

40 Reference Summary
HOMELOC= Command

HOMELOC= Command
The HOMELOC= command changes or sets your default location where nnn is
the location ID.

This command has the following format:


──HOMELOC=nnn───────────────────────────────────────────────────────

Note: To change the default location, see “PROFILE Command” on page 63.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

This command updates your CA Jobtrac JM TSO profile.

Chapter 1. Primary Commands 41


HST Command

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.

This command is used on the CA-Jobtrac primary panel.

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

Chapter 1. Primary Commands 43


IPLS Command

IPLS Command
The IPLS command displays the IPL History panel.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 45


J= Command

J= Command
The J= command displays the Scheduled Event Display panel listing all events
beginning with prefix.

This command has the following format:


──J=prefix──────────────────────────────────────────────────────────

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command has the following format:


┌─ ─────────┐
──JCL─┼───────────┼──┬─────┬────────────────────────────────────────
├─eventname─┤ └─nnn─┘
└─prefix───┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

Chapter 1. Primary Commands 47


JCLTRAC Command

JCLTRAC Command
The JCLTRAC command accesses the CA-JCLTrac primary options panel to
update options and to generate reports.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Or, this command invokes the JCL ANALYZER that syntax checks the JCL
member.

This command is used on the following panels:


■ Edit Production JCL
■ Edit Temporary JCL

For more information, see “RESET Command” on page 68.

48 Reference Summary
JMF Command

JMF Command
The JMF command invokes EDIT on the JMFSYM01 member of the CA
Jobtrac JM DD DATEFILE library.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 49


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.

This command has the following format:


──JOBQ=─┬─eventname─┬───────────────────────────────────────────────
└─prefix───┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Enqueue Research

Example

If PRODJOB1 is executing, this example displays enqueue research for


PRODJOB1.
JOBQ=PRODJOB1

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)

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 51


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.

This command has the following format:


┌──
─────┐
┬───┬┴────────────────────────────────────────────────────────
──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.

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).

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Examples

This example lists all events with dependency codes.


K=D

This example lists all events awaiting restart, currently executing, or completed.
K=REC

Chapter 1. Primary Commands 53


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).

This command has the following format:


──L=nnn──┬───────────────┬──────────────────────────────────────────
└─,─┬─SHIFT1─┬──┘
├─SHIFT2─┤
└─SHIFT3─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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

MACT or MANUAL Command


The MACT or MANUAL commands display the Manual Action Detail (check list)
panel for the selected event (if used). Next, remove the manual action so that
the event will execute.

This command is used on the Scheduled Event Detail panel.

Chapter 1. Primary Commands 55


MISSING Command

MISSING Command
The MISSING command displays the Missing Events panel. Also see
“EXCLUDE Command” on page 35.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command has the following format:


──N=nodename────────────────────────────────────────────────────────

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 57


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.

This command has the following format:


───┬─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 all sysout entries.


O

This example displays sysout entries for TESTJOB1.


O TESTJOB1

This example displays deleted sysout entries for any event beginning with
TEST.
O TEST,D

58 Reference Summary
O or OUT Command

Restoring Deleted Sysout Entries to the Sysout Capture Panel: After a


sysout entry is deleted and before the archive task removes the sysouts from
the online capture database, you can restore the entry to the Sysout Capture
panel. Use the following steps to restore deleted sysouts. You cannot restore
sysouts while sysout archival is underway.
1. Redisplay the deleted sysout entry you want to restore to the Sysout
Capture panel.
2. Enter U (undelete) in the field to the left of the entry you want to restore.
3. Press Enter to restore the entry to the Sysout Capture panel.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail
■ NJE Execution Detail

Chapter 1. Primary Commands 59


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.

This command has the following format:


──PARMS──┬─────────┬────────────────────────────────────────────────
└─memname─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

The Remote System Credentials pop-up panel is used with cross-platform


events (event type C) to specify the user ID, domain (used by Windows
security), and password to be used for the remote submission.

This command is used on the following panels:


■ Event Execution Detail (as PASSWORD)
■ Scheduled Event Detail (as PASSWORD)
■ Scheduled Event Display (as PASSWORD eventname)

Chapter 1. Primary Commands 61


PP= Command

PP= Command
The PP= command displays a Scheduled Event Display panel listing events
scheduled for the process period specified by procprd.

This command has the following format:


──PP=procprd────────────────────────────────────────────────────────

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail

Chapter 1. Primary Commands 63


PURGE Command

PURGE Command
The PURGE command purges the selected event from the current schedule.

If the event is awaiting execution, this issues a $PJnnnn command.

If the event is awaiting submission, all successors are released from


dependence on the event.

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.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail

64 Reference Summary
RALL Command

RALL Command
The RALL command displays all events on the current schedule. Also see “D
Command” on page 19.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 65


RELEASE Command

RELEASE Command
The RELEASE command releases dependencies.

If an event is awaiting submission, removes all dependencies except abend


bypass (A) and predecessor (P).

If an event is awaiting execution, CA Jobtrac JM issues the $AJnnnn command.

If an event is completed, CA Jobtrac JM removes output release (O)


dependency.

Also see the A line command in Chapter 2, “Line Commands” on page 101.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail

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.

This command has the following format:


──REMLOC=nnn────────────────────────────────────────────────────────

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

Chapter 1. Primary Commands 67


RESET Command

RESET Command
The RESET command refreshes the current panel's display.

This command has the following format:


──┬─R─────┬─────────────────────────────────────────────────────────
└─RESET─┘

This command is used on the following panels:


■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ ADR Table List
■ AMR Table List
■ CCPF Table List
■ SCS Table List
■ Missing Events
■ Edit Production JCL
■ Edit Temporary JCL

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.

This command is used on the Scheduled Event Detail panel.

For more information, see “@RES Command” on page 99.

Chapter 1. Primary Commands 69


RESV Command

RESV Command
The RESV command displays a list of any current DASD reserves in effect.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Enqueue Research

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.

This command is used on the NJE Execution Detail panel.

Chapter 1. Primary Commands 71


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.

This command is used on the Scheduled Event Detail panel.

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).

This command has the following format:


──RUN──┬─────────────────┬──┬─────┬──┬────────┬──┬──────────┬────────
└──┬─eventname─┬──┘ └─.vv─┘ └─,L=nnn─┘ └─,─┬─C─┬──┘
├─ sclname──┤ ├─D─┤
└─ tasknm───┘ └─E─┘
──┬─────────────┬──┬──────────────────────────────┬──────────────────
└─,N=nodename─┘ └─,A=─┬─command─────────────┬──┘
├─imod-arg────────────┤
└─shellscriptname.arg─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 73


RUN Command

Examples

This example adds PRODJOB1 to the current schedule for immediate


submission.
RUN PRODJOB1

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.

This command has the following format:


──S──eventname──────────────────────────────────────────────────────

This command is used on the following panels:


■ Scheduled Event Display
■ Scheduled Event Network

Example

This example displays a Scheduled Event Detail panel for PRODJOB1. If


PRODJOB1 has already been submitted, an Event Execution Detail panel.
S PRODJOB1

Chapter 1. Primary Commands 75


SAR Command

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail
■ NJE Execution Detail

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 77


SAVE Command

SAVE Command
The SAVE command saves any changes you have made to an event from a
panel.

This command is used on the following panels:


■ Scheduled Event Detail
■ Event Execution Detail
■ Edit Production JCL
■ Edit Temporary JCL

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.

This command has the following format:


┌─ ────────┐
──SCL──┼──────────┼──┬─────┬────────────────────────────────────────
├─memname──┤ └─nnn─┘
├─memname─┤
└─prefix──┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail

Example

This example displays the schedule WEEKSCD from your default SCL library.
SCL WEEKSCD

Chapter 1. Primary Commands 79


SCS Command

SCS Command
The SCS command displays the active System Command Scheduling table.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command has the following format:


──┬─SHIFT1─┬────────────────────────────────────────────────────────
├─SHIFT2─┤
└─SHIFT3─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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

Chapter 1. Primary Commands 81


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.

This command has the following format:


┌─—───────────────┐
┬───────────────┬┴──┬───┬──────────────────────────────────
──SORT───
└─'column-name'─┘ ├─A─┤
└─D─┘

This command is used on the following panels:


■ ADR Table and ADR Table List
■ AMR Table and AMR Table List
■ Business Group Status
■ CCPF Table and CCPF Table List
■ Change Audit History and Cross Node Query
■ Event History Display and Event Resource Profile
■ Global Resource Definitions
■ Holiday Calendar and Cyclic Calendar
■ IPL History
■ Scheduled Event Display and Network
■ SCS Table and SCS Table List
■ Sysout Capture
■ Volume Pull List
■ DASD Selection List and VTOC

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 83


STATUS Command

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

84 Reference Summary
SYS CYCS Command

SYS CYCS Command


The SYS CYCS command displays in edit mode the Cyclic Calendars panel,
which shows definitions for cyclic periods for each location.

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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 85


SYS HOLS Command

SYS HOLS Command


The SYS HOLS command displays the Holiday Calendars panel, which shows
definitions of holidays for each location. Holiday calendars can hold up to 24
holidays. The default date for each new holiday calendar is 0230. This is not a
valid date.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

86 Reference Summary
SYS OPTS Command

SYS OPTS Command


The SYS OPTS command displays the Global Options Menu. Some of the
values are read-only, and some can be updated. If you make a change and
save the change with PF3, this will update the system options.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 87


SYS USER Command

SYS USER Command


The SYS USER command displays the User Options panel, where you can
redefine PF key functions and time ranges for the SHIFT command. This panel
also displays the current display date parameter. Also see “SHIFT Command”
on page 81.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command has the following format:


──T=hh─┬─────────┬──────────────────────────────────────────────────
└─mm-hhmm─┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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

Chapter 1. Primary Commands 89


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 89.

This command is used on the Scheduled Event Detail panel.

90 Reference Summary
VER Command

VER Command
The VER command displays the version number of your CA Jobtrac JM.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Detail

Chapter 1. Primary Commands 91


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.

This command is used on the Scheduled Event Detail panel.

92 Reference Summary
WAIT Command

WAIT Command
The WAIT command displays enqueue conflicts.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Enqueue Research

Chapter 1. Primary Commands 93


XNODE Command

XNODE Command
The XNODE command displays the Cross Node Query-Criteria Selection panel.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

94 Reference Summary
? or ?EDIT Command

? or ?EDIT Command
The ? command displays documentation members for viewing.

The ?EDIT command displays documentation members for editing.

If eventname is used, the specified event's documentation member is displayed.


If * is used with a prefix (partial event name), a list is displayed listing all the
documentation members whose names start with the prefix. Use * without a
prefix to display a listing of all the documentation members. Select a name from
the list. Optionally, you can specify a documentation library using the nnn
parameter where nnn is the location ID. The location ID parameter (nnn) allows
you to access multiple documentation libraries. Also see “DOC or DOCEDIT
Command” on page 25.

The ? or ?EDIT commands have the following format:


──┬─?─────┬──┬─────────────────┬──┬─────┬───────────────────────────
└─?EDIT─┘ │ ┌─ ─────────┐ │ └─nnn─┘
└──┼─eventname─┼──┘
└─prefix───┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status
■ Scheduled Event Detail
■ Event Execution Detail
■ Event History Detail
■ NJE Execution Detail

Chapter 1. Primary Commands 95


@HOLD Command

@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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

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.

This command has the following format:


──@INT──┬───────────┬───────────────────────────────────────────────
│ ┌─5──┐ │
└─=─┴─nn─┴──┘

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 97


@REL 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.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

98 Reference Summary
@RES Command

@RES Command
The @RES command displays the Global Resource Definitions panel. Also see
“RESOURCE Command” on page 69.

This command is used on the following panels:


■ CA-Jobtrac primary
■ Scheduled Event Display
■ Scheduled Event Network
■ Business Group Status

Chapter 1. Primary Commands 99


100 Reference Summary
Chapter 2. Line Commands
The following describes the line commands available on the Scheduled Event
Display and Scheduled Event Network panels. Line commands can be disabled
in CA Jobtrac JM with the startup option DISABLE. For more information, see
the Planning and Implementation Guide.
0
(Zero) Browse sysouts using CA View. The first time you issue this
command, CA View prompts you for a CA View high-level database name.
Enter the high-level index of the CA View database that 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.
A
Release dependencies. If an event is awaiting submission, removes all
dependencies except abend bypass (A) and predecessor (P). If an event is
awaiting execution, issues the $AJnnnn command. If an event is completed,
removes output release (O) dependency.
Equivalent to the RELEASE primary command.
B
Browse JCL/SCL/IMOD. Displays either the JCL or the SCL that will be
submitted 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. Display the IMOD Facility of CA-GSS if the event is a REXX
IMOD.
Equivalent to the BROWSE primary command.
C
Condition codes. Displays Condition Code Exceptions panel for the
selected event.
Equivalent to the CC primary command.
D
Delete event. Deletes the 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.
Equivalent to the DELETE primary command.

Chapter 2. Line Commands 101


E
Edit JCL/SCL/IMOD. Displays 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.
Equivalent to the EDIT primary command.
F
File triggers. Displays the ADR Table panel for the selected event. This
shows the file (data set name) trigger list for the selected name.
Not equivalent to a primary command.
G
Invoke GSO. Displays the GSO panels for this schedule.
Equivalent to the GSO primary command.
H
History. Displays the Event History Display panel of the selected event on
the history database.
Equivalent to the HIST primary command.
I
Inquiry. Displays the Change Audit History panel for the selected event.
Equivalent to the AUDIT primary command.
J
Edit temporary-use JCL. Displays the temporary-use JCL for an event for
editing if the event has not been submitted. If no temporary-use JCL exists
for the event, creates a member containing a copy of the event's production
JCL in the temporary-use JCL library for the event.
Equivalent to the TEMP primary command.
L
List dependent job stream. Displays the Scheduled Event Network panel
for the selected event. This lists the event's primary predecessor and
successor event network in primary execution sequence.
Not equivalent to a primary command.
M
Manual dependency. Displays the Manual Action Detail panel for the
selected event (if available).
Equivalent to the MANUAL or MACT primary command.
N
Enqueue research. Displays the CA-Jobtrac Enqueue Research panel.
Displays resources (data set names) for the selected event. The event must
be currently executing.
Equivalent to the ENQ primary command.

102 Reference Summary


O
Output. Displays the Sysout Capture panel or the actual sysouts for the
selected event.
Equivalent to the OUT primary command.
P
Purge event. Purges the selected event from the current schedule. If the
event is awaiting execution, this issues a $PJnnnn command. If the event is
awaiting submission, all successors are released from dependence on the
event. If you have CA 11, this command automatically changes the CA 11
status of the event to PRODUCTION.
Equivalent to the PURGE primary command.
Q
Display CA SYSVIEW Job Summary panel. Allows you to view a
selected event and to issue CA SYSVIEW commands. To exit from CA
SYSVIEW, enter PF03. You are returned to the panel from which you
issued the Q command. This command is only valid if you are a licensed
CA SYSVIEW user and if your TSO session has access to the CA
SYSVIEW ISPF program and its files.
Not equivalent to a primary command.
R
Rerun/Restart interface. With an automated restart system (such as CA
11), invokes the event restart interface, and schedules the event for rerun.
Without a restart system, schedules the event for rerun (completed or
history entries only). In any case, reassigns predecessor dependencies,
output release dependencies, and successor events as in the original run.
Removes environmental dependencies.
The REXX IMOD is scheduled for rerun without dependencies, but with a
JCL hold. REXX IMOD events use CA Jobtrac JM rerun/restart facility.
They cannot use an automated restart system.
Not equivalent to a primary command.
S
Select for detail display. Displays either the Scheduled Event Detail
panel (if the selected event is waiting submission), the Event Execution
Detail panel (if the event has been submitted), or the NJE Execution Detail
panel (if it is an NJE job).
Equivalent to the S primary command.

Chapter 2. Line Commands 103


T
Edit temporary-use JCL. Displays the temporary-use JCL for an event for
editing if the event has not been submitted. 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.
Equivalent to the TEMP primary command.
V
Volume Pull List. Executes CA-JCLTrac to create a Volume Pull List
panel from a real-time look at the JCL.
The V line command is ignored if issued against schedule members,
IMODs, dummy jobs, or jobs in completed status.
If CA-JCLTrac encounters an error prior to JCL analysis, the message JCL
PROCESSING ERROR appears on the Scheduled Event Display panel. If a
JCL error occurs, the message will appear on the Volume Pull List panel.
In both cases, one or more CA-JCLTrac messages will be written to the
console describing the problem in more detail.
The Volume Pull List 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.
Equivalent to the VOLUME primary command.
X
Resource assignments. Displays the Resource Assignments panel for the
selected event. This shows definitions of resource dependencies for the
selected event.
Equivalent to the RESOURCE primary command.
Y
CPM Flow Information panel. Displays CPM flownames, start/end times,
and SLA.
Not equivalent to a primary command.
Z
Recapture Sysout. Requests the capture of sysout for an event.
Not equivalent to a primary command.
?
Documentation. Displays the selected event's documentation member.
Equivalent to the DOC, DOCEDIT, and ?EDIT primary commands.

104 Reference Summary


@
Submit command. Clears entry status and reuses entry for
resubmissions.
You can do this to any entry regardless of its current status. This does not
alter dependency codes.
You should use this command with CAUTION.
Note: You can use the DISABLE startup option to remove this command.
%
EMAILLST command. Alters or displays the EMAIL template defined for a
job on the checkpoint.

Chapter 2. Line Commands 105


106 Reference Summary
Chapter 3. SCL (Schedule Control
Language)
The following topics explain SCL member's record formats and fields.

Chapter 3. SCL (Schedule Control Language) 107


Record Format

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.

1---+----1 ---+----2 ---+----3 ---+----4 ---+----5 ---+----6 ---+----7 ---+----8


EVENTNM TIME DATE DEPS RELEASE1RELEASE2RELEASE3RELEASE4 PROCESSP OPDCCDELOCVV

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.

108 Reference Summary


Record Format

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)

Chapter 3. SCL (Schedule Control Language) 109


Record Format

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.

110 Reference Summary


Record Format

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.

Chapter 3. SCL (Schedule Control Language) 111


Record Format

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.

112 Reference Summary


Record Format

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.

Chapter 3. SCL (Schedule Control Language) 113


Record Format

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.

114 Reference Summary


Record Format

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.

Chapter 3. SCL (Schedule Control Language) 115


Record Format

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.

116 Reference Summary


Record Format

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).

Chapter 3. SCL (Schedule Control Language) 117


Record Format

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.

Data Set Count


The following describes the Data Set Count SCL field:
SCL Heading
D
Column
71
Description
Defines the number of data sets that must be created to trigger the
event. The entry must be a single numeral (0-9).

118 Reference Summary


Record Format

Maximum Condition Code


The following describes the Maximum Condition Code SCL field:
SCL Heading
CCDE
Columns
72 - 75
Description
Defines the maximum condition code value allowed for any step in
the event. The entry must be a four-digit number (0000-4095). All
dummy job events are set to 0000. REXX IMOD events are set to
the code returned by the REXX IMOD.

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.

Chapter 3. SCL (Schedule Control Language) 119


120 Reference Summary
Chapter 4. Process Period Keywords
The process period for an event can use these keywords.

Chapter 4. Process Period Keywords 121


Keywords

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.

122 Reference Summary


Keywords

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.

Chapter 4. Process Period Keywords 123


Keywords

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.

124 Reference Summary


Keywords

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.

Chapter 4. Process Period Keywords 125


Keywords

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
WEEKYRX 2
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.

126 Reference Summary


Keywords

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
WORKDAYM 5
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.
WORKDAYX 3
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).

Chapter 4. Process Period Keywords 127


128 Reference Summary
Chapter 5. Cyclic Process Period
Keywords
This chapter discusses the cyclic process period keywords. For more
information on how to set up dates, see the chapter "Preparing to Create a
Schedule" in the Schedule Creation Guide.

Valid processing cycles span from 2-254 days.

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.

Chapter 5. Cyclic Process Period Keywords 129


CYCDAY{>|<}nn

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.

130 Reference Summary


CYCDAY#nnn

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

Chapter 5. Cyclic Process Period Keywords 131


CYCDAYMnnn

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

This example displays what is eligible on the 15th-to-last workday of processing


cycles.
CYCDAYM 15

This example displays what is eligible on the second-to-last workday of


processing cycles.
CYCDAYM 2

132 Reference Summary


CYCDAYXnn

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.
CYCDAYX 1

This example displays what is eligible any workday except the 99th workday of
processing cycles.
CYCDAYX99

Chapter 5. Cyclic Process Period Keywords 133


CYCLAST

CYCLAST
Eligible on the last day of any cycle.

134 Reference Summary


CYCLEnn

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.

Chapter 5. Cyclic Process Period Keywords 135


dayCYC#{n|L}

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

136 Reference Summary


dayCYCMn

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

This example displays what is eligible on the third-to-last Tuesday of any


processing cycle.
TUECYCM3

This example displays what is eligible on the second-to-last Thursday of any


processing cycle.
THUCYCM2

Chapter 5. Cyclic Process Period Keywords 137


WEEK#nn

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

138 Reference Summary


WEEKX{>|<}nn

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

Chapter 5. Cyclic Process Period Keywords 139


WEEKXnn

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.
WEEKX 2 or WEEKX2

140 Reference Summary


XdayCYC#{n|L}

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

Chapter 5. Cyclic Process Period Keywords 141


142 Reference Summary
Chapter 6. SCL Global Control Records
This chapter discusses SCL global control records.

Chapter 6. SCL Global Control Records 143


+TODAY

+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.

This record has the following format:


──+TODAY=─┬─yyddd─┬─────────────────────────────────────────────────
└─ ─────┘

144 Reference Summary


@BUSGRP

@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.

This record has the following format:


──@BUSGRP=name──────────────────────────────────────────────────────

Chapter 6. SCL Global Control Records 145


@CYCnnn

@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.

146 Reference Summary


@CYCnnn=

@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.

This record has the following format:


┌─,──┐
mmdd┴───────────────────────────────────────────────────
──@CYCnnn=──

Example

The @CYCnnn= overrides the SYS CYC's location cycles if defined.


@CYC = 1 1, 2 2, 3 3, 4 4, 5 5, 6 6, 7 7, 8 8, 9 9,1 1 ,1111,1212,1225,1228
Note: Commas must separate mmdd, and only 14 are allowed per location.

Chapter 6. SCL Global Control Records 147


@DATEFORM

@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).

This record has the following format:


┌─A─┐
──@DATEFORM=─┴─I─┴──────────────────────────────────────────────────

148 Reference Summary


@EMAIL

@EMAIL
The @EMAIL global control record specifies an email template that applies to
all jobs that follow.

This record has the following format:


┌─,──────────────┐
┬──────────────┬┴────────────────────────────
──@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.

You can define multiple member/SCFRL definitions with comma separation. As


many as can fit on an 80-character card image are accepted (five or more).

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.

Chapter 6. SCL Global Control Records 149


@FLOWnn

@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.

This record has the following format:


┌─,──────────┐
┬──────────┬┴───────────────────────────────────────────
──@FLOWnn=──
└─flowname─┘

150 Reference Summary


@HOLnnn

@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.

Chapter 6. SCL Global Control Records 151


@HOLnnn=

@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.

This record has the following format:


┌─,──┐
mmdd┴───────────────────────────────────────────────────
──@HOLnnn=──

Example
@HOL = 1 1, 2 2, 3 3, 4 4, 5 5, 6 6, 7 7, 8 8, 9 9,1 1 ,1111,1212,1225,1228
Note: Commas must separate mmdd, and only 14 are allowed per location.

The @HOLnnn= overrides the SYS HOL's location holidays if defined.

152 Reference Summary


@INITIMOD

@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.

This record has the following format:


┌─YES─┐
──@INITIMOD=─┴─NO──┴────────────────────────────────────────────────

Chapter 6. SCL Global Control Records 153


@PRIORITY

@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.

This record has the following format:


┌─1 ─┐
──@PRIORITY=─┴─nnn─┴────────────────────────────────────────────────

154 Reference Summary


@REPORT=

@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.

This record has the following format:


┌─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.

Chapter 6. SCL Global Control Records 155


@RERUN

@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.

This record has the following format:


──@RERUN=yyddd──────────────────────────────────────────────────────

156 Reference Summary


@SCHENV

@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.

Chapter 6. SCL Global Control Records 157


@SETLOC

@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.

This record has the following format:


──@SETLOC=nnn───────────────────────────────────────────────────────

158 Reference Summary


@TODAY

@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.

This record has the following format:


──@TODAY=yyddd──────────────────────────────────────────────────────

Chapter 6. SCL Global Control Records 159


@TRACE

@TRACE
The @TRACE global control record displays hexadecimal representation of
schedule records from the checkpoint. This record is used for diagnostic
purposes only.

160 Reference Summary


@WDnnn

@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.

This record has the following format:


──@WDnnn=─┬─SAT────┬────────────────────────────────────────────────
├─SUN────┤
├─SATSUN─┤
└─MTWTF──┘

Chapter 6. SCL Global Control Records 161


@WORKD

@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).

This record has the following format:


──@WORKD=─┬─SAT────┬────────────────────────────────────────────────
├─SUN────┤
├─SATSUN─┤
└─MTWTF──┘

162 Reference Summary


UDEFn

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.

This record has the following format:


┌─,───────────┐
mmdd=processp┴────────────────────────────────────────────
──UDEFn=──

Chapter 6. SCL Global Control Records 163


164 Reference Summary
Chapter 7. Dependency Code
Descriptions
The following are the CA Jobtrac JM dependency code descriptions:
A
Abend bypass. If an event with this code abends, the predecessor
dependency (code P) is removed from successors to the event. This does
not apply to condition code, catalog, or JCL errors.
D
Data set required dependency. One or more data sets must be supplied
before the event can execute.
E
Edit JCL dependency. The job's JCL must be edited before job is
submitted. The code must be removed manually after the JCL is edited.
H
Automatic hold dependency. The event is being held from submission
due to some type of threshold crossover. The Current Event Stat field on
the Scheduled Event Display panel can indicate the reason for the hold.
The code must be removed manually before the event can be submitted.
I
Environmental dependency. All environmental dependencies must
complete normally without abend before the event can be submitted.
J
JCL required dependency. JCL must be supplied or altered before the
event can execute. This code must be manually removed or JCL must be
externally submitted using the AUTO-SCHD feature.
JW
WLM resource dependency. The WLM resource specified for this event
must be valid and available before this event can execute. The code must
be removed manually after the WLM resource is verified and/or activated.
M
Manual release dependency. The code must be removed manually
before the event can be submitted. If the event has manual actions, they
must be performed before the event is submitted.
O
Output release dependency. This code indicates that the event output
should be checked after the event completes. No successors to the event
can run until the O code is manually removed.

Chapter 7. Dependency Code Descriptions 165


P
Predecessor event dependency. All predecessor events must complete
normally without abend and without exceeding the maximum allowable step
condition code before the event can be submitted.
Q
Queued release dependency. The event's JCL is to be submitted outside
of CA Jobtrac JM. Once JCL is submitted, the event is held in the JES
queue and released automatically by CA Jobtrac JM when remaining
dependencies are met. The Q entry is not valid for REXX IMOD and
dummy job events.
R
Resource dependency. Indicates that user-defined resource conditions
must be satisfied before the event can be submitted.
X
Mutual exclusion dependency. The event is defined to be mutually
exclusive with an event that is currently executing. When the executing
event completes, the code is removed by CA Jobtrac JM and the event is
eligible for submission.
*AUTO
AUTO-SCHD event. The event was submitted outside the control of CA
Jobtrac JM and therefore has no dependencies or overrides that can be
honored by CA Jobtrac JM.
?
View documentation dependency. Prevents submission of the event until
its documentation is viewed. The code must be removed manually after the
documentation is viewed.

166 Reference Summary

Você também pode gostar