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