Unicenter CA-Jobtrac Job

 

Management

Reference Summary
3.5 SP04

K00906-3E
This documentation and related computer software program (hereinafter referred to as the
“Documentation”) is for the end user's informational purposes only and is subject to change or
withdrawal by Computer Associates International, Inc. (“CA”) at any time.

This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or
in part, without the prior written consent of CA. This documentation is proprietary information of CA
and protected by the copyright laws of the United States and international treaties.

Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this
documentation for their own internal use, provided that all CA copyright notices and legends are
affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who
are bound by the confidentiality provisions of the license for the software are permitted to have access
to such copies.

This right to print copies is limited to the period during which the license for the product remains in
full force and effect. Should the license terminate for any reason, it shall be the user's responsibility to
return to CA the reproduced copies or to certify to CA that same have been 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, business interruption, goodwill, or lost data, even if CA is expressly advised of
such loss or damage.

The use of any product referenced in this documentation and this documentation is governed by the
end user's applicable license agreement.

The manufacturer of this documentation is Computer Associates International, Inc.

Provided with “Restricted Rights” as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections
52.227-19(c)(1) and (2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.

Third Edition, February 2004

 2004 Computer Associates International, Inc.

All rights reserved.

All trademarks, trade names, service marks, and logos referenced herein belong to their respective
companies.
Contents

Chapter 1. Primary Commands . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

1.1 Prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1.2 A= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
1.3 ADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
1.3.1 ADD parms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
1.4 ADDLOC= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
1.5 ADR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
1.6 AMR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
1.7 ARG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
1.8 AUDIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
1.9 AUTH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
1.10 B= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
1.11 BROWSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13
1.12 BUSGRP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14
1.13 CANCEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-15
1.14 CC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-16
1.15 CCPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-17
1.16 D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18
1.17 D= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19
1.18 DATES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21
1.19 DATE= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-22
1.20 DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-23
1.21 DOC or DOCEDIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24
1.22 DSNQ= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-25
1.23 DTFMT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-26
1.24 EDEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-27
1.25 EDIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-28
1.26 ENDSAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-29
1.27 ENQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-30
1.28 ENQN= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-31
1.29 EXCLUDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-32
1.30 FIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-33
1.31 FORCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-34
1.32 GSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-35
1.33 HIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-36
1.34 HOMELOC= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-37
1.35 I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-38
1.36 IPLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-39
1.37 ISERVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-40

Contents iii
 1.38 J= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-41
1.39 JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-42
1.40 JCLTRAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-43
1.41 JMF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-44
1.42 JOBQ= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-45
1.43 JTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-46
1.44 K= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-47
1.45 L= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-49
1.46 MACT or MANUAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-50
1.47 MISSING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-51
1.48 N= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-52
1.49 O or OUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-53
1.50 PARMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-55
1.51 PASSWORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-56
1.52 PP= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-57
1.53 PROFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-58
1.54 PURGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
1.55 RALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-60
1.56 RELEASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-61
1.57 REMLOC= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-62
1.58 RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-63
1.59 RESOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-64
1.60 RESV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-65
1.61 RETRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-66
1.62 RSRC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-67
1.63 RUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-68
1.64 S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-70
1.65 SAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-71
1.66 SARDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-72
1.67 SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-73
1.68 SCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-74
1.69 SCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-75
1.70 SHIFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-76
1.71 SORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-77
1.72 SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-78
1.73 STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-79
1.74 SYS CYCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-80
1.75 SYS HOLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-81
1.76 SYS OPTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-82
1.77 SYS USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-83
1.78 T= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-84
1.79 TEMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-85
1.80 VER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-86
1.81 VOLUME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-87
1.82 WAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-88
1.83 XNODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-89
1.84 ? or ?EDIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-90
1.85 @HOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-91
1.86 @INT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-92
1.87 @REL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-93
1.88 @RES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-94

iv Reference Summary
Chapter 2. Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Chapter 3. SCL (Schedule Control Language) . . . . . . . . . . . . . . . . 3-1

3.1 Record Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3.1.1 Event Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3.1.2 Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
3.1.3 Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3.1.4 Holiday Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
3.1.5 Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
3.1.6 Event Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
3.1.7 Execution Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
3.1.8 Referback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
3.1.9 Successor/Predecessor . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
3.1.10 Process Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
3.1.11 Conditional Operators . . . . . . . . . . . . . . . . . . . . . . . . 3-11
3.1.12 Predecessor Count . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
3.1.13 Data Set Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
3.1.14 Maximum Condition Code . . . . . . . . . . . . . . . . . . . . . . 3-12
3.1.15 Location ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
3.1.16 Version Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12

Chapter 4. Process Period Keywords . . . . . . . . . . . . . . . . . . . . . . 4-1

Chapter 5. Cyclic Process Period Keywords . . . . . . . . . . . . . . . . . 5-1

5.1 CYCDAY{>|<}nn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
5.2 CYCDAY#nnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
5.3 CYCDAYMnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4
5.4 CYCDAYXnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
5.5 CYCLAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
5.6 CYCLEnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
5.7 dayCYC#{n|L} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
5.8 dayCYCMn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
5.9 WEEK#nn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
5.10 WEEKX{>|<}nn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
5.11 WEEKXnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
5.12 XdayCYC#{n|L} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13

Chapter 6. SCL Global Control Records . . . . . . . . . . . . . . . . . . . . 6-1

6.1 +TODAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
6.2 @BUSGRP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3
6.3 @CYCnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
6.4 @CYCnnn= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5
6.5 @DATEFORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
6.6 @FCAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
6.7 @FLOWnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
6.8 @HOLnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9
6.9 @HOLnnn= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
6.10 @INITIMOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11
6.11 @RERUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12
6.12 @SCHENV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

Contents v
 6.13 @SETLOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14
6.14 @TODAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15
6.15 @TRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
6.16 @WDnnn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17
6.17 @WORKD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18
6.18 UDEFn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19

Chapter 7. Dependency Code Descriptions . . . . . . . . . . . . . . . . . . 7-1

vi Reference Summary
Chapter 1. Primary Commands

The following chapter describes the top line (command line) Unicenter®
CA-Jobtrac® Job Management (hereafter referred to as CA-Jobtrac) commands
available on various CA-Jobtrac panels.

Chapter 1. Primary Commands 1-1

1.1 Prefix

1.1 Prefix
Displays the Scheduled Event Display panel listing all events beginning with
prefix. The syntax is:

prefix


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


Used on the following panels:

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

Example
TESTJ

Displays all events whose names begin with TESTJ.

Note: All of the primary commands cannot be used as prefixes.

1-2 Reference Summary

 1.2 A=

1.2 A=
Displays the Scheduled Event Display panel listing all events with specified
abend code or catalog checks. The syntax is:

A


──A=─┬─abend─┬────────────────────────────────────────────────

├─CC────┤
├─CAT───┤
├─S─────┤
└─U─────┘

Used on the following panels:

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

Examples
A=SD37

Lists all events with abend code SD37.

A=CAT

Lists all events with catalog checks.

A=CC

Lists all events with condition code checks.

A=S

Lists all events with system abends.

A=U

Lists all events with user abends.

Chapter 1. Primary Commands 1-3

1.3 ADD

1.3 ADD
Displays the Event/Jobstream Addition panel. The syntax is:

A ADD


──┬─A───┬─────────────────────────────────────────────────────

└─ADD─┘

Used on the following panels:

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

1.3.1 ADD parms

Adds event named eventname to the current schedule and assign 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 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 (,A) (,C) (,D) or (,E) options. The event
types are as follows:
,A Indicates that the named event invokes an AS/400 CLP using the
CALL command.
,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.

1-4 Reference Summary

 1.3 ADD

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 ,A=[CLPname,arg|command|imod-arg|shellscriptname,arg]
option to specify an argument to pass to an AS/400 CLP (,A event type),
REXX IMOD (,E event type), or to specify a command to be executed at a
particular remote node (,C event type). The syntax is:

ADD parms


──ADD──┬─────────────────┬──┬─────┬──┬────────┬────────────────

└──┬─eventname─┬──┘ └─.vv─┘ └─,L=nnn─┘
├─ sclname──┤
└─ tasknm───┘

──┬──────────┬──┬─────────────┬─────────────────────────────────

└─,─┬─A─┬──┘ └─,N=nodename─┘
├─C─┤
├─D─┤
└─E─┘

──┬──────────────────────────────┬─────────────────────────────

└─,A=─┬─CLPname,arg─────────┬──┘
├─command─────────────┤
├─imod-arg────────────┤
└─shellscriptname.arg─┘

Used on the following panels:

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

Examples
ADD PRODJOB1

Adds PRODJOB1 to current schedule.

ADD PRODJOB1,L= 2

Adds PRODJOB1 to current schedule with location ID 002.

ADD PRODJOB1. 5,L= 2

Adds Version 5 of PRODJOB1 to current schedule with location ID 002.

Chapter 1. Primary Commands 1-5

1.4 ADDLOC=

1.4 ADDLOC=
Adds events (for viewing only) from location specified by nnn (any location ID
000-255) 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. The syntax is:

ADDLOC


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


Used on the following panels:

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

Example
ADDLOC= 29

Adds events (for viewing only) from the location 029 to the display.

1-6 Reference Summary

 1.5 ADR

1.5 ADR
Displays the active ADR (Automatic Dataset Recognition) table.

Used on the following panels:

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

See 1.43, “JTS” on page 1-46 for editing the ADR tables.

Chapter 1. Primary Commands 1-7

1.6 AMR

1.6 AMR
Displays the active AMR (Automatic Message Recognition) table.

Used on the following panels:

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

See 1.43, “JTS” on page 1-46 for editing the AMR tables.

1-8 Reference Summary

 1.7 ARG

1.7 ARG
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.

Used on the following panels:

■ Scheduled Event Detail
■ Event Execution Detail

Chapter 1. Primary Commands 1-9

1.8 AUDIT

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

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

See 1.35, “I” on page 1-38.

1-10 Reference Summary

 1.9 AUTH

1.9 AUTH
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 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. The syntax is:

AUTH


──AUTH──┬────────────────┬────────────────────────────────────

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

Used on the following panels:

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

Examples
AUTH

Displays the Authorization Profile panel for the user entering the command.
AUTH=TSOUSR

Displays the Authorization Profile panel for the user with ID TSOUSR.
AUTH=TSO

Displays the Authorization Profile panel for all users whose ID begins with
TSO.

Chapter 1. Primary Commands 1-11

1.10 B=

1.10 B=
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. The syntax is:

B


──B=─┬─bgname──┬──────────────────────────────────────────────

└─prefix
─┘

Used on the following panels:

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

Example
B=ACCTING

Lists events assigned business group name ACCTING.

See 1.12, “BUSGRP” on page 1-14.

1-12 Reference Summary

 1.11 BROWSE

1.11 BROWSE
Displays either the JCL or the SCL that will be used for the event. The JCL
may 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.

Used on the following panels:

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

Chapter 1. Primary Commands 1-13

1.12 BUSGRP

1.12 BUSGRP
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.

Used on the following panels:

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

See 1.10, “B=” on page 1-12.

1-14 Reference Summary

 1.13 CANCEL

1.13 CANCEL
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.

Used on all edit or display panels.

Chapter 1. Primary Commands 1-15

1.14 CC

1.14 CC
Displays the Step Condition Code Exceptions panel. The Step Condition Code
Exceptions panel is a pop-up panel which displays the condition code
parameters that have been defined for an event.

Used on the following panels:

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

1-16 Reference Summary

 1.15 CCPF

1.15 CCPF
Displays the active CCPF (Condition Code Program Filter) table.

Used on the following panels:

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

See 1.43, “JTS” on page 1-46 for editing the CCPF tables.

Chapter 1. Primary Commands 1-17

1.16 D

1.16 D
Defines or executes the default command specified by command. The default
command is executed automatically when CA-Jobtrac is accessed or whenever
D is entered. The syntax is:

D


──D──┬─────────┬──────────────────────────────────────────────

├─command─┤
└─OFF─────┘

Used on the following panels:

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

Examples
D K=LAW

Defines the command K=LAW as the default command. K=LAW is executed

automatically when CA-Jobtrac is accessed or when D is entered.
D

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 OFF

Resets the default command.

1-18 Reference Summary

 1.17 D=

1.17 D=
Displays Scheduled Event Display panel listing all events with specified
dependency or dependencies. The syntax is:

D


──D=─┬─A──┬───────────────────────────────────────────────────

├─D──┤
├─E──┤
├─H──┤
├─I──┤
├─J──┤
├─JW─┤
├─M──┤
├─O──┤
├─P──┤
├─Q──┤
├─R──┤
├─T──┤
├─X──┤
├─?──┤
└─ ──┘

Dependency code parameters are:

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

Used on the following panels:

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

Chapter 1. Primary Commands 1-19

1.17 D=

Examples
D=E

Displays all events on the current schedule with the dependency code E.
D=DXP

Displays all events on the current schedule with dependency codes D, P,

and/or X.

1-20 Reference Summary

 1.18 DATES

1.18 DATES
Depending on security authorization, edit the specified DATELIB member (the
PRODDATE member is the default), which contains Automatic Date Insertion
rules. Optionally, adds 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. The syntax is:

DATES
┌─PRODDATE─┐


──DATES──┼──────────┼─────────────────────────────────────────

├─mbrname──┤
├─JMFSYM 1─┤
└─EXCLPARM─┘

Used on the following panels:

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

Chapter 1. Primary Commands 1-21

1.19 DATE=

1.19 DATE=
Defines 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. The syntax is:

DATE


──DATE=─┬─dd────────┬─────────────────────────────────────────

├─mmdd──────┤
├─ddmm──────┤
├─mmdd-mmdd─┤
├─ddmm-ddmm─┤
└─ALL───────┘

Used on the following panels:

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

Examples
DATE= 4

Lists events with target dates on the fourth day of any month.
DATE= 411

Lists events with target date of April 11 only.

DATE= 411- 415

Lists events with target dates from April 11 through April 15.

1-22 Reference Summary

 1.20 DELETE

1.20 DELETE
Deletes the selected event awaiting submission. The selected event is deleted
from the current schedule and put on the history file 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.

Used on the following panels:

■ Scheduled Event Detail
■ Event Execution Detail

Chapter 1. Primary Commands 1-23

1.21 DOC or DOCEDIT

1.21 DOC or DOCEDIT

DOC displays documentation members for viewing.

DOCEDIT 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 1.84, “? or ?EDIT” on page 1-90. The syntax is:

DOC DOCEDIT
┌─ ─────────┐


───┬─DOC─────┬──┼───────────┼──┬─────┬────────────────────────

└─DOCEDIT─┘ ├─eventname─┤ └─nnn─┘
└─prefix
───┘

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

1-24 Reference Summary

 1.22 DSNQ=

1.22 DSNQ=
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. The
syntax is:

DSNQ


──DSNQ=─┬─dsname─┬────────────────────────────────────────────

└─prefix─┘

Used on the following panels:

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

Chapter 1. Primary Commands 1-25

1.23 DTFMT=

1.23 DTFMT=
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. The syntax is:

DTFMT


──DTFMT=─┬─A─┬────────────────────────────────────────────────

└─I─┘

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 TSO profile.

Note: DTFMT affects only the CA-Jobtrac-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.

1-26 Reference Summary

 1.24 EDEP

1.24 EDEP
Displays the Environmental Dependencies panel for a specific event which
shows the environmental dependencies for an event.

Used on the following panels:

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

Chapter 1. Primary Commands 1-27

1.25 EDIT

1.25 EDIT
Edits JCL for the selected event or SCL for the selected schedule. If authorized,
you can edit the JCL or SCL. The JCL may be either temporary-use or
production JCL. Displays the IMOD Facility of CA-GSS if the event is a REXX
IMOD.

Used on the following panels:

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

1-28 Reference Summary

 1.26 ENDSAVE

1.26 ENDSAVE
Exits from a panel and saves any changes you have made.

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

Chapter 1. Primary Commands 1-29

1.27 ENQ

1.27 ENQ
Displays the Enqueue Research panel.

Used on the following panels:

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

1-30 Reference Summary

 1.28 ENQN=

1.28 ENQN=
Displays enqueue activity for the QNAME specified by enqname. The syntax
is:

ENQN


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


Used on the following panels:

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

Chapter 1. Primary Commands 1-31

1.29 EXCLUDE

1.29 EXCLUDE
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. The syntax is:

EXCLUDE


──EXCLUDE─┬─P────────────┬────────────────────────────────────

├─PREDECESSORS─┤
├─S────────────┤
└─SUCCESSORS───┘

Used on the Missing Events panel.

1-32 Reference Summary

 1.30 FIND

1.30 FIND
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. The syntax is:

FIND
┌─—───────────────┐ ┌─NEXT──┐
┬───────────────┬┴──┼───────┼──────────────



──FIND──'string'───
└─'column-name'─┘ ├─ALL───┤
├─FIRST─┤
└─LAST──┘

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
FIND EOM EVENT-NAME ALL

Finds all the occurrences of EOM in the Event Name column on the panel.

Chapter 1. Primary Commands 1-33

1.31 FORCE

1.31 FORCE
Allows jobs to be released when CA-Jobtrac is on hold. Issuing this command
requires the use of both a line command (*) and a primary command (FORCE).

Place the '*' on the line next to the job to be forced, and then type 'FORCE' on
the command line. Press Enter. The job is allowed to run, even if CA-Jobtrac is
on hold. The job is still subject to any dependencies that it may have. It is only
released when all of its dependencies are removed.

This command does not force jobs to run when the checkpoint is locked.

The '*' line command, when specified without the 'FORCE' command, displays
a hex dump of the checkpoint record for the event. This command is typically
not useful to operators. It is intended for use at the request of Computer
Associates Technical Support.

1-34 Reference Summary

 1.32 GSO

1.32 GSO
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. The syntax is:

GSO
┌─ ───────┐


──GSO─┼─────────┼──┬─────┬────────────────────────────────────

├─memname─┤ └─nnn─┘
└─prefix
─┘

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
GSO WEEKSCD

Displays the schedule WEEKSCD from your default SCL library.

Chapter 1. Primary Commands 1-35

1.33 HIST

1.33 HIST
Displays the Event History Display panel for the selected events.
Note: Specifying * causes CA-Jobtrac to read the entire history file. The
response time for this command depends on the size of the history file.

The syntax is:

HIST


───┬─H────┬──┬─eventname─┬────────────────────────────────────

└─HIST─┘ ├─prefix
───┤
└─ ─────────┘

Used on the following panels:

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

1-36 Reference Summary

 1.34 HOMELOC=

1.34 HOMELOC=
Changes or sets your default location where nnn is the location ID. The syntax
is:

HOMELOC


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


Note: See 1.53, “PROFILE” on page 1-58 to change the default location.

Used on the following panels:

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

This command updates your CA-Jobtrac TSO profile.

Chapter 1. Primary Commands 1-37

1.35 I

1.35 I
Displays the Change Audit History panel for an event. The panel displays
information about changes made to an event.

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

1-38 Reference Summary

 1.36 IPLS

1.36 IPLS
Displays the IPL History panel.

Used on the following panels:

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

Chapter 1. Primary Commands 1-39

1.37 ISERVE

1.37 ISERVE
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.

Used on the following panels:

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

1-40 Reference Summary

 1.38 J=

1.38 J=
Displays the Scheduled Event Display panel listing all events beginning with
prefix. The syntax is:

J


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


Used on the following panels:

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

Example
J=TESTJ

Scheduled Event Display panel listing all events whose names begin with
TESTJ.

Chapter 1. Primary Commands 1-41

1.39 JCL

1.39 JCL
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.
The syntax is:

JCL
┌─ ─────────┐


──JCL─┼───────────┼──┬─────┬──────────────────────────────────

├─eventname─┤ └─nnn─┘
└─prefix
───┘

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

1-42 Reference Summary

 1.40 JCLTRAC

1.40 JCLTRAC
Accesses the CA-JCLTrac primary options panel to update options and to
generate reports.

Used on the following panels:

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

Or, Invokes the JCL ANALYZER which syntax checks the JCL member.

Used on the following panels:

■ Edit Production JCL
■ Edit Temporary JCL

See 1.58, “RESET” on page 1-63.

Chapter 1. Primary Commands 1-43

1.41 JMF

1.41 JMF
Invokes EDIT on the JMFSYM01 member of the CA-Jobtrac DD DATEFILE
library.

Used on the following panels:

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

1-44 Reference Summary

 1.42 JOBQ=

1.42 JOBQ=
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.
The syntax is:

JOBQ


──JOBQ=─┬─eventname─┬─────────────────────────────────────────

└─prefix
───┘

Used on the following panels:

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

Example
JOBQ=PRODJOB1

If PRODJOB1 is executing, this displays enqueue research for PRODJOB1.

Chapter 1. Primary Commands 1-45

1.43 JTS

1.43 JTS
Displays the Table Services Selection Menu. The menu is used 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)

Used on the following panels:

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

1-46 Reference Summary

 1.44 K=

1.44 K=
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. The syntax is:

K
┌──
─────┐
┬───┬┴──────────────────────────────────────────────────



──K=──
├─A─┤
├─C─┤
├─D─┤
├─E─┤
├─H─┤
├─L─┤
├─N─┤
├─R─┤
├─S─┤
├─T─┤
├─V─┤
└─W─┘

Parameters are:
Parm Description
A Displays events that terminated abnormally. This includes events that
abended, were purged, ended with an abnormal condition code, or
had a JCL error.
C Displays events that have completed. This includes events that
abended, were purged, had a JCL error, or are awaiting output
release.
D Displays events with a dependency code.
E Displays events that are currently executing.
H Displays events with no incomplete predecessors.
L Displays events whose scheduled start time has passed (late) or have
a late status.
N Displays NJE jobs submitted on this node.
R Displays events that are late awaiting rerun.
S Displays remotely-submitted NJE jobs.
T Displays events that are awaiting scheduled start time or date.
V Displays events with Pred Count values that do not match the
number of current predecessors listed.
W Displays events that have been submitted by CA-Jobtrac but have not
begun execution (awaiting an initiator).

Chapter 1. Primary Commands 1-47

1.44 K=

Used on the following panels:

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

Examples
K=D

Lists all events with dependency codes.

K=REC

Lists all events awaiting restart, currently executing, or completed.

1-48 Reference Summary

 1.45 L=

1.45 L=
Displays a Scheduled Event Display panel listing events with location ID
specified by the nnn parameter (any location ID 000 to 255). The syntax is:

L


──L=nnn──┬───────────────┬────────────────────────────────────

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

Used on the following panels:

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

Example
L= ,SHIFT3

Displays all events in location 000 and the times in the SYS USER panel for
SHIFT3 times.

Chapter 1. Primary Commands 1-49

1.46 MACT or MANUAL

1.46 MACT or MANUAL

Displays the Manual Action Detail (check list) panel for the selected event (if
used). Next, remove the manual action so that the event will execute.

Used on the Scheduled Event Detail panel.

1-50 Reference Summary

 1.47 MISSING

1.47 MISSING
Displays the Missing Events panel. Also see 1.29, “EXCLUDE” on page 1-32.

Used on the following panels:

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

Chapter 1. Primary Commands 1-51

1.48 N=

1.48 N=
Displays a Scheduled Event Display panel listing any event with a node
parameter, including cross-platform jobs. The syntax is:

N


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


Used on the following panels:

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

1-52 Reference Summary

 1.49 O or OUT

1.49 O or OUT
Displays sysout capture facility panels. If O or OUT is entered with no
parameter, the Sysout Capture Facility menu is displayed. The syntax is:

OUT


───┬─O───┬──┬───────────┬─────────────────────────────────────

└─OUT─┘ ├─eventname─┤
├─prefix
───┤
├─ ─────────┤
└─&─────────┘

Parameters are:
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.

To display the sysouts online, type S in the field to the left of the event whose
sysouts you want to display. Or to print the sysouts, type O in the field to the
event whose sysouts you want to print.

This Command Displays

O *,D All deleted sysout entries
O TESTJOB1,D Deleted sysout entries for TESTJOB1
O TEST,D Deleted sysout entries for any event beginning with
TEST

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. Follow the steps below 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. Type 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.

Chapter 1. Primary Commands 1-53

1.49 O or OUT

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

1-54 Reference Summary

 1.50 PARMS

1.50 PARMS
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. The syntax is:

PARMS


──PARMS──┬─────────┬──────────────────────────────────────────

└─memname─┘

Used on the following panels:

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

Chapter 1. Primary Commands 1-55

1.51 PASSWORD

1.51 PASSWORD
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 (NT), and password to be
used for the remote submission.

Used on the following panels:

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

1-56 Reference Summary

 1.52 PP=

1.52 PP=
Displays a Scheduled Event Display panel listing events scheduled for the
process period specified by procprd. The syntax is:

PP


──PP=proprd───────────────────────────────────────────────────


Used on the following panels:

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

Example
PP=TUESDAY

Lists all events scheduled for process period TUESDAY.

Chapter 1. Primary Commands 1-57

1.53 PROFILE

1.53 PROFILE
Displays the CA-Jobtrac User Profile panel. The CA-Jobtrac User Profile panel
is a pop-up panel which allows the users to customize their CA-Jobtrac ISPF
interface options, such as default location, enabling prompts, default search
command, date format, or the CA-View database name.

Used on the following panels:

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

1-58 Reference Summary

 1.54 PURGE

1.54 PURGE
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.”

Used on the following panels:

■ Scheduled Event Detail
■ Event Execution Detail

Chapter 1. Primary Commands 1-59

1.55 RALL

1.55 RALL
Displays all events on the current schedule. Also see 1.16, “D” on page 1-18.

Used on the following panels:

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

1-60 Reference Summary

 1.56 RELEASE

1.56 RELEASE
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 will issue the $AJnnnn command. If an event is
completed, CA-Jobtrac will remove output release (O) dependency. Also see the
A line command in Chapter 2, “Line Commands.”

Used on the following panels:

■ Scheduled Event Detail
■ Event Execution Detail

Chapter 1. Primary Commands 1-61

1.57 REMLOC=

1.57 REMLOC=
Removes events for viewing from the location specified by nnn (any location
ID 000-255) from the Scheduled Event Display panel. If you use the TRACX26
user exit, you cannot use REMLOC=nnn to remove events for viewing. The
syntax is:

REMLOC


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


Used on the following panels:

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

Example
REMLOC= 29

Removes events with location 029 for viewing from the panel.

1-62 Reference Summary

 1.58 RESET

1.58 RESET
Refreshes the current panel's display. The syntax is:

RESET


──┬─R─────┬───────────────────────────────────────────────────

└─RESET─┘

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

Chapter 1. Primary Commands 1-63

1.59 RESOURCE

1.59 RESOURCE
Displays the Resource Assignments panel for the selected event that is
currently using resources. This shows definitions of resource dependencies for
the selected event.

Used on the Scheduled Event Detail panel.

See 1.88, “@RES” on page 1-94.

1-64 Reference Summary

 1.60 RESV

1.60 RESV
Displays a list of any current DASD reserves in effect.

Used on the following panels:

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

Chapter 1. Primary Commands 1-65

1.61 RETRY

1.61 RETRY
Retries the posting of the completion status information of an NJE job back to
the submitting system from the execution system.

Used on the NJE Execution Detail panel.

1-66 Reference Summary

 1.62 RSRC

1.62 RSRC
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.

Used on the Scheduled Event Detail panel.

Chapter 1. Primary Commands 1-67

1.63 RUN

1.63 RUN
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 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 (,A) (,C) (,D) or (,E) options. The event
types are as follows:
,A Indicates that the named event invokes an AS/400 CLP using the
CALL command.
,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 ,A=[CLPname,arg|command|imod-arg|shellscriptname,arg]
option to specify an argument to pass to an AS/400 CLP (,A event type),
REXX IMOD (,E event type), or to specify a command to be executed at a
particular remote node (,C event type). The syntax is:

RUN


──RUN──┬─────────────────┬──┬─────┬──┬────────┬────────────────

└──┬─eventname─┬──┘ └─.vv─┘ └─,L=nnn─┘
├─ sclname──┤
└─ tasknm───┘

──┬──────────┬──┬─────────────┬─────────────────────────────────

└─,─┬─A─┬──┘ └─,N=nodename─┘
├─C─┤
├─D─┤
└─E─┘

──┬──────────────────────────────┬─────────────────────────────

└─,A=─┬─CLPname,arg─────────┬──┘
├─command─────────────┤
├─imod-arg────────────┤
└─shellscriptname.arg─┘

1-68 Reference Summary

 1.63 RUN

Used on the following panels:

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

Examples
RUN PRODJOB1

Adds PRODJOB1 to the current schedule for immediate submission.

RUN PRODJOB1,L= 2

Adds PRODJOB1 with location ID 002 to the current schedule for immediate
submission.
RUN PRODJOB1. 5,L= 2

Adds Version 5 of PRODJOB1 with location ID 002 to the current schedule for
immediate submission.

Chapter 1. Primary Commands 1-69

1.64 S

1.64 S
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. The syntax is:

S


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


Used on the following panels:

■ Scheduled Event Display
■ Scheduled Event Network

Example
S PRODJOB1

Scheduled Event Detail panel for PRODJOB1. If PRODJOB1 has already been
submitted, an Event Execution Detail panel.

1-70 Reference Summary

 1.65 SAR

1.65 SAR
Displays the CA-View (formerly SAR) 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 wish
to access. This name is saved in your CA-Jobtrac user profile. The sysout that
you selected is displayed, and you may enter any CA-View command you
wish. See the CA-View documentation for more information about CA-View
commands.

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 1-71

1.66 SARDB

1.66 SARDB
Changes the CA-View database that CA-Jobtrac 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 wish to access. The new name is
saved in your CA-Jobtrac user profile.

Used on the following panels:

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

1-72 Reference Summary

 1.67 SAVE

1.67 SAVE
Saves any changes you have made to an event from a panel.

Used on the following panels:

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

Chapter 1. Primary Commands 1-73

1.68 SCL

1.68 SCL
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.” The syntax is:

SCL
┌─ ────────┐


──SCL──┼──────────┼──┬─────┬──────────────────────────────────

├─memname──┤ └─nnn─┘
├─memname─┤
└─prefix
──┘

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
SCL WEEKSCD

Displays the schedule WEEKSCD from your default SCL library.

1-74 Reference Summary

 1.69 SCS

1.69 SCS
Displays the active System Command Scheduling table.

Used on the following panels:

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

See 1.43, “JTS” on page 1-46 for editing the SCS tables.

Chapter 1. Primary Commands 1-75

1.70 SHIFT

1.70 SHIFT
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. The syntax is:

SHIFT


──┬─SHIFT1─┬──────────────────────────────────────────────────

├─SHIFT2─┤
└─SHIFT3─┘

Used on the following panels:

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

See 1.77, “SYS USER” on page 1-83 to set up shifts 1, 2, and 3 and 1.45, “L=”
on page 1-49.

Example
SHIFT2

Lists events with target submission times during the second shift.
Note: See 1.77, “SYS USER” on page 1-83 to set up SHIFT1, 2, and 3 and 1.45,
“L=” on page 1-49.

1-76 Reference Summary

 1.71 SORT

1.71 SORT
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. The
syntax is:

SORT
┌─—───────────────┐
┬───────────────┬┴──┬───┬────────────────────────────



──SORT───
└─'column-name'─┘ ├─A─┤
└─D─┘

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
SORT CURRENT-STATUS

Sorts the display in ascending order by the contents of the Status column.

Chapter 1. Primary Commands 1-77

1.72 SPACE

1.72 SPACE
Displays an analysis of DASD (Direct Access Storage Device) space.

Used on the following panels:

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

1-78 Reference Summary

 1.73 STATUS

1.73 STATUS
Displays an analysis of component resource use on checkpoint data set, job
history file, and sysout capture file. Also displays version and genlevel, token,
and restage options.

Used on the following panels:

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

Chapter 1. Primary Commands 1-79

1.74 SYS CYCS

1.74 SYS CYCS

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.

Used on the following panels:

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

1-80 Reference Summary

 1.75 SYS HOLS

1.75 SYS HOLS

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.

Used on the following panels:

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

Chapter 1. Primary Commands 1-81

1.76 SYS OPTS

1.76 SYS OPTS

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.

Used on the following panels:

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

1-82 Reference Summary

 1.77 SYS USER

1.77 SYS USER

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 1.70, “SHIFT” on page 1-76.

Used on the following panels:

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

Chapter 1. Primary Commands 1-83

1.78 T=

1.78 T=
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. The syntax is:

T


──T=hh─┬─────────┬────────────────────────────────────────────

└─mm-hhmm─┘

Used on the following panels:

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

Examples
T=12

Lists events with target times from 12:00 PM to 12:59 PM.

T= 123- 411

Lists events with target times from 1:23 AM to 4:11 AM.

1-84 Reference Summary

 1.79 TEMP

1.79 TEMP
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 1.78, “T=” on
page 1-84.

Used on the Scheduled Event Detail panel.

Chapter 1. Primary Commands 1-85

1.80 VER

1.80 VER
Displays the version number of your CA-Jobtrac.

Used on the following panels:

■ CA-Jobtrac primary
■ Scheduled Event Detail

1-86 Reference Summary

 1.81 VOLUME

1.81 VOLUME
Executes CA-JCLTrac to create a Volume Pull List panel from a realtime 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.

Used on the Scheduled Event Detail panel.

Chapter 1. Primary Commands 1-87

1.82 WAIT

1.82 WAIT
Displays enqueue conflicts.

Used on the following panels:

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

1-88 Reference Summary

 1.83 XNODE

1.83 XNODE
Displays the Cross Node Query-Criteria Selection panel.

Used on the following panels:

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

Chapter 1. Primary Commands 1-89

1.84 ? or ?EDIT

1.84 ? or ?EDIT
? displays documentation members for viewing.

?EDIT 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 1.21, “DOC or DOCEDIT” on page 1-24. The syntax is:

? ?EDIT


──┬─?─────┬──┬─────────────────┬──┬─────┬─────────────────────

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

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

1-90 Reference Summary

 1.85 @HOLD

1.85 @HOLD
Puts CA-Jobtrac on hold. Places message SCHEDULE ON HOLD in
upper-right corner of the panel. Issues the TRAC111I user HAS PLACED
SCHEDULE ON HOLD console message.

Used on the following panels:

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

Chapter 1. Primary Commands 1-91

1.86 @INT

1.86 @INT
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 wish to set an interval time that differs
from the default time. This command is valid only after you enter the RALL
command. The syntax is:

@INT


──@INT──┬───────────┬─────────────────────────────────────────

│ ┌─5──┐ │
└─=─┴─nn─┴──┘

Used on the following panels:

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

1-92 Reference Summary

 1.87 @REL

1.87 @REL
Releases CA-Jobtrac if it were put on hold. Issues the TRAC111I user HAS
PLACED SCHEDULE ON HOLD console message.

Used on the following panels:

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

Chapter 1. Primary Commands 1-93

1.88 @RES

1.88 @RES
Displays the Global Resource Definitions panel. Also see 1.59, “RESOURCE”
on page 1-64.

Used on the following panels:

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

1-94 Reference Summary

Chapter 2. Line Commands

The following sections describe the line commands available on the Scheduled
Event Display and Scheduled Event Network panels. Line commands can be
disabled in CA-Jobtrac with the startup option DISABLE. See the Getting
Started.

Line Description
Command
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 wish to access. This name is saved
in your CA-Jobtrac user profile. The sysout that you selected
is displayed and you may enter any CA-View command you
wish. See the CA-View documentation for more information
about CA-View commands.
| 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 may 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.

Chapter 2. Line Commands 2-1

 Line Description
Command
D Delete event. Deletes the event awaiting submission. The
selected event is deleted from the current schedule and put on
the history file 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.
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 may 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 file.
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.

2-2 Reference Summary

Line Description
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.
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-Command (incorporating CA-Sysview) Job
Summary panel. Purges the selected event from the current
schedule. 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 rerun/restart facility. They cannot use an
automated restart system.
Not equivalent to a primary command.

Chapter 2. Line Commands 2-3

 Line Description
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.
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 realtime 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.

2-4 Reference Summary

Line Description
Command
? Documentation. Displays the selected event's documentation
member.
Equivalent to the DOC, DOCEDIT, and ?EDIT primary
commands.
@ 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.

Chapter 2. Line Commands 2-5

Chapter 3. SCL (Schedule Control Language)

The following topics explain SCL member's record formats and fields.

Chapter 3. SCL (Schedule Control Language) 3-1

3.1 Record Format

3.1 Record Format

The following figure depicts the record format of an SCL member. The
following sections briefly describe the columns of the record. For detailed
information about SCL, see the CA-Jobtrac Schedule Creation Guide.

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

EVENTNM TIME DATE DEPS RELEASE1RELEASE2RELEASE3RELEASE4 PROCESSP OPDCCDELOCVV

3.1.1 Event Name

The following table describes the Event Name field:

SCL Heading Columns Description

EVENTNM 1-8 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.

3-2 Reference Summary

 3.1 Record Format

3.1.2 Threshold
The following table describes the Threshold SCL field:

SCL Heading Column Description

blank 9 Specifies the action to occur at the time
shown in the Time (TIME) field. Possible
entries:
blank Both start and target time
T Target time only
S Start time only
A Abort time

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

3.1 Record Format

3.1.3 Time
The following table describes the Time SCL field:

SCL Heading Columns Description

TIME 10 - 13 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. See the
creating schedules chapters for
detailed information.
ASAP As soon as all other dependencies
are met.

3-4 Reference Summary

 3.1 Record Format

3.1.4 Holiday Action

The following table describes the Holiday Action SCL field:

SCL Heading Column Description

blank 14 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 The event is not scheduled at all
| (unless the target date is not the
| current date).
S The event is scheduled for the
target date, even though it is a
holiday.
H 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 The event is scheduled for the
next calendar day after the
holiday, even if the next day is not
a regular workday.
W The event is scheduled for the
next workday following the
holiday.
O The event is scheduled only on
holidays. If the target date is not a
holiday, the event is not scheduled
at all.
P The event is scheduled for the
workday previous to the holiday.

Chapter 3. SCL (Schedule Control Language) 3-5

3.1 Record Format

3.1.5 Date
The following table describes the Date SCL field:

SCL Heading Columns Description

DATE 15 - 18 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.

3-6 Reference Summary

 3.1 Record Format

3.1.6 Event Type

The following table describes the Event Type SCL field:

SCL Heading Column Description

blank 19 Identifies the type of event you are
scheduling. Possible entries:
A Indicates the event invokes an
AS/400 CLP using the CALL
command.
C Indicates the event defines a
command to be executed at a
particular remote node.
E Indicates the event is a REXX
IMOD. See the CA-Jobtrac Extended
Scheduling Services Guide for
information about the use of
REXX IMODs in CA-Jobtrac.
D Indicates the event is a dummy
job.
U Indicates the event invokes a
UNIX Korn shell script using the
UNIX ksh command.
blank Indicates the event is any other
type of event.

The event type entries (A, C, and U) are significant only when a GSS node
name is also specified using the new NODE= entry for the Referback field
(column 25). The platform type associated with the node specified by the
NODE= entry must match the platform type associated with the event type. If
the platform types do not match, you receive an error message upon execution,
and an abend code is posted to the event. For example, an event type of A and
a node name that specifies a UNIX machine will cause an error at execution
time.

Chapter 3. SCL (Schedule Control Language) 3-7

3.1 Record Format

3.1.7 Execution Dependency

The following table describes the Execution Dependency SCL field:

SCL Heading Columns Description

DEPS 20 - 24 Specifies execution dependencies to be
assigned. Possible entries:
M Manual release dependency
P Predecessor event dependency
J JCL required dependency
D Data set required dependency
O Output release
A Abend bypass
E Edit JCL dependency
? View documentation dependency
Q Queued release dependency

3.1.8 Referback
The following table describes the Referback SCL field:

SCL Heading Column Description

blank 25 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.

3-8 Reference Summary

 3.1 Record Format

SCL Heading Column Description

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 may
be two characters long and must be
defined in the RESOURCE PPOPTION
member.
& Allows the argument for the IP= and
ED= referback field entries to continue to
a length of 255 characters.
IP= This entry specifies an argument to pass
to the event named in the Event Name
(EVENTNM) field.
E Indicates that events listed in the
Successor/Predecessor (RELEASEn)
fields of the same record are
environmental dependencies.
ED= Indicates that the event listed in the
Successor/Predecessor (RELEASEn)
fields is an environmental dependency.
Unlike the E entry, ED defines only one
environmental dependency, but it also
gives the ability to specify a retry count,
retry interval, and an argument to pass
to the environmental dependency.
NODE=
Indicates the GSS node name (up to 16
characters) of the executing node for the
named event.
+ Indicates that events listed in the
Successor/Predecessor (RELEASEn)
fields of the same record are successors.

Chapter 3. SCL (Schedule Control Language) 3-9

3.1 Record Format

SCL Heading Column Description

- Indicates that events listed in the
Successor/Predecessor (RELEASEn)
fields of the same record are
predecessors.
= Defines conditional predecessor
relationship between primary event and
predecessor, if the predecessor is on the
schedule. If the predecessor is not on the
schedule, there is no relationship.
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.
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 may 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.

3.1.9 Successor/Predecessor
The following table describes the Successor/Predecessor SCL field:

SCL Heading Columns Description

RELEASEn 26 - 57 Defines the successors, predecessors, alternate
member name, and environmental
dependencies (see 3.1.8, “Referback” on
page 3-8) for the event.

3-10 Reference Summary

 3.1 Record Format

3.1.10 Process Period

The following table describes the Process Period SCL field:

SCL Heading Columns Description

PROCESSP 59 - 68 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).

3.1.11 Conditional Operators

The following table describes the Conditional Operators SCL field:

SCL Heading Column Description

O 69 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

3.1.12 Predecessor Count

The PRED COUNT field should not be used or needed by CA-Jobtrac. This
field was used to support schedules developed using a prior CA-Jobtrac
version.

3.1.13 Data Set Count

The following table describes the Data Set Count SCL field:

Chapter 3. SCL (Schedule Control Language) 3-11

3.1 Record Format

SCL Heading Column Description

D 71 Defines the number of data sets that must be
created to trigger the event. The entry must
be a single numeral (0-9).

3.1.14 Maximum Condition Code

The following table describes the Maximum Condition Code SCL field:

SCL Heading Columns Description

CCDE 72 - 75 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.

3.1.15 Location ID
The following table describes the Location ID SCL field:

SCL Heading Columns Description

LOC 76 - 78 Defines a location ID to be assigned to the
event. The entry must be a three-digit
number (000-254).

3.1.16 Version Number

The following table describes the Version Number SCL field:

SCL Heading Columns Description

VV 79 - 80 Defines a specific version number to be
assigned to the event. The entry must be a
two-digit number (01-99). Default is 01.

3-12 Reference Summary

Chapter 4. Process Period Keywords

This table discusses the process period keywords.

Table 4-1 (Page 1 of 7). Process Period Keywords

Keyword Description
+!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 / 4
(American) Eligible on February 20, 2004, 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).

Chapter 4. Process Period Keywords 4-1

Table 4-1 (Page 2 of 7). Process Period Keywords

Keyword Description
=MTWTFSS Eligible for scheduling any day specified by the positional characters
M(onday), T(uesday), W(ednesday), T(hursday), F(riday), S(aturday), and
S(unday). Any day on which the event should not be scheduled must be
replaced by a . (period).
Examples
=M.W.F..
Eligible any Monday, Wednesday, or Friday.
=....F..
Eligible on Fridays only.
DAILY Eligible for scheduling any day.
day#{nn|LAST} Eligible on the nnth occurrence of the specified day during any month.
Replace nn with a number 01 through 05 (leading zeros may 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.

4-2 Reference Summary

Table 4-1 (Page 3 of 7). Process Period Keywords

Keyword Description
EVnday(x) Eligible every nth weekday (day) of the year, starting with the xth
occurrence of the weekday. Replace n with a numeral 1-9. Replace day
with a day of the week: MON, TUE, WED, THU, FRI. Replace x with a
numeral 1-9.
Examples
EV3FRI(1)
Eligible every third Friday starting with the first Friday of the year.
EV5MON(5)
Eligible every fifth Monday starting with the fifth Monday of the year.
Note: You must adjust this process period every year.
FOM Eligible the first workday of any month.
FRIDAY Eligible on Fridays only.
LASTDAY Eligible the last physical day of the month (including Saturdays and
Sundays).
MONDAY Eligible on Mondays only.
QTRn Eligible the first WORKDAY of the quarter specified by n. Replace n with
a number 1-4, where:
QTR1 is the quarter beginning the first WORKDAY in January
QTR2 is the quarter beginning the first WORKDAY in April
QTR3 is the quarter beginning the first WORKDAY in July
QTR4 is the quarter beginning the first WORKDAY in October
QTRnA Eligible any day during the quarter specified by n. Replace n with a
number 1-4, where:
QTR1A is the quarter beginning January 1.
QTR2A is the quarter beginning April 1.
QTR3A is the quarter beginning July 1.
QTR4A is the quarter beginning October 1.
SATURDAY Eligible on Saturdays only.
SUNDAY Eligible on Sundays only.
THURSDAY Eligible on Thursdays only.
TUESDAY Eligible on Tuesdays only.

Chapter 4. Process Period Keywords 4-3

Table 4-1 (Page 4 of 7). Process Period Keywords

Keyword Description
UDEFx Eligible on dates specified by the matching UDEFx parameter in the same
SCL member (where the character x in the process period keyword
matches the x in the parameter).
WEDNESDAY Eligible on Wednesdays only.
WEEKDAY#L Eligible the last workday of the week that is not a holiday. This process
period considers a workweek to be Monday through Friday. See the
WEEKDAY#LW process period for workweeks that include Saturday or
Sunday.
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. See the
WEEKDAY#L process period for workweeks that do not include Saturday
or Sunday.
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.

4-4 Reference Summary

Table 4-1 (Page 5 of 7). Process Period Keywords

Keyword Description
WEEKDAYXn Eligible all workdays of the week except the numeric day of the week
specified by n (1-7). During a week with no holidays, weekday 1 is
Monday, 2 is Tuesday, 3 is Wednesday, 4 is Thursday, 5 is Friday, 6 is
Saturday, 7 is Sunday. During a week with a holiday, weekday 1 is the
first day that is not a holiday, 2 is the second day that is not a holiday,
and so on.
Example
WEEKDAYX4
Eligible any day except weekday number 4. If no holidays occur during
the week, weekday 4 is Thursday and the event is eligible Monday,
Tuesday, Wednesday, and Friday. If, however, Tuesday were a holiday,
weekday number 4 would be Friday and the event would be eligible
Monday, Wednesday, and Thursday.
Note: If SAT and SUN are holidays (specified in SYS CYCS), SAT is
weekday 6, and SUN is weekday 7.
WEEKYR{>|<}nn Eligible any day of any week of the year after (>) or before (<) the week
specified by nn (01-54). You may 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 may 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 may omit leading zeros.
Example
WEEKYRX 2
Eligible any day of the year except during the 2nd week of the year
starting on JAN 1.

Chapter 4. Process Period Keywords 4-5

Table 4-1 (Page 6 of 7). Process Period Keywords

Keyword Description
WORKDAY{>|<}nn Eligible on any workday of the month after (>) or before (<) the workday
specified by nn (where nn is a two-digit number 01-31).
Example
WORKDAY>15
Eligible any workday after the 15th workday of the month.
WORKDAY#nn Eligible on the nnth workday of any month (where nn is a two-digit
number 01-31).
Examples
WORKDAY#2
Eligible on the 20th workday of any month (not the 20th day of the
month, since Saturdays, Sundays, and holidays are not workdays).
WORKDAY# 3
Eligible on the third workday of any month.
WORKDAYMnn Eligible on the nnth workday of the month, calculated from the end of the
month (where nn is a two-digit number 01-31).
Example
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.

4-6 Reference Summary

Table 4-1 (Page 7 of 7). Process Period Keywords

Keyword Description
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 may 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 4-7

Chapter 5. Cyclic Process Period Keywords

This chapter discusses the cyclic process period keywords. See the chapter
"Preparing to Create a Schedule" in the CA-Jobtrac Schedule Creation Guide for
more information on how to set up dates.

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 5-1

5.1 CYCDAY{>|<}nn

5.1 CYCDAY{>|<}nn
Eligible any workday of the cycle after (>) or before (<) the workday specified
by nn where nn is 01 to 99. You may omit leading zeros.

5-2 Reference Summary

 5.2 CYCDAY#nnn

5.2 CYCDAY#nnn
Eligible on the nnnth workday of any processing cycle (where nnn is a
three-digit number 001-254).

Examples
CYCDAY# 1

Eligible on the 10th day of processing cycles.

CYCDAY#15

Eligible on the 150th day of processing cycles.

Chapter 5. Cyclic Process Period Keywords 5-3

5.3 CYCDAYMnnn

5.3 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
CYCDAYM 15

Eligible on the 15th-to-last workday of processing cycles.

CYCDAYM 2

Eligible on the second-to-last workday of processing cycles.

5-4 Reference Summary

 5.4 CYCDAYXnn

5.4 CYCDAYXnn
Eligible on any workday except the nnth workday of any processing cycle
(where nn is a two-digit number 01-99). You may omit leading zeros.

Examples
CYCDAYX 1

Eligible any workday except the first workday of processing cycles.

CYCDAYX99

Eligible any workday except the 99th workday of processing cycles.

Chapter 5. Cyclic Process Period Keywords 5-5

5.5 CYCLAST

5.5 CYCLAST
Eligible on the last day of any cycle.

5-6 Reference Summary

 5.6 CYCLEnn

5.6 CYCLEnn
Eligible in the nnth cycle period. If nn has a leading zero, it may be omitted.
CYCLE01 through CYCLE14 or CYCLE1 through CYCLE14.

Example
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

Suppose you have the preceding cycle periods (cycles 5 to 12 are not shown).

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 5-7

5.7 dayCYC#{n|L}

5.7 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
MONCYC#3

Eligible on the third Monday of any processing cycle.

FRICYC#L

Eligible on the last Friday of any processing cycle.

5-8 Reference Summary

 5.8 dayCYCMn

5.8 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
TUECYCM3

Eligible on the third-to-last Tuesday of any processing cycle.

THUCYCM2

Eligible on the second-to-last Thursday of any processing cycle.

Chapter 5. Cyclic Process Period Keywords 5-9

5.9 WEEK#nn

5.9 WEEK#nn
Eligible any day during the week of a cycle specified by nn (01-37). You may
omit leading zeros.

Example
WEEK# 3 or WEEK#3

Eligible any day during the 3rd week of the current cycle.

5-10 Reference Summary

 5.10 WEEKX{>|<}nn

5.10 WEEKX{>|<}nn
Eligible any day of any week of a cycle following (>) or preceding (<) the
week specified by nn (01-37). You may omit leading zeros.

Example
WEEK>35

Eligible any day of the last two weeks of the cycle.

Chapter 5. Cyclic Process Period Keywords 5-11

5.11 WEEKXnn

5.11 WEEKXnn
Eligible any day except during the week of a cycle specified by nn (01-37). You
may omit leading zeros.

Example
WEEKX 2 or WEEKX2

Eligible any day of the year except during the 2nd week of the current cycle.

5-12 Reference Summary

 5.12 XdayCYC#{n|L}

5.12 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
XMONCYC#4

Eligible any Monday except the fourth Monday of any processing cycle.
XWEDCYC#1

Eligible any Wednesday except the first Wednesday of any processing cycle.

Chapter 5. Cyclic Process Period Keywords 5-13

Chapter 6. SCL Global Control Records

This chapter discusses SCL global control records.

Chapter 6. SCL Global Control Records 6-1

6.1 +TODAY

6.1 +TODAY
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 wish 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. The syntax
is:

+TODAY


──+TODAY=─┬─yyddd─┬───────────────────────────────────────────

└─ ─────┘

6-2 Reference Summary

 6.2 @BUSGRP

6.2 @BUSGRP
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. See
1.12, “BUSGRP” on page 1-14. The syntax is:

@BUSGRP


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


Chapter 6. SCL Global Control Records 6-3

6.3 @CYCnnn

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

6-4 Reference Summary

 6.4 @CYCnnn=

6.4 @CYCnnn=
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. The
syntax is:

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



──@CYCnnn=──

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

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

Chapter 6. SCL Global Control Records 6-5

6.5 @DATEFORM

6.5 @DATEFORM
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). The syntax is:

@DATEFORM
┌─A─┐


──@DATEFORM=─┴─I─┴────────────────────────────────────────────


6-6 Reference Summary

 6.6 @FCAST

6.6 @FCAST
Creates a forecast report and forecast schedule using the forecast data set for
the specified date (Julian date, where yy is the year and ddd is the numerical
day of the year). The syntax is:

@FCAST


──@FCAST=yyddd────────────────────────────────────────────────


Chapter 6. SCL Global Control Records 6-7

6.7 @FLOWnn

6.7 @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. The syntax is:

Syntax

@FLOWnn
┌─,──────────┐
┬──────────┬┴─────────────────────────────────────



──@FLOWnn=──
└─flowname─┘

6-8 Reference Summary

 6.8 @HOLnnn

6.8 @HOLnnn
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 6-9

6.9 @HOLnnn=

6.9 @HOLnnn=
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. The syntax is:

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

6-10 Reference Summary

 6.10 @INITIMOD

6.10 @INITIMOD
Specifies that subsequent events should (=YES) or should not (=NO) use the
global initiation IMOD. See DYNAMLOC in the Getting Started to use this
feature. The syntax is:

@INITIMOD


──@INITIMOD=─┬─YES─┬──────────────────────────────────────────

└─NO──┘

Chapter 6. SCL Global Control Records 6-11

6.11 @RERUN

6.11 @RERUN
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. The
syntax is:

@RERUN


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


6-12 Reference Summary

 6.12 @SCHENV

6.12 @SCHENV
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 may 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. See Workload Manager in the
Getting Started before using this feature.

Chapter 6. SCL Global Control Records 6-13

6.13 @SETLOC

6.13 @SETLOC
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. The syntax is:

@SETLOC


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


6-14 Reference Summary

 6.14 @TODAY

6.14 @TODAY
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. The syntax
is:

@TODAY


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


Chapter 6. SCL Global Control Records 6-15

6.15 @TRACE

6.15 @TRACE
Displays hexadecimal representation of schedule records from the checkpoint.
This record is used for diagnostic purposes only.

6-16 Reference Summary

 6.16 @WDnnn

6.16 @WDnnn
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. The syntax is:

@WDnnn


──@WDnnn=─┬─SAT────┬──────────────────────────────────────────

├─SUN────┤
├─SATSUN─┤
└─MTWTF──┘

Chapter 6. SCL Global Control Records 6-17

6.17 @WORKD

6.17 @WORKD
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). The syntax is:

@WORKD


──@WORKD=─┬─SAT────┬──────────────────────────────────────────

├─SUN────┤
├─SATSUN─┤
└─MTWTF──┘

6-18 Reference Summary

 6.18 UDEFn

6.18 UDEFn
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. The
syntax is:

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



──UDEFn=──

Chapter 6. SCL Global Control Records 6-19

Chapter 7. Dependency Code Descriptions

Dependency Descriptions
Code
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
may 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.

Chapter 7. Dependency Code Descriptions 7-1

 Dependency Descriptions
Code
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.
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. Once JCL is submitted, the
event is held in the JES queue and released automatically by
CA-Jobtrac 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 and the event is eligible for submission.
*AUTO AUTO-SCHD event. The event was submitted outside the
control of CA-Jobtrac and therefore has no dependencies or
overrides that can be honored by CA-Jobtrac.
? View documentation dependency. Prevents submission of
the event until its documentation is viewed. The code must be
removed manually after the documentation is viewed.

7-2 Reference Summary